improve-codebase-architecture
Installation
SKILL.md
架构审查
找出架构上的问题点,提出加深模块的机会:把浅模块重构为深模块。目标是提高可测性,并让 AI 更容易理解和定位代码。
本命令以项目的领域模型为依据,并使用一套共享的设计术语:
- 使用
codebase-designskill 获取架构术语(模块、接口、深度、接缝、适配器、杠杆、局部性)及其原则(删除测试、“接口就是测试面”、“有两个适配器时接缝才真实存在”)。描述模块设计时一致地使用这些术语;组件、服务、API、边界等词只在符合其原义时使用,不用来替代这些术语。 CONTEXT.md中的领域语言用于为接缝命名;docs/adr/中的 ADR 记录了本命令不应重新争论的决定。
过程
1. 探索
先确定范围,再扫描(YAGNI)。 加深模块的回报在于以后修改它更容易,所以优先关注代码库中最近经常变化的部分。开始查看之前,先决定看哪里:
- 用户指定了方向(某个模块、子系统或痛点)时,按用户的方向进行,跳过下面的推断。
- 否则,查看较长一段提交历史(
git log --oneline),找出代码库的热点:反复被修改的文件和区域,优先关注这些路径。改动分散、没有明显热点时,扩大范围。
先阅读项目的术语表(CONTEXT.md)和涉及区域的 ADR。