用途:扫描代码库,找出架构摩擦点并提出“深化”机会,即把浅模块改造为深模块,目标是提升可测试性与 AI 可导航性。
主要能力:基于项目领域模型与共享设计词汇工作。先加载 codebase-design 技能获取架构词汇(module、interface、depth、seam、adapter、leverage、locality)与原则(删除测试、接口即测试面、一个适配器是假设接缝、两个才是真实接缝)。GLOSSARY.md 提供领域命名,docs/adr/ 中的 ADR 记录不应被重新争论的决策。
使用方式:先确定范围,优先关注近期变更的热点(可用 git log --oneline 查看提交历史);若用户指定方向则直接采用。随后派生子代理有机探索代码库,寻找理解一个概念需在多个小模块间跳转、接口复杂度接近实现、纯函数仅为可测试性而抽取、紧耦合模块跨接缝泄漏、未测试或难以通过当前接口测试等摩擦点,并对疑似浅模块应用删除测试。
报告:将自包含 HTML 文件写入系统临时目录(Windows 用 $env:TEMP,Linux/WSL/macOS 用 $TMPDIR 否则 /tmp),命名为 architecture-review-<timestamp>.html,并用 xdg-open、open 或 start 打开。报告用 Tailwind CDN 布局,Mermaid CDN 绘制图形关系,配合手写 CSS/SVG 做编辑式视觉。每个候选卡片包含文件、问题、解决方案、收益、前后对比图与推荐强度徽章(Strong、Worth exploring、Speculative),结尾给出 Top recommendation。报告语言跟随用户对话语言,架构术语首次出现保留英文并附括号翻译。若候选与 ADR 冲突,仅在摩擦足够真实时标注。
追问循环:用户选定候选后,加载 grilling 技能走决策树,讨论约束、依赖、深化模块形态、接缝背后内容与存活测试。决策成形时加载 domain-modeling 技能同步领域模型:新概念加入 GLOSSARY.md,模糊术语就地更新,用户以关键理由拒绝时可提议记录 ADR。
限制:报告阶段不提出接口;临时文件不落入仓库;不列出 ADR 禁止的所有理论重构;未提供具体安装命令、收费或平台信息。