improve-codebase-architecture

Installation
SKILL.md

改进代码库架构

揭示架构摩擦点并提出深化机会——将浅层 module 转变为深层 module 的重构。目标是可测试性和 AI 可导航性。

本命令参考项目的领域模型,并基于共享的设计词汇:

  • 调用 Skill 工具并传入 "codebase-design" 获取架构词汇(moduleinterfacedepthseamadapterleveragelocality)及其原则(deletion test、"interface 就是 test surface"、"一个 adapter = 假设性 seam,两个 = 真实的")。在每个建议中严格使用这些术语——不要偏离到 "component"、"service"、"API" 或 "boundary"。
  • CONTEXT.md 中的领域语言为好的 seam 提供了命名;docs/adr/ 中的 ADR 记录了本命令不应重新讨论的决策。

流程

1. 探索

先确定范围再扫描——YAGNI。 加深一个模块的回报在于使未来对该模块的修改更容易,因此对最近变更的代码区域给予额外权重。在查看之前先决定看哪里

  • 如果用户指定了方向——一个模块、一个子系统、一个痛点——就采用它,并跳过下面的推断步骤。
  • 否则,回顾一段较长的提交历史(git log --oneline)来找到代码库的热点——那些反复出现的文件和区域——让这些路径首先吸引你的注意力。如果变更分散,没有明确的热点,就扩大范围。

首先阅读项目的领域术语表(CONTEXT.md)以及你将要接触的区域内任何 ADR。

Installs
30
GitHub Stars
328
First Seen
Jul 1, 2026
improve-codebase-architecture — devcxl/mattpocock-skills-zh