improve-codebase-architecture

技能简介

该技能会扫描代码库，找出架构上的「深化机会」（把浅模块重构成深模块），并以可视化 HTML 报告呈现；你选定一个候选后，技能会与你一起对该方案进行严审。目标是提升代码的可测试性和 AI 可导航性。

使用场景

• 定位代码库中的「浅模块」，即接口与实现几乎同样复杂的模块
• 聚焦近期频繁改动的热点区域，发现架构摩擦点
• 生成自包含的 HTML 架构审查报告，供团队讨论和决策
• 针对某个重构方向进行严格推敲，理清约束、依赖与测试影响
• 在重构过程中同步维护领域词汇（CONTEXT.md）或沉淀 ADR

使用方法

1. 探索（Explore）：先定范围，后扫描。若用户已指明方向就直接采用；否则用 git log --oneline 找出热点区域。先读 CONTEXT.md 和 docs/adr/，再派子代理（sub-agent）走查代码，注意浅模块、跨 seam 泄漏、为测试而抽出的纯函数调用点混乱等问题，并用「删除测试」判断候选是否真的值得深化。
2. 生成 HTML 报告（Present）：将报告写入系统临时目录（$TMPDIR，兜底为 /tmp 或 %TEMP%），文件名为 architecture-review-<timestamp>.html，打开给用户并显示绝对路径。报告使用 Tailwind + Mermaid（均走 CDN）排版绘图，每个候选包含涉及文件、问题、方案、收益、前后对比图及推荐强度徽章，最后给出 Top recommendation。
3. 严审循环（Grilling loop）：用户选定候选后，调用 Skill 工具的 grilling 走决策树；过程中若命名了新领域概念则更新 CONTEXT.md，若用户给出关键否决理由，可提议将其记录为 ADR，避免未来重复建议。

注意事项

• 必须使用统一架构词汇（module、interface、depth、seam、adapter、leverage、locality），不要替换成 component/service/API/boundary。
• 建议应与 CONTEXT.md 的领域语言保持一致；若与现有 ADR 冲突，仅在摩擦足够真实时提出，并在卡片中明确标注。
• 报告只写入临时目录，不落进代码仓库；探索阶段不要先提接口设计，等用户选好候选后再深入。