用途:扫描代码库寻找“深化”机会,即把浅模块重构为深模块,目标是提升可测试性与 AI 可导航性。
主要能力:基于项目领域模型与共享设计词汇(模块、接口、深度、接缝、适配器、杠杆、局部性)给出建议;先用 git log --oneline 回溯提交历史定位热点,再以子代理有机探索代码库,识别理解概念需在多模块间跳转、接口复杂度接近实现、纯函数为测试而抽离、紧耦合模块跨接缝泄漏、难以测试等问题,并应用“删除测试”判断浅模块。
使用方式:用户可指定方向,否则依据提交历史推断热点;加载 /project-context 领域文件与 ADR。生成自包含 HTML 报告写入系统临时目录($TMPDIR,回退 /tmp 或 %TEMP%),文件名如 <tmpdir>/architecture-review-<timestamp>.html,并用 xdg-open、open 或 start 打开。报告用 Tailwind CDN 与 Mermaid CDN,每张卡片包含涉及文件、问题、解决方案、收益、前后对比图和推荐强度徽章,末尾给出首要推荐。用户选定候选后调用 /grilling 走决策树;命名或术语细化时调用 /domain-modeling;探索替代接口时调用 /codebase-design。
适用场景:需要梳理架构摩擦、寻找高杠杆重构点、提升模块局部性与测试效率的代码库。
限制:暂未提供具体版本、系统要求或收费信息;报告写入临时目录而非仓库;不鼓励使用“组件”“服务”“API”“边界”等术语;候选项若与 ADR、Reason 或 Fence 冲突,仅在摩擦真实到值得重新讨论时才提出;此阶段不提前提出接口设计。