| name | cce-provider-handoff |
| description | Use when continuing a Codex task after switching providers, accounts, sessions, or agents and a cce handoff package may be needed |
CCE Provider Handoff
Overview
Provider 切换后，不要只依赖当前对话记忆。优先使用 cce handoff 接续包，把“真实模型可见上下文”和“可追溯的完整历史”分开读。
第一轮 turn 的目标是恢复状态，不是继续施工。除非用户明确要求立刻执行，否则第一轮只读取 handoff 文档、必要源码和回查材料，最后输出接续理解、当前任务状态、风险点和下一步计划；不要写文件、改文件、提交、push，或执行会改变项目状态的命令。
When To Use
- 用户给了
cce handoff 接续包目录
- 用户给了
context-timeline.md、context-events.md、history-default.md、history-timeline.md、history-events.md、source.jsonl
- 用户要求切换 provider、账号、模型服务商后继续一个 Codex 长任务
- agent 需要自己从本机 Codex 历史里导出可接续材料
已有接续包
- 先读包内
README.md，确认源会话、项目目录和阅读顺序。
- 再读
context-timeline.md，先建立当前任务骨架。
- 必须读
context-events.md，这是当前真实模型可见上下文的详细版，包含 context 内的命令输出、工具输出和 diff 细节。
- 如果还需要了解更早对话背景，先读
history-default.md，不要默认读 history-timeline.md。
- 只有需要查找命令习惯、命令参数、默认配置、完整工作流索引或具体
event_ref 时，才读 history-timeline.md。
- 只有遇到具体
event_ref，或需要追查更早的命令输出、完整 diff、MCP/动态工具细节时，才读 history-events.md 或回查 source.jsonl。
- 第一轮 turn 结束时，只汇报“已经恢复到什么状态、还缺什么、下一步建议怎么做”，不要直接开始实现。
自主导出接续包
先定位会话：
cce --list --display thread
再生成接续包：
cce handoff --latest --output ./handoff
cce handoff --pick 1,3 --output ./handoff
cce handoff --input ./rollout.jsonl --output ./handoff
如果用户想人工挑选会话，也可以运行 cce tui，在 TUI 中用 h 切换到 handoff 导出类型，再多选会话并显式生成接续包。
生成接续包本身是允许的恢复动作；生成后仍按“第一轮只恢复状态”的规则阅读和汇报，不要顺手修改业务代码。
回查
看到 event_ref 后，优先用确定性脚本，不要模糊搜索：
node skills/cce-event-ref-lookup/scripts/reveal-event-ref.mjs \
--source-jsonl ./handoff/<package>/source.jsonl \
--event-ref E000123
Common Mistakes
-
第一轮 turn 直接开始改代码
provider handoff 的第一轮应先恢复上下文和对齐任务状态；实现动作留到用户确认后的后续 turn。
-
一开始全文读 history-events.md
应先读 context-timeline.md、context-events.md 和必要时的 history-default.md；history-events.md 是完整审计兜底，不是第一阅读材料。
-
把未识别工作流事件当成必读历史
cce 默认在 timeline 和 events 中隐藏未识别事件，handoff 包也沿用这个默认值。只有调试 cce 事件覆盖率时，才需要显式用 --include-unknown-events 重新导出。
-
一开始全文读 history-timeline.md
history-timeline.md 容易包含大量工具和工作流索引。除非需要查命令习惯、命令参数、默认配置或 event_ref，否则先读 history-default.md。
-
只复制 Markdown，不复制 source.jsonl
这样接续包离开原机器路径后，event_ref 回查会变脆弱。
-
把 history-timeline.md 当作当前 prompt
它是工作流索引；真正的接续主材料是 context-timeline.md 和 context-events.md，更早历史背景优先读 history-default.md。
