improve-codebase-architecture — 架构改进
- 触发方式:
/improve-codebase-architecture或关键词「改进架构」「架构重构」「tightly coupled」 - 适用场景: 发现架构问题、模块耦合严重、代码库难以测试
- 不适用场景: 微小的单文件重构、功能开发
功能概述
improve-codebase-architecture 分析代码库的架构质量，基于领域语言（CONTEXT.md）和架构决策（ADRs）寻找改进机会。它识别紧密耦合的模块、循环依赖和可测试性问题。
触发条件
以下情况会自动触发 improve-codebase-architecture：
- 提到「架构改进」「模块耦合」
- 觉得代码难以测试和维护
- 使用
/improve-codebase-architecture命令
使用示例
示例 1：架构梳理
/improve-codebase-architecture 分析当前项目，找出最需要重构的 3 个模块示例 2：解耦分析
/improve-codebase-architecture src/services/ 下的服务耦合严重，帮我分析依赖关系和改进方案示例 3：可测试性
/improve-codebase-architecture 这个项目单元测试覆盖率低，分析架构层面的阻碍因素分析维度
| 维度 | 关注点 |
|---|---|
| 模块边界 | 是否符合领域语言的分层 |
| 依赖方向 | 是否有循环依赖或反向依赖 |
| 耦合度 | 模块间的耦合方式（数据/控制/时间） |
| 可测试性 | 依赖注入、Mock 友好度 |
注意事项
- 架构改进通常是长期过程，不要试图一次性整改
- 优先处理高变更频率 + 高耦合的模块（修改最多、影响最大）
- 每次重构保持小步提交，确保每次都有绿色测试
- 不改变外部行为 — 这是重构，不是重写
相关 Skills
- grill-with-docs — 对照领域文档验证架构变更
- simplify — 做完架构调整后进行代码级简化
- review — 架构变更后的代码审查