SuperAPI AI 工具集

improve-codebase-architecture

前端与建站

查看项目

更新于 10-15 20:21

技能介绍

用途:识别架构摩擦并提出"深化"机会——把接口几乎与实现一样复杂的浅模块,改造成接口简洁、实现厚实的深模块,目标是提升可测试性与 AI 可导航性。

主要能力:

  • 探索代码库,记录理解一个概念需在多个小模块间跳转、模块过浅、为可测试性抽出的纯函数但真实缺陷藏在调用处(缺乏局部性)、紧耦合模块跨接缝泄漏、未测试或难以通过现有接口测试等摩擦点。
  • 对疑似浅模块应用删除测试:删除它是集中复杂度还是仅仅转移复杂度。
  • 生成自包含 HTML 报告,写入操作系统临时目录(由 $TMPDIR 决定,回退 /tmp 或 Windows 的 %TEMP%),文件名形如 <tmpdir>/architecture-review-<timestamp>.html,并用 xdg-open、open 或 start 打开,告知用户绝对路径。报告用 Tailwind CDN 布局、Mermaid CDN 绘图,每个候选卡片包含涉及文件、问题、解决方案、收益(局部性与杠杆)、前后对比图,以及强度徽章(Strong、Worth exploring、Speculative),末尾给出优先推荐。

使用方式:需先运行 /codebase-design 技能获取架构词汇(模块、接口、深度、接缝、适配器、杠杆、局部性)及其原则,并在所有建议中严格使用这些术语;领域语言以 CONTEXT.md 为准,docs/adr/ 中的决策不应被重新争论。报告写完后先问用户想探索哪个候选,选定后运行 /grilling 技能推演设计树,过程中用 /domain-modeling 技能同步更新领域模型(如向 CONTEXT.md 添加术语)。

限制:报告阶段不提出具体接口;若候选与现有 ADR 冲突,仅在摩擦确实严重到值得重审时才呈现并明确标注;只记录未来探索者真正需要的、会让其避免重复建议的理由,跳过临时或显而易见的理由。