用途:扫描代码库,发现架构摩擦并给出“深化机会”建议,即把浅模块重构为深模块,目标是提升可测试性与 AI 可导航性。
主要能力:先按 YAGNI 界定范围,若用户指定方向则直接采用,否则通过 git log --oneline 回看提交历史定位热点;读取 CONTEXT.md 领域词汇与 docs/adr 中 ADR;再派子代理探索代码库,关注概念分散、浅模块、缺乏局部性、接缝泄漏、难测试等问题,并对疑似浅模块应用删除测试。之后生成自包含 HTML 报告,写入系统临时目录,文件名为 <tmpdir>/architecture-review-<timestamp>.html,并用 xdg-open/open/start 打开。报告用 Tailwind CDN 布局、Mermaid CDN 绘制图关系,也混用手写 CSS/SVG;每个候选含文件、问题、方案、收益、前后对比图与推荐强度(Strong、Worth exploring、Speculative),并附 Top recommendation。
使用方式:用户选定候选后运行 /grilling 技能走决策树,配合 /domain-modeling 更新 CONTEXT.md,必要时提议记录 ADR;探索替代接口可运行 /codebase-design 的 design-it-twice 并行子代理模式。
限制:本阶段不提出具体接口;仅当摩擦足够真实时才指出与 ADR 冲突;避免使用 component、service、API、boundary 等词。