code-arch-optimizer
Installation
SKILL.md
代码库架构深度重构
像 AI 一样探索代码库,发现架构摩擦点,挖掘可测试性改进机会,并以 GitHub Issue RFC 的形式提出模块深化重构方案。
深模块(John Ousterhout 著《软件设计哲学》)指接口简洁但隐藏了大量实现细节的模块。深模块更易测试、更便于 AI 导航,并且可以在边界处测试,而无需深入内部。
流程
1. 探索代码库
使用 Agent 工具(subagent_type=Explore)自然地浏览代码库。不要机械地套用规则——以有机的方式探索,留意你遇到摩擦的地方:
- 哪里理解一个概念需要在许多小文件之间来回跳转?
- 哪些模块过于浅薄,接口几乎和实现一样复杂?
- 哪些纯函数只是为了可测试性而被提取出来,但真正的 bug 却藏在调用方式中?
- 哪些紧耦合的模块在它们之间的接缝处产生了集成风险?
- 代码库中哪些部分缺少测试,或者难以测试?
你遇到的摩擦本身就是信号。