improve-codebase-architecture

深度探索一个主题并产出精简 HTML 研究报告。grilling 式追问锁定真实需求 → 多路并行搜索（一手来源优先，允许分级引用非一手来源）→ 事实审计 → 单文件 HTML 报告（1500-3000 字）。适用于用户说「深度探索」「深入研究某主题并出报告」时。

当被原型化的界面不属于任何 web 项目（游戏 mod 的 XML/Lua UI、桌面应用、无框架仓库）时，用一个自包含 HTML 文件做出几个结构不同的 UI 方案供用户对比。适用于用户说"优化这个界面""再来几款方案""这几个都不行"，或需要在预览面板里比较布局差异时。

为此仓库配置 engineering skills——设置其 issue tracker、triage labels 词汇与 domain docs 布局。适用于首次在某个仓库中使用 engineering skills 之前，或用户要求重新配置 issue tracker、triage labels 与 docs…

清理协议/契约/规则文档的版本沉积。适用于文档按 v1→vN 版本增量堆叠、含"X 起已废除/见下章"死规则、同一规则多处定义互相矛盾、同一主题散在多个版本章节时；把文档重写为按主题组织的现行状态。

为多步骤任务搭一个防跑偏的最小骨架——把状态放进文件、把「完成」的判断权从模型手里拿走。适用于用户要开始一个步骤较多、容易中途跑偏或提前收尾的任务，或明确要「长任务模板」「任务骨架」「防跑偏」时。

体检并优化第三方/交接来的 skill 压缩包。适用于用户给一个 skill zip/文件夹要求"优化""审查""体检"，或安装前想先排查问题时。配合 writing-for-agents 使用。

询问当前情境适合哪个技能或流程；它是本仓库所有 skills 的路由器。适用于用户不确定该用哪个 skill 或 flow、问“该用哪个 skill”，或需要为当前情境选择工作流路线时。

构建并打磨项目的领域模型。适用于用户想明确领域术语或通用语言、记录架构决策，或其他技能需要维护领域模型时。

在 working directory 中打磨计划或设计的持续追问式访谈，过程中同步沉淀 CONTEXT.md 词汇表与 ADR。适用于用户想边打磨想法边留文档痕迹、或明确要求访谈产出 ADR/术语表时。

把当前对话压缩成交接文档，让另一个代理接手。适用于用户要把对话交给新 harness、新目录、同事，或在阶段中途分叉 side task 时。

基于 spec 或 ticket 集合实现一段工作。适用于用户想实现 spec 或 tickets 中描述的工作、要求“implement this”，或已有一组待办 ticket 需要逐个落地时。

适用于需要解决正在进行的 git merge/rebase 冲突时。