用途:发现代码库中的架构摩擦,提出深化机会——把浅模块重构为深模块,目标是可测试性和 AI 可导航性。
主要能力:以模块、接口、实现、深度、接缝、适配器、杠杆、局部性等统一术语描述建议;使用删除测试判断模块是否只是传递层;基于 CONTEXT.md 的领域语言命名接缝,并参考 docs/adr/ 中已有决策,避免重复推翻;将候选重构整理为自包含 HTML 报告,含文件、问题、解法、收益、前后对比图和推荐强度,并给出首选建议。
使用方式:先读领域词汇表和 ADR,再用 Explore 子代理探索代码库,记录摩擦点。把报告写到系统临时目录(如 <tmpdir>/architecture-review-<timestamp>.html),用 xdg-open、open 或 start 打开并告知绝对路径。报告用 Tailwind CDN 布局、Mermaid CDN 画图,混合手写 CSS/SVG。之后询问用户想探索哪个候选,再进入追问式设计讨论;命名新概念时更新 CONTEXT.md,有分量的拒绝理由可提议记录为 ADR。
适用场景:需要评估架构可测试性、减少浅模块、集中变更与知识、提升 AI 可导航性时。
限制:资料未提供安装命令、依赖版本、价格、平台支持或自动化修改代码的能力;报告生成后不直接提议接口,需用户选择候选后再深入。若候选与 ADR 冲突,仅在摩擦足够真实时标注并建议重开讨论。