用途:发现并呈现把“浅模块”重构为“深模块”的机会,目标是提升可测试性与 AI 可导航性,而非泛泛重构。
主要能力:先用 git log --oneline 回看提交历史定位热点区域(若用户指定模块或痛点则直接采用);读取 GLOSSARY.md 领域词汇与 docs/adr/ 中的 ADR,避免重复讨论已有决策;启动子代理有机遍历代码,寻找理解概念需在多个小模块间跳转、接口复杂度接近实现、仅为可测试性抽取纯函数导致缺少局部性、紧耦合模块跨缝泄漏、难测或未测部分等摩擦;对疑似浅模块做“删除测试”。随后在系统临时目录写出自包含 HTML 报告(<tmpdir>/architecture-review-<timestamp>.html,Linux 用 xdg-open、macOS 用 open、Windows 用 start 打开),用 Tailwind CDN 与 Mermaid CDN 加手工 CSS/SVG 呈现每个候选的文件、问题、方案、收益、前后对比图及推荐强度(Strong / Worth exploring / Speculative),并在结尾给出首选建议。
使用方式:选中候选后调用 grilling 技能走决策树,讨论约束、依赖、深化模块形态、缝后内容与存活测试;决策成形时调用 domain-modeling 更新词汇表,必要时建议记录 ADR 或调用 codebase-design 的 design-it-twice 模式探索替代接口。
限制:本阶段不提出具体接口;违反 ADR 的候选仅在摩擦确实值得重开时标注;应使用词汇表中的术语(如深度、缝、局部性等),不要混用“component”“service”“API”“boundary”等词。HTML-REPORT.md 提供完整脚手架与样式指引。具体运行环境要求、版本与收费信息暂未提供。