用途:以 AI 方式探索代码库,识别架构摩擦点,发现可测试性改进机会,并针对“模块加深”提出重构方案,最终以 GitHub issue RFC 形式提交。
主要能力与流程:
- 探索代码库:使用 Agent 工具(subagent_type=Explore)自然浏览代码,不依赖僵化启发式,记录摩擦信号,例如理解一个概念需在多个小文件间跳转、模块过浅导致接口复杂度接近实现、为可测试性而抽出的纯函数但真正 bug 藏在调用处、紧耦合模块在接缝处产生集成风险、未测试或难以测试的部分。
- 呈现候选项:以编号列表给出加深机会,每项包含涉及的模块/概念、耦合原因、依赖类别(见 REFERENCE.md 的四类)、测试影响,此时不提出接口,先询问用户想探索哪个。
- 用户选定候选项。
- 框定问题空间:在派生子代理前,为用户写出所选候选的问题空间说明,包括新接口需满足的约束、可依赖的依赖项、粗略示意代码草图(非提案,仅使约束具体化)。
- 设计多个接口:并行派生 3 个以上子代理,每个产出截然不同的接口方案,并分配不同设计约束:最小化接口(1-3 个入口)、最大化灵活性、优化最常见调用者、围绕 ports & adapters 模式(如适用)。每个子代理输出接口签名、用法示例、内部隐藏的复杂度、依赖策略与权衡。随后依次呈现并对比,给出自己的推荐及理由,可提出混合方案。
- 用户选定接口或接受推荐。
- 创建 GitHub issue:使用 gh issue create 按 REFERENCE.md 模板创建重构 RFC,无需先让用户审阅,直接创建并分享 URL。
理论依据:深模块(John Ousterhout《A Philosophy of Software Design》)具有小接口隐藏大实现,更可测试、更利于 AI 导航,可在边界而非内部测试。
限制:资料未提供该技能的收费、价格、平台支持范围、具体命令之外的安装方式等细节;使用依赖 Agent 工具与 gh 命令,需具备相应环境。