用途:这是一个面向代码库架构评审的智能体技能,用于发现架构摩擦并提出“深化机会”——把接口几乎和实现一样复杂的浅模块,重构为小接口背后承载大量行为的深模块,从而改善可测试性与 AI 可导航性。
主要能力:先阅读项目领域词汇表与该区域的 ADR,再通过 Agent 工具的 Explore 子代理有机地遍历代码,寻找理解一个概念需在多个小模块间跳转、模块过浅、纯粹为可测试性抽出的函数、紧耦合模块跨越接缝泄漏、以及难以通过现有接口测试的位置。用删除测试判断疑似浅模块:删除后复杂度消失说明是直通模块,复杂度在多个调用方重现才说明其在创造价值。
使用方式:以候选卡片形式输出自包含 HTML 报告,写入系统临时目录($TMPDIR,回退 /tmp,Windows 用 %TEMP%),文件名为 architecture-review-<timestamp>.html,并用相应命令打开:Linux 用 xdg-open <path>,macOS 用 open <path>,Windows 用 start <path>,同时告知绝对路径。报告通过 CDN 使用 Tailwind 布局、Mermaid 画图,并混合手绘 CSS/SVG 视觉。每张卡片包含涉及文件、问题、方案、收益(以 locality 和 leverage 说明及测试改进)、前后对比图、建议强度徽章(Strong、Worth exploring、Speculative),最后给出 Top recommendation。报告写完后询问用户“Which of these would you like to explore?”,再进入深入讨论循环。
适用场景与限制:适合希望以领域语言和 ADR 为约束进行架构评审、并找到可重构候选的项目。需要遵守固定术语(Module、Interface、Implementation、Depth、Seam、Adapter、Leverage、Locality),不要混用 component、service、API、boundary;若候选与 ADR 冲突,仅在摩擦足够大时才提出并明确标注。此阶段不提议接口,相关替代接口设计见 INTERFACE-DESIGN.md。其他细节、完整模板与样式指引需查阅 HTML-REPORT.md、LANGUAGE.md、CONTEXT-FORMAT.md、ADR-FORMAT.md;官方说明与许可信息暂未提供。