SuperAPI AI 工具集

improve-codebase-architecture

编程与开发

查看项目

更新于 10-16 05:44

技能介绍

用途:在代码库中寻找架构摩擦点,提出“深化机会”——把浅模块重构为深模块,以提升可测试性与 AI 可导航性。该技能受项目领域模型影响:领域语言为好的接缝命名,ADR 记录不应被重新争论的决策。

主要能力:使用统一术语(模块、接口、实现、深度、接缝、适配器、杠杆、局部性),避免使用 component、service、API、boundary 等词。核心原则包括删除测试(删除模块后复杂度消失则为直通模块,复杂度分散到多个调用方则值得保留)、接口即测试面、一个适配器是假设接缝、两个适配器才是真实接缝。

使用方式:先阅读领域词汇表与相关 ADR,再用 Agent 工具以 subagent_type=Explore 探索代码库,记录摩擦点,如理解一个概念需在多个小模块间跳转、模块浅、纯函数仅为可测试性而抽取但真实缺陷藏在调用方式中、紧耦合模块跨接缝泄漏、未测试或难以通过当前接口测试的部分。随后以编号列表呈现候选深化机会,每项包含涉及文件、问题、解决方案、收益(用局部性与杠杆解释,并说明测试如何改善)。不要先提出接口,而是询问用户想探索哪一个。用户选定后进入“拷问循环”,沿设计树讨论约束、依赖、深化模块形态、接缝背后内容与存活测试。副作用内联发生:新概念加入 CONTEXT.md,模糊术语就地更新;用户以关键理由拒绝候选时,可提议记录为 ADR,仅当该理由对未来探索者避免重复建议确有必要时。

适用场景:希望改进代码库架构、提升可测试性与 AI 可导航性的项目。

限制:资料未提供具体安装命令、收费、价格、平台或效果信息;需依赖 CONTEXT.md、LANGUAGE.md、ADR-FORMAT.md、CONTEXT-FORMAT.md、INTERFACE-DESIGN.md 等文件,缺失时按说明惰性创建。