用途:探索代码库,发现架构摩擦点,寻找提升可测试性的机会,并提出“模块加深”重构方案,最终以 GitHub issue RFC 形式输出。
主要能力:基于 John Ousterhout《A Philosophy of Software Design》中“深模块”理念——小接口隐藏大实现,深模块更易测试、更利于 AI 导航,并支持在边界而非内部进行测试。流程包括:用 Agent 工具(subagent_type=Explore)自然探索代码库,记录摩擦点(如理解一个概念需在多个小文件间跳转、模块过浅、为可测试性抽出的纯函数但真正 bug 藏在调用方式中、紧耦合模块的集成风险、未测试或难测试部分);列出编号的加深候选,展示涉及的模块/概念、耦合原因、依赖类别、测试影响,并询问用户选择;用户选定后,先写出面向用户的问题空间说明(新接口需满足的约束、依赖、示意性代码草图),随后并行启动 3 个以上子代理,各自按不同设计约束(最小化接口、最大化灵活性、优化最常见调用方、端口与适配器模式)产出截然不同的接口设计,包含接口签名、用法示例、隐藏的复杂度、依赖策略与权衡;依次展示并比较,给出有主见的推荐或混合方案;用户选定后,用 gh issue create 创建重构 RFC,不要求用户预先审阅,直接创建并分享 URL。
使用方式:作为 agent skill 调用,依赖 Agent 工具与 gh CLI。
适用场景:需要系统性发现架构改进点、提升可测试性、重构浅模块的代码库。
限制:资料未提供具体安装命令、收费、价格、平台支持或效果数据;REFERENCE.md 中的四类依赖与模板内容未在资料中展开。