improve-codebase-architecture
Installation
SKILL.md
改进代码库架构
把架构摩擦暴露出来,提出深化机会——把浅模块变成深模块的重构。目标是可测试性和 AI 可导航性。
本命令_参考_项目的领域模型,并建立在共享的设计词汇之上:
- 跑
/codebase-designskill 获取架构词汇(模块(module)、接口(interface)、深度(depth)、接缝(seam)、适配器(adapter)、杠杆(leverage)、局部性(locality))及其原则(删除测试、"接口即测试面"、"一个适配器 = 假想接缝,两个 = 真接缝")。每条建议都精确使用这些术语——不要漂移到"组件""服务""API"或"边界"。 CONTEXT.md里的领域语言为好接缝命名;docs/adr/里的 ADR 记录了本命令不应重新争议的决策。
流程
1. 探索
先定范围再扫描——YAGNI。 深化模块的收益是让它未来的改动更容易,所以多关注近期变动过的代码。看之前先确定看哪里:
- 用户指了方向——某个模块、某个子系统、某个痛点——直接用,跳过下面的推断。
- 否则,回溯一段足够长的 commit 历史(
git log --oneline)找热区——反复出现的文件和区域——让那些路径先牵引你的注意力。如果改动分散、没有明显热区,扩大范围。
先读项目的领域词汇表(CONTEXT.md)和你要触碰区域的任何 ADR。