SuperAPI AI 工具集

improve-codebase-architecture

编程与开发

查看项目

更新于 11-04 04:19

技能介绍

用途

Improve Codebase Architecture 是一个 AI 技能,旨在扫描代码库,发现架构摩擦点,并识别“深化”机会——即重构浅层模块,使其成为更深层模块,从而提升可测试性和 AI 可导航性。它适用于希望对现有代码库进行架构改进的场景。

主要能力

  • 探索与扫描:根据用户指定的方向或通过提交历史热点推断,结合领域词汇表(GLOSSARY.md)和架构决策记录(ADRs),子代理有机地探索代码库,识别理解概念需跨多个模块、模块接口复杂、纯函数提取导致局部性问题、模块耦合泄漏、难以测试等摩擦点。
  • 生成 HTML 报告:将候选重构点以自包含 HTML 文件形式写入临时目录,并使用 Tailwind 和 Mermaid 进行布局与示意图,每个候选包含文件、问题、解决方案、收益、前后对比图及推荐强度(Strong/Worth exploring/Speculative),报告末尾提供首选推荐。
  • 引导式讨论:用户选定候选后,调用 grilling 技能走决策树,讨论约束、依赖、模块形态、接缝后内容和测试留存;并在过程中通过 domain-modeling 技能维护领域模型(如更新 GLOSSARY.md、提供 ADR)。

使用方式

用户通过命名该技能的提示或简报来调用。技能会先确定范围(优先近期变更区域),阅读 GLOSSARY.md 和 ADRs,然后生成 HTML 报告并询问用户想探索哪个候选,之后进入讨论循环。

适用场景

适用于需要发现代码库架构改进机会、提升模块深度和可测试性的开发团队。尤其适合有领域术语和 ADR 记录的项目。

限制

  • 依赖 GLOSSARY.md 和 docs/adr/ 的存在;若缺失,使用代码自身命名并惰性创建。
  • 报告生成在临时目录,不写入仓库。
  • 不直接提出接口设计,需用户选择后进入讨论。
  • 需使用指定的架构词汇(module, interface, depth, seam, adapter, leverage, locality),避免使用 component、service、API、boundary 等词。
  • 若候选与 ADR 冲突,仅当摩擦足够真实时才提出并标注。
  • 对于临时性原因不提供 ADR 记录。