用途
ce-explain 用于回答一个已被限定范围的问题，并让结果的消费者获得足以支撑其预期用途的理解。解释的主题与目的来自请求与可用上下文，可能由人提供，也可能由另一个工作流提供。它要求把项目行为建立在源码证据之上，并区分三类信息：有文档记录的动机、推断、以及未知项。
它明确自己的边界：判断某个方法是否应被采纳或更改属于 ce-pov；记录持久的项目学习属于 ce-compound；生成替代方案与界定实现范围属于 ce-ideate、ce-brainstorm、ce-plan；诊断或修复已报告故障属于 ce-debug，而“对当前行为的事实性解释”仍留在本技能。解释一个历史选择并不意味着今天为其背书。
主要能力
- 解释“如何与为何”：给出答案并附支撑证据与实质性的未解问题。
- 区分证据类型：把有文档记录的动机、推断和未知项分开陈述。
- 适配消费者与交互：根据预期读者和用途调整深度与呈现方式，不单凭调用者身份推断输出。
- 请求前先解决可查明事实：仅在缺失信息会实质改变答案且无法从请求或证据解决时才提问；若无法交互，则返回未解问题及其后果，而不是等待或编造答案。
- 支持不同运行模式：包括 diff 模式与 recap 模式，并规定空范围或空窗口时的处理方式。
- 交付形式灵活：可使用散文、代码、表格或可视化以提升理解；也支持独立产物以及交给其他工作流直接使用的内容。
使用方式
执行流程分为四个阶段：
- 建立问题与用途：读取 references/intake.md，确定主题、时间窗口、输入 token 与交付形式。只解释被请求的主题；无主题的裸调用需要澄清，而不是杜撰主题或产出默认产物。
- 证据扎根：按 references/orchestration.md 进行限定范围的证据收集，在证据足够且最新时复用已有证据。仅在需要产物或证据档案时创建运行目录，并按规定脚本处理临时根目录的安全校验。recap 模式不预先在主对话中扫描或概括窗口，而是按提取层级派发子代理，传入已解析的窗口、仓库根与 $RUN_DIR。空窗口时报告无活动并结束，不生成解释产物。
- 组织解释：用证据回答问题，保留关键约束与不确定性。交付前逐条核对事实主张与来源；函数调用并不能确立对其未检查实现的保证。移除无支撑的主张，或在出现处标注不确定性，包括图表与练习答案。当可用证据多于所请求范围或深度时，披露这种选择，绝不把部分叙述当作穷尽。
- 交付：已交付的答案或本地产物即完成解释。不要求选择目的地，也不制造后续工作。若请求了目的地，需先读取 references/destinations.md。发布到 ht-ml.app 从不是无头执行或推断得出的行为；若无法获得确认，则不发布，保留规范 HTML 并报告其本地路径。
适用场景
- 用户要求解释代码、配置或流程为何是当前形态。
- 需要回顾某段工作窗口内发生了什么。
- 另一个工作流需要通过本技能生成解释性内容，例如面向他人的教学产物。
- 需要区分已记录动机、推断与未知项，并为结论提供证据支撑。
限制
- 只解释被请求的主题；范围为空或主题缺失时不得静默解释其他内容，需报告该情况或返还未解决范围。
- 提问有严格门槛：只有缺失信息会实质改变答案且无法从请求或证据解决时才提问。
- 不授权维护仓库记忆；产出解释不代表获得该权限。
- 发布属于独立动作，且需确认；发布与“已解释主题”不是同一条件。
- 产物路径与配置解析有明确规定：docs_root 只从 <repo-root>/.compound-engineering/config.yaml 读取，不从 config.local.yaml 读取；未设置时 <root> 为 docs；配置值不合法时以命名 docs_root 及其值的错误停止，绝不回退到 docs。
- 资料未提供收费、价格、平台与效果的说明。