SuperAPI AI 工具集

improve-codebase-architecture

通用与其它

查看项目

更新于 10-16 05:46

技能介绍

用途:探索代码库,发现架构摩擦点,寻找提升可测试性的机会,并提出模块加深式重构建议。核心理念来自 John Ousterhout《A Philosophy of Software Design》:深模块用较小接口隐藏较大实现,更易测试、更易被 AI 导航,并可在边界而非内部进行测试。

主要能力与流程:1)使用 Agent 工具(subagent_type=Explore)自然探索代码库,不套用僵硬启发式,记录摩擦点,例如理解一个概念需在多个小文件间跳转、模块过浅导致接口几乎与实现同样复杂、仅为可测试性抽取纯函数但真实缺陷藏在调用方式中、紧耦合模块在接缝处产生集成风险、以及未测试或难以测试的部分。2)以编号列表呈现加深候选,每项包含涉及的模块/概念、耦合原因、依赖类别(见 REFERENCE.md 的四类)、测试影响,此时不提出接口,并询问用户想探索哪一个。3)用户选定候选后,先写出面向用户的问题空间说明,包括新接口需满足的约束、需依赖的依赖项、以及用于具体化约束的示意性代码草图(非提案),随后立即进入下一步。4)并行启动 3 个以上子代理,各自依据独立技术简报产出截然不同的接口设计,设计约束分别为:最小化接口(1-3 个入口)、最大化灵活性、优化最常见调用方、以及适用时围绕 ports & adapters 模式。每个子代理输出接口签名、用法示例、隐藏的内部复杂度、依赖策略与权衡。依次展示后以文字比较,并给出自己的推荐或混合方案。5)用户选定接口或接受推荐后,使用 gh issue create 创建重构 RFC,模板见 REFERENCE.md,创建前不要求用户审阅,直接创建并分享 URL。

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

限制:资料未提供具体安装命令、收费、价格、平台支持或效果数据;依赖 Agent 工具与 gh CLI 环境,具体可用性暂未提供。