需要基于证据解释某问题、概念、变更或工作窗口的来龙去脉时…

当用户要求解释某事物为何或如何形成，或某段时间内发生了什么，并希望回答有源码证据、区分已记录依据、推断与未知时使用。

适用场景

解决思路

1. 产出能回答限定问题、并让消费者达到预期用途所需理解的解释；主体和目的来自请求与可用上下文，无论提供者是人还是其他 workflow。
2. 将项目行为建立在源码证据上；区分有文档依据的 rationale、推断和未知。
3. 按完成标准交付：交付带支持证据和重要未解答问题的解释，或返回具体阻塞项；请求 artifact 时交付 artifact 及其位置；发布是单独动作，不是已解释主体的条件。
4. 按目标读者和用途调整深度与呈现；个人可能需要可用答案，调用 agent 可能需要给别人的教学 artifact；不要仅凭调用者身份推断输出。
5. 当为进行中的 workflow 贡献时，交付请求结果，把继续处理留给其所有者即调用 workflow；不要在该返回中添加目的地菜单或后续提议。
6. 在提问前解析可发现事实；仅当缺失信息会实质性改变答案且无法从请求或证据解析时才询问。
7. 如果交互不可用，返回未解决问题及其后果，而不是等待或编造答案；结果可以解释已验证行为，同时报告历史 rationale 未知。
8. 在 grounding、第一个阻塞问题或派发 subagent 前，读取 `references/orchestration.md`；它定义证据收集、工具使用、模型层级及其回退。
9. 仅当归档到 repo 时，explainer 落在 `<root>/explainers/`；learnings 可从 `<root>/solutions/` 读取；仅在组合这类路径时解析 `<root>`；纯 scratch 或外部概念运行绝不组合该路径；将解析后的路径传给任何 subagent，而不是配置。
10. 在组合任何 artifact 路径前解析 CE artifact root `<root>`：只从 `<repo-root>/.compound-engineering/config.yaml` 读取 `docs_root`，其中 `<repo-root>` 用 `git rev-parse --show-toplevel`；不要从 `config.local.yaml` 读取；未设置时 `<root>` 为 `docs`。
11. 验证设置的 `docs_root`：必须是 repo 相对目录，其真实、symlink 解析后的路径仍在 repo 内，且不是 repo 根也不是 `.git/` 下；否则停止并报错，错误中命名 `docs_root` 和该值；绝不回退到 `docs`。
12. 将 `<root>` 作为唯一 artifact 位置：不存在则创建；每个路径组合为 `<root>/<subdir>`，其中 `<subdir>` 是本技能自己的子目录；绝不同时读取 `docs`。
13. Phase 1 现在读取 `references/intake.md`；它定义主体和时间窗口如何解析、输入 tokens、交付形式如何选择。
14. 只解释请求的主体；无可恢复主体的裸调用需要按交互规则澄清，而不是发明主题或默认 artifact。
15. Phase 2 按 `references/orchestration.md` 做限定范围的证据 pass；证据充分且当前时使用现有证据；检查支持缺失、有争议或受来源变更影响的声明。
16. 仅当 artifact 或 evidence dossier 需要 run directory 时才创建；在写二者前按原文 bash 块创建 `$RUN_DIR`：设置 `SCRATCH_ROOT` 为 `/tmp/compound-engineering-$(id -u)`，拒绝 symlink 或非当前用户拥有的 scratch root，必要时回退到 `${TMPDIR:-/tmp}/compound-engineering-$(id -u)`，用 `mkdir -p` 创建并 `chmod 700`，再用 `$SCRATCH_ROOT/ce-explain/$(date +%Y%m%d)-$(openssl rand -hex 3)` 构成 `RUN_DIR`，创建并 `echo` 它。
17. 当行为 trace 跨所有权边界时写 scout dossiers；在派发这些 scouts 前创建这个 run directory。
18. Diff mode：空范围或缺失主体时，不要静默解释别的东西；在解释相邻事物前先报告；仅当请求允许或用户同意时使用替代；在结果和 artifact `Subject` 中命名替代；否则把未解析作用域返回调用者。
19. Recap mode：不要在主对话预扫描、计数或描述窗口；直接派发通用 subagent 到 extraction tier，用 `references/agents/work-recap-scout.md` 作为种子，并传入解析后的 window、repo root 和 `$RUN_DIR`。
20. Recap mode 空窗口：报告无活动并结束，不创建 explainer artifact。
21. Recap mode 当 harness 不暴露 subagent primitive 时，用其 prompt 的 sources 和 budgets 内联运行 scout，仍写 `recap-evidence.md`，并在完成前不形成对窗口的看法；若派发失败，遵循 `references/orchestration.md` 的回退规则。
22. Phase 3 使用证据回答问题，保留重要约束和不确定性。
23. 交付前对照来源检查每个事实声明；函数调用不能证明未检查实现的保证。
24. 移除无支持声明或在出现处说明其不确定性，包括 diagrams 和 exercise answers。
25. 当 prose、code、tables、visuals 能提升理解时选择它们；没有特定排列要求。
26. 解释多人工作时保持归属准确。
27. 当从超过请求范围或深度的更多证据中选择时，披露选择；绝不静默把部分叙述呈现为穷尽。
28. 对另一个 workflow 将合并的答案或材料，直接返回内容；每段必须携带准确使用所需的限定，无需单独 notes；当另一 workflow 将使用答案时，该返回包括证据、仍适用的约束、未解答问题；除非预期用途需要，不要创建 standalone artifact。
29. 对 standalone artifact，在 compose 时读取 `references/explainer-html.md` 或 `references/explainer-markdown.md`，了解所选格式的兼容性和 metadata 要求；对教学 artifact 还要读取 `references/check-in.md`；运行绝不因 check-in 阻塞；任何练习是 artifact 中的静态内容；写 `$RUN_DIR/explainer.html` 或 `explainer.md`，然后交付内联摘要加文件路径。
30. Phase 4：已交付的答案或本地 artifact 完成解释；不要要求目的地选择或制造后续工作。
31. 如果请求了目的地，行动前读取 `references/destinations.md`；它定义每个目的地和发布所需同意。
32. 当调用 workflow 拥有周围文档时，把内容返回给它，而不是自己放置或发布。
33. 发布到 ht-ml.app 绝不 headless 且绝不推断；命名它即选择目的地，而不是在 public-publishing 警告后确认；无法获得确认则不发布；保留 canonical HTML 并报告本地 `$RUN_DIR/explainer.html` 路径。

适用边界 · 注意事项

• 需要判断某方案是否应采用或改变时，不要用本技能，改用 `ce-pov`；解释历史选择不等于今天认可它。
• 需要捕获持久项目学习或维护 repo memory、生成替代方案或头脑风暴或规划实现、诊断或修复报告故障时，不要用本技能，分别改用 `ce-compound`、`ce-ideate`/`ce-brainstorm`/`ce-plan`、`ce-debug`。
• 缺少可恢复主体且无法交互澄清时，不要发明主题或默认 artifact；应返回未解决范围或阻塞项。