SuperAPI AI 工具集

improve-codebase-architecture

编程与开发

查看项目

更新于 10-15 20:21

技能介绍

用途:在代码库中识别架构摩擦并提出深化机会——将浅模块重构为深模块,目标是提升可测试性与 AI 可导航性。

主要能力:先阅读项目领域词汇表与相关 ADR,再用 Agent 工具(subagent_type=Explore)有机地浏览代码,记录摩擦点:理解一个概念需在多个小模块间跳转、接口与实现复杂度相近的浅模块、仅为可测试性抽出的纯函数而真实缺陷藏于调用方式(缺乏局部性)、紧耦合模块跨接缝泄漏、未测试或难以通过当前接口测试的部分。对疑似浅模块做删除测试:删除后复杂度消失则为直通模块,复杂度在 N 个调用方重现则说明其有价值。

使用方式:以编号列表呈现候选,每项含涉及文件/模块、问题、用平实英语描述的解决方案、以局部性与杠杆及测试改进说明的收益;领域词用 CONTEXT.md 词汇,架构建词汇用 LANGUAGE.md 词汇。与 ADR 冲突时仅在摩擦足够真实时提出并明确标注。此阶段不提出接口,先询问用户想探索哪个候选。用户选定后进入“拷问循环”:梳理约束、依赖、深化模块的形状、接缝之后的实现、哪些测试能存活。副作用内联发生:为新概念命名则加入 CONTEXT.md(可按需惰性创建);术语模糊则立即更新;用户以关键理由否决候选时,可提议记录为 ADR,仅在该理由能避免未来探索者重复建议时提出。需要替代接口方案时参考 INTERFACE-DESIGN.md。

限制:资料未提供安装命令、平台、收费或具体调用命令,这些暂未提供。