SuperAPI AI 工具集

improve-codebase-architecture

通用与其它

查看项目

更新于 10-15 17:30

技能介绍

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

主要能力:使用统一术语(Module、Interface、Implementation、Depth、Seam、Adapter、Leverage、Locality)描述建议;用删除测试判断模块是否为直通;以接口作为测试面;区分假设接缝与真实接缝。流程分三步:先阅读领域词汇表与相关 ADR,再用 Agent 工具以 subagent_type=Explore 探索代码库并记录摩擦点;随后以编号列表呈现候选,每项含涉及文件、问题、解决方案、收益;最后进入追问式讨论,逐步明确约束、依赖、深化模块形态、接缝背后内容与可存活的测试。

使用方式:先读 CONTEXT.md 与 docs/adr/,再探索代码库;呈现候选后询问用户想探索哪一个,不提前提出接口。讨论中若出现 CONTEXT.md 未收录的概念,可将其加入 CONTEXT.md;若用户以关键理由拒绝候选,可提议记录为 ADR。

限制:资料未提供安装命令、平台、收费或价格信息;不提出接口设计,需用户选择候选后再深入;与 ADR 冲突的候选仅在摩擦足够真实时提出并明确标注。