القائمة
扫描代码仓寻找深化机会，以可视化 HTML 报告呈现，然后针对你选择的任一方案进行访谈打磨。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
对 workflow 下已完成 change 执行归档移动，从归档 change 中提取知识并合并到 workflow INDEX.md 声明的 _state/ 知识 store（adr/、context/ 等）， 然后审计并清理过时/重复知识。默认 dry-run 返回可确认计划，所有破坏性动作需用户显式确认后执行。 触发场景：workflow 中存在 change_status: completed 的 change 需要归档收尾、知识沉淀、清理过时内容时。
构建一个一次性原型来回答设计问题。当用户想要快速验证某个状态模型或逻辑是否正确，或探索 UI 应该长什么样时使用。
将 Speculo 多文件能力（skill/command/workflow）合并为自包含单 MD 文档，上传到网页 AI 平台（ChatGPT Projects、Claude Projects、NotebookLM）使用。触发：用户要求生成 canonical 文档、要求将能力打包为单文件、或要求上传能力到 AI 平台时。
创建、审计、合并或迁移 Speculo 的可复用 skill。用户要求新增 template/skills 能力、清理 SKILL.md、整合相似 skills、迁移外部 skill 或修复渐进披露时使用。
在指定 workflow 中撰写单个 work 入口文件（X-name/X-name.md）及其渐进披露子文件。用户指定 workflow 和 work 名称，要求新增 work、为已有 work 补充子文件、重构 work 步骤结构、优化完成标准、对齐主导词或修复 <Path> 指针时使用。
在指定 workflow 包中新增、审计或合并 work 入口。用户指定 workflow 名称（如 template/workflows/person）并要求新增具体 work、审计现有 work 的渐进披露结构、合并相似 work、基于参考材料生成 work 或对齐 <Path> 路径引用格式时使用。
| name | improve-codebase-architecture |
| description | 扫描代码仓寻找深化机会，以可视化 HTML 报告呈现，然后针对你选择的任一方案进行访谈打磨。 |
| disable-model-invocation | true |
揭示架构摩擦，提出深化机会 — 将浅层模块转变为深层模块的重构。目标是可测试性和 AI 可导航性。
此命令_基于_项目的领域模型，并建立在共享设计词汇之上：
/codebase-design 技能获取架构词汇（module、interface、depth、seam、adapter、leverage、locality）及其原则（删除测试、"接口就是测试表面"、"一个适配器 = 假设缝合点，两个 = 真实缝合点"）。在每个建议中严格使用这些术语 — 不要滑向 "component"、"service"、"API" 或 "boundary"。CONTEXT.md 中的领域语言为好的缝合点提供名称；docs/adr/ 中的 ADR 记录此命令不应重新争论的决策。首先阅读项目的领域词汇表（CONTEXT.md）和你接触区域的任何 ADR。
然后使用 Agent 工具，以 subagent_type=Explore 遍历代码仓。不要遵循僵化的启发式 — 有机地探索，注意你在何处遇到摩擦：
对你怀疑是浅层的任何东西应用删除测试：删除它会集中复杂性，还是仅仅移动它？"是的，会集中"就是你想要的信号。
将自包含的 HTML 文件写入操作系统临时目录，以免任何内容落入仓库。从 $TMPDIR 解析临时目录，回退到 /tmp（Windows 上用 %TEMP%），写入 <临时目录>/architecture-review-<时间戳>.html，使每次运行获得全新文件。为用户打开它 — Linux 上用 xdg-open <路径>，macOS 上用 open <路径>，Windows 上用 start <路径> — 并告知绝对路径。
报告使用 Tailwind via CDN 进行布局和样式设置，使用 Mermaid via CDN 绘制图/流程/序列可靠传达结构的图表。混合使用 Mermaid 和手写 CSS/SVG 视觉效果 — 当关系是图形态时（调用图、依赖关系、序列）使用 Mermaid，当想要更偏编辑性时（质量图、横截面、折叠动画）使用手写 div/SVG。每个候选方案包含一个前后对比可视化。要注重视觉效果。
为每个候选方案渲染一张卡片，包含：
Strong、Worth exploring、Speculative 之一，渲染为徽章以最佳推荐部分结束报告：你会首先处理哪个候选方案以及原因。
使用 CONTEXT.md 的词汇处理领域，使用 /codebase-design 的词汇处理架构。 如果 CONTEXT.md 定义了 "Order"，谈论 "Order 接收模块" — 而非 "FooBarHandler"，也非 "Order 服务"。
ADR 冲突：如果某个候选方案与现有 ADR 矛盾，仅在摩擦足够真实、值得重新审视 ADR 时才提出。在卡片中清晰标记（例如警告标注："与 ADR-0007 矛盾 — 但值得重新讨论因为……"）。不要列出 ADR 禁止的所有理论重构。
参见 HTML-REPORT.md 获取完整的 HTML 脚手架、图表模式和样式指南。
此时不要提出接口。文件写入后，询问用户："你想探索其中哪一个？"
一旦用户选择了候选方案，运行 /grilling 技能与他们一起遍历设计树 — 约束、依赖、深化模块的形状、缝合点后面的内容、哪些测试存留下来。
当决策结晶时，副作用即时发生 — 运行 /domain-modeling 技能保持领域模型同步更新：
CONTEXT.md 中没有的概念命名深化模块？ 将术语添加到 CONTEXT.md。如果文件不存在则延迟创建。CONTEXT.md。/codebase-design 技能并使用其"设计两次"并行子 agent 模式。