SuperAPI AI 工具集

improve-codebase-architecture

通用与其它

查看项目

更新于 10-16 00:21

技能介绍

用途:探索代码库,像 AI 一样发现架构摩擦点,寻找提升可测试性的机会,并提出“模块加深”重构方案,最终写成 GitHub issue RFC。

主要能力:基于 John Ousterhout《A Philosophy of Software Design》中的深模块理念——小接口隐藏大实现,深模块更易测试、更易被 AI 导航,并支持在边界而非内部进行测试。流程包括:用 Agent 工具以 subagent_type=Explore 自然探索代码库,记录摩擦点(理解一个概念需在多个小文件间跳转、模块过浅、仅为可测试性抽取纯函数但真实 bug 藏在调用方式中、紧耦合模块在接缝处产生集成风险、未测试或难测试的部分);以编号列表呈现加深候选,展示涉及的模块/概念、耦合原因、依赖类别、测试影响,此时不提出接口,而是询问用户想探索哪个;用户选定后,先写出面向用户的问题空间说明(新接口需满足的约束、需依赖的依赖项、示意性代码草图),随后并行启动 3 个以上子代理,各自按不同设计约束产出截然不同的接口(最小化接口、最大化灵活性、优化最常见调用者、端口与适配器模式),每个输出接口签名、用法示例、隐藏的复杂度、依赖策略与权衡;依次展示后比较并给出有主见的推荐或混合方案;用户选定接口后,将重构 RFC 写入 issues/ 下的本地 markdown 文件,使用 REFERENCE.md 中的模板,无需用户先审阅。

适用场景:需要评估代码库架构、提升可测试性、规划模块重构并形成可讨论的 RFC 时。

限制:资料未提供具体安装命令、收费、价格、平台或效果信息;依赖 Agent 工具与 Explore 子代理,具体实现细节以官方资料为准。