用途:扫描代码库,发现架构摩擦点并提出“深化”机会,即把浅模块重构为深模块,目标是提升可测试性与 AI 可导航性。
主要能力:先确定扫描范围(优先近期变更的热点区域),阅读 GLOSSARY.md 领域词汇与 docs/adr/ 中的 ADR;再派子代理有机探索代码库,关注概念理解需在多个小模块间跳转、接口复杂度接近实现、纯函数仅为测试而抽取、模块跨接缝泄漏、难以测试等摩擦点,并用删除测试判断模块是否浅。候选方案默认以 Markdown 呈现,用户要求或需要前后对比可视化时生成自包含 HTML 报告,写入系统临时目录($TMPDIR,回退 /tmp 或 %TEMP%),文件名形如 architecture-review-<timestamp>.html,并用 xdg-open、open 或 start 打开。每个候选包含涉及文件、问题、解决方案、收益、前后对比与推荐强度(Strong、Worth exploring、Speculative),最后给出首选建议。
使用方式:用户指定方向则直接采用,否则用 git log --oneline 回溯提交历史找热点。呈现候选后询问用户想探索哪一个,选定后调用 grilling 技能走决策树,并调用 domain-modeling 同步领域模型(更新 GLOSSARY.md、必要时提议 ADR)。
限制:此阶段不提出具体接口;与 ADR 冲突时仅在摩擦足够真实时标注;HTML 报告依赖 Tailwind 与 Mermaid CDN,离线或被拦截时需内联 CSS 并手绘 SVG。具体安装与调用细节资料未提供。