SuperAPI AI 工具集

improve-codebase-architecture

前端与建站

查看项目

更新于 10-15 23:44

技能介绍

用途:扫描代码库,找出架构摩擦点并提出“深化”机会——把浅模块变成深模块,目标是提升可测试性与 AI 可导航性。建议基于项目领域模型,并使用统一架构词汇(模块、接口、深度、接缝、适配器、杠杆、局部性),配合 /codebase-design 技能的原则(删除测试、接口即测试面、一个适配器是假设接缝、两个才是真实接缝)。CONTEXT.md 提供领域命名,docs/adr/ 中的 ADR 记录不应被重新争论的决策。

主要能力与流程:

  1. 探索:先定范围(YAGNI),优先关注近期变更的热点区域;用 git log --oneline 回溯提交历史找热点;先读 CONTEXT.md 与相关 ADR;再用 Agent 工具(subagent_type=Explore)有机探索,记录摩擦点,如理解一个概念需在多个小模块间跳转、模块过浅、纯函数仅为可测试性而抽取但真实缺陷藏在调用处、紧耦合模块跨接缝泄漏、未测试或难以通过现有接口测试的部分。对疑似浅模块应用删除测试。
  2. 以 HTML 报告呈现候选:写入系统临时目录($TMPDIR,回退 /tmp 或 Windows 的 %TEMP%),文件名为 architecture-review-<timestamp>.html,避免落入仓库;用 xdg-open、open 或 start 打开并告知绝对路径。报告用 CDN 的 Tailwind 布局、CDN 的 Mermaid 画图,混合手写 CSS/SVG。每个候选卡片包含:涉及文件、问题、解决方案、收益(局部性与杠杆、测试改进)、前后对比图、推荐强度徽章(Strong、Worth exploring、Speculative)。结尾给出 Top recommendation。若候选与 ADR 冲突,仅在摩擦足够真实时标注。此阶段不提出接口,写完后询问用户想探索哪一个。
  3. 追问循环:用户选定后运行 /grilling 技能走决策树(约束、依赖、深化模块形态、接缝背后内容、哪些测试存活)。决策成形时内联运行 /domain-modeling 更新领域模型:新概念加入 CONTEXT.md(不存在则惰性创建)、模糊术语就地更新;用户以关键理由拒绝候选时,可提议记录为 ADR,仅当未来探索者确实需要该理由时。想探索替代接口时运行 /codebase-design 的 design-it-twice 并行子代理模式。

限制:资料未提供具体安装命令、收费、平台支持范围或效果数据;报告写入临时目录而非仓库;ADR 冲突仅在摩擦真实时呈现。