用途
该技能用于探索代码库、发现架构改进机会,并聚焦于通过“深化浅模块”让代码库更易于测试。它最终会以 GitHub issue 的形式提出模块深化的重构 RFC。
其核心理念来自 John Ousterhout 的《A Philosophy of Software Design》:深模块(deep module)用较小的接口隐藏较大的实现。深模块更易于测试、更便于 AI 导航,并能让你在边界处而不是内部进行测试。
主要能力
- 像 AI 一样自然探索代码库,不依赖僵化的启发式规则,而是记录实际遇到的“摩擦”。
- 识别架构摩擦信号,例如:理解一个概念需要在多个小文件间来回跳转;模块过于浅,接口几乎与实现一样复杂;为可测试性抽出的纯函数,真实 bug 却隐藏在调用方式中;紧密耦合的模块在接缝处产生集成风险;代码库中未测试或难以测试的部分。
- 列出带编号的深化机会候选清单,并说明涉及的模块/概念、耦合原因(共享类型、调用模式、概念共同归属)、依赖分类、以及对现有测试的影响(哪些现有测试会被边界测试取代)。
- 在用户选定候选后,先撰写面向用户的问题空间说明,包括新接口需满足的约束、需依赖的依赖项、以及粗略的示意性代码草图(仅用于让约束具体化,并非提案)。
- 并行启动 3 个以上子智能体,各自基于独立的技术简报和不同的设计约束,为深化后的模块产出差异化的接口方案。设计约束包括:最小化接口(最多 1-3 个入口点)、最大化灵活性(支持多种用例和扩展)、针对最常见调用方优化(让默认情况变得简单)、以及(如适用)围绕端口与适配器模式设计跨边界依赖。
- 每个子智能体输出:接口签名(类型、方法、参数)、调用方使用示例、内部隐藏的复杂度、依赖策略、权衡。
- 顺序展示各设计方案,用文字进行比较,并给出有主见的推荐,若不同设计的元素能很好结合则提出混合方案。
- 最终通过 gh issue create 创建重构 RFC 的 GitHub issue,并分享 URL。
使用方式
该技能按以下流程执行:
- 探索代码库:使用 Agent 工具、subagent_type=Explore 来导航代码库,自然探索并记录摩擦点。
- 呈现候选:列出带编号的深化机会,展示集群、耦合原因、依赖分类和测试影响。此时不提出接口,而是询问用户“你想探索其中哪一个?”
- 用户挑选一个候选。
- 框定问题空间:在启动子智能体前,为所选候选撰写面向用户的问题空间解释,展示给用户后立即进入第 5 步,让用户在子智能体并行工作时阅读思考。
- 设计多个接口:用 Agent 工具并行启动 3 个以上子智能体,每个产出截然不同的接口方案,并分别给出不同的设计约束(见上)。
- 用户挑选一个接口,或接受推荐。
- 创建 GitHub issue:使用 gh issue create 按 REFERENCE.md 中的模板创建重构 RFC,无需用户事先审阅,直接创建并分享 URL。
适用场景
适用于需要发现代码库架构改进机会、提升可测试性、以及将浅模块重构为深模块的场景。尤其适合希望以 GitHub issue RFC 形式提出重构提案、并借助多个并行设计方案进行比较与决策的开发者。
限制
资料中未提供关于收费、价格、支持平台、依赖工具版本或性能效果的具体信息。此外,资料中提到依赖分类、issue 模板等内容定义在 REFERENCE.md 中,但该文件的具体内容暂未提供。