SuperAPI AI 工具集

improve-codebase-architecture

通用与其它

查看项目

更新于 10-16 00:06

技能介绍

用途:在代码库中寻找架构摩擦点,提出“深化机会”——把浅模块重构为深模块,以提升可测试性和 AI 可导航性。适用于用户希望改进代码库架构时。

主要能力:使用一套固定术语(模块、接口、实现、深度、接缝、适配器、杠杆、局部性),并遵循关键原则,如删除测试(若删除模块后复杂度消失,说明它只是透传;若复杂度在许多调用方重现,说明它有价值)、接口即测试面、一个适配器只是假设接缝、两个适配器才是真实接缝。

使用方式分三步。第一步探索:先读项目领域词汇表和该区域的 ADR,再检查代码库,记录理解产生摩擦之处,例如理解一个概念需在多个小模块间跳转、模块浅、仅为可测试性抽出纯函数而真实缺陷藏在调用方式中、紧耦合模块跨接缝泄漏、未测试或难以通过当前接口测试的部分;对疑似浅模块应用删除测试。第二步呈现候选:给出编号列表,每项包含涉及文件、问题、解决方案的通俗描述、收益(局部性、杠杆、测试改进),使用 CONTEXT.md 的领域词汇和 LANGUAGE.md 的架构词汇;若候选与现有 ADR 冲突,仅当摩擦足够真实时才提出;此时不提出接口,而是询问用户想探索哪一个。第三步追问循环:用户选定后,遍历设计树,包括约束、依赖、深化模块的形态、接缝背后的内容以及哪些测试能存活;决策成形时同步产生副作用,如新增 CONTEXT.md 术语、更新模糊术语、在用户以关键理由拒绝时提供 ADR、探索替代接口时使用 INTERFACE-DESIGN.md。

限制:资料未提供具体安装命令、平台支持、收费方式或效果数据;其流程依赖项目内已有的 CONTEXT.md、LANGUAGE.md、docs/adr/ 及相关格式文件。