SuperAPI AI 工具集

improve-architecture

编程与开发

查看项目

更新于 10-15 22:41

技能介绍

用途:对代码库做整体架构与技术债扫描,找出“下一步重构最划算”的地方,目标是提升可测试性与可导航性——让模块足够深,使其接口本身成为测试面。

主要能力:先读取 CONTEXT.md 与 docs/adr/,再由探索子代理有机地走查代码,识别浅模块、局部性差、缺失或薄弱接缝、只能绕过接口测内部等问题;对可疑处做“删除测试”判断复杂度集中点,产出 3–7 个候选,每个绑定具体模块与摩擦类型。随后生成自包含 HTML 报告(仅内联 CSS/SVG,无外部脚本、样式表或 CDN),写入系统临时目录($TMPDIR,回退 /tmp;Windows 为 %TEMP%),文件名 architecture-review-<timestamp>.html,并用 open / xdg-open / start 打开,告知绝对路径。每张卡片含涉及文件、问题一句话、建议方向、收益要点、置信度徽章(Strong / Worth exploring / Speculative)以及前后结构对比草图,最后给出首选建议并询问用户选择哪个候选。

使用方式:以 /improve-architecture 运行。用户选定候选后,依次使用 grilling 逐问梳理深化模块的形态,使用 domain-modeling 处理副作用(补充或修正 CONTEXT.md 术语,必要时为被否决的候选写 1–3 句 ADR),并明确仪式层级(0 可直接进入 tdd,1+ 需先做需求)。层级 0 可在 tdd/verify 纪律下直接推进;层级 1 及以上必须使用 brainstorm 进入正常需求周期。

限制:全程使用严格词汇(module、interface、implementation、seam、adapter 及 depth/locality/leverage),不得漂移为 component、service、layer、boundary。报告只命名方向,不提出具体接口设计,接口形态留给 grilling 阶段。与现有 ADR 冲突的候选仅在证据达到 Strong 置信度时才纳入,否则丢弃。报告为临时产物,不写入仓库。

适用场景:需要系统性识别重构优先级、改善模块深度与接缝、降低技术债的代码库维护工作。