spec-explain ​

把一个概念、diff、想法或你近期的一段工作，转成为你个人撰写的高密度可视化讲解，并可选加入 check-in（diff 的 predict-then-reveal、带批改的练习）帮助记忆。

ASCII 链路图 ​

text
Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
                                                           |
                                                           v
                                                           spec-explain
                                                           entry: standalone skill
                                                           type: standalone-skill

基本信息 ​

字段内容
Skillspec-explain
类型standalone-skill
研发链路位置Knowledge
当前入口standalone skill
兼容别名不适用
Sourceskills/spec-explain/SKILL.md
Governancesrc/cli/contracts/dual-host-governance/skills-governance.json（supported-host skills governance）

描述 ​

Create a durable, visual teaching artifact for a concept, diff, idea, or recent-work window, with an optional check-in that makes it stick. Use when the user asks to be taught or wants a deep explainer; not for ordinary Q&A, brief why-followups, diagnosis, status updates, or concise trade-off answers.

Source 契约摘要 ​

该 source skill 未声明标准 Workflow Contract Summary 小节；本页以 frontmatter、supported-host governance 和维护者补充元数据为准。

何时使用 ​

  • 想学习理解一个概念、diff 或一段自己近期的工作。
  • 需要为自己定制的可视化讲解材料。
  • 希望通过 predict-then-reveal 或练习巩固理解。

工作步骤 ​

  • 读取已完成工作、历史会话、Slack、release 记录或 docs/solutions。
  • 抽取可复用经验、已验证解法、上下文决策和过期知识。
  • 写入或刷新团队知识，并保留证据限制。
  • 让下一次 Codebase、Spec、Plan 或 Review 能复用这些知识。

输出 ​

  • solution docs、refresh report、session digest、Slack research digest 或 release notes。
  • 对重复、过期或冲突知识给出合并、替换、删除或保留判断。

Agent / Persona 列表 ​

  • 可使用 session historian、Slack researcher、learnings researcher、related docs finder 等研究型能力。
  • 知识写入由 orchestrator 负责，研究 agents 返回证据而不是直接写最终文档。

本 skill 在 source 中挂载了 1 个 skill-local 专家资产（agent 1 · persona 0），路径为 skills/spec-explain/references/{agents,personas}/。跨 skill 复用时，详情页按文件名去重。

名称类型摘要
spec-work-recap-scoutagentYou are a work-recap scout.

agent 详情页入口仍在 /reference/agents/*；完整按 skill 归属索引见 Agents 参考。persona 目前以 skill-local prompt 形式挂在所属 skill 下，不单独生成全局详情页。

边界 ​

  • 面向学习，不生成 repo 文档或结论判断。
  • 不替代 review verdict。

源码校准 ​

  • 本页由 website/scripts/generate-skill-detail-pages.js 从上游 source skill 生成。
  • 当前入口、兼容别名与宿主投递 metadata 来自 src/cli/contracts/dual-host-governance/skills-governance.json。
  • 当 source skill 或 governance contract 变化后，应重新运行 npm run reference:pages 并执行 npm run content:audit。