SuperAPI AI 工具集

improve-codebase-architecture

编程与开发

查看项目

更新于 10-16 03:14

技能介绍

用途:帮助识别并推进“加深模块”的重构,把接口复杂度与实现复杂度相当的浅模块,改造为小接口承载大量行为的深模块,从而提升杠杆、局部性与可测试性。

主要能力:以迭代循环运行——探索摩擦、呈现候选、对选定候选进行对抗式追问、内联更新领域文档。使用一套固定词汇(Module、Interface、Depth、Seam、Adapter、Leverage、Locality),并遵循删除测试、接口即测试面、两个真实实现才算真实接缝等原则。

使用方式:第一步必须派发 Explore 代理,而非直接读取;代理读取 CONTEXT.md(或 CONTEXT-MAP.md 及各上下文 CONTEXT.md)与 docs/adr/,若不存在则静默继续。随后有机遍历代码库,分类摩擦:概念理解需跨多个小模块、接口复杂度等于实现复杂度、仅为可测试性抽取纯函数而真实缺陷藏在调用方、模块紧耦合泄漏接缝。每个可疑点先跑删除测试再报告。第二步以编号列表呈现候选,每项含文件、问题(引用删除测试)、解决方案(不含接口)、收益;与 ADR 冲突时明确标注并说明是否值得重开。第三步用户选定后进入对抗式访谈,逐个决策推进,并内联更新 CONTEXT.md 或提议 ADR;若需替代接口,转向 references/INTERFACE-DESIGN.md 的并行子代理“设计两次”流程。

适用场景:需要系统性重构、改善模块深度与测试策略的代码库。

限制:禁止在第二步就提出接口(过早承诺)、禁止捆绑无关重构、禁止无实质理由重开 ADR。资料未提供具体安装命令、收费或平台信息。