codex-handoff

Codex Handoff

前置条件

• 明确调用即表示用户批准了一项任务。参数用于确定任务重点；否则，根据已验证的上下文恢复当前目标。
• 必须提供 list_projects 和 create_thread。如果不可用，请停止；不要用 shell 命令或 Markdown 文件替代。

构建连续性提示词

编写一份独立完整的提示词，约 2,000–4,000 个中文字或同等篇幅。如果链接中包含详细信息，优先缩短内容。包括：

• 目标和第一步操作；
• 已完成的工作和当前状态；
• 决策、约束以及被否决的重要备选方案；
• 权威文件、计划、问题、提交、差异或 URL；
• 已执行的验证和观察到的失败；
• 剩余工作、阻碍因素、脆弱状态和临时路径；
• 相关的已安装 Skills。

请指向权威材料，而不是复述其内容。省略对话记录、大型差异或状态输出、重复的推理、机密、凭据和无关的个人信息。将临时路径标记为脆弱。结尾写上：阅读当前有效指令，验证当前状态，并立即开始第一步操作。

创建新任务

1. 使用 list_projects 确认当前已保存的项目；遵守项目和主机环境规则。切勿猜测其他项目或默默退回到无项目状态。如果目标未包含重要的未提交状态，请停止并说明风险。
2. 使用精简提示词调用 create_thread。除非明确要求，否则省略模型和推理覆盖项。
3. 如果返回 threadId 且状态为 ready，请使用 set_thread_title 设置标题，并执行一次有界的 wait_threads 快照；不要等待任务完成。如果只返回 clientThreadId，请说明设置已排队，而非正在运行。
4. 返回一行摘要和已创建任务的指令。仅声明返回状态所能确认的内容。
5. 停止在旧任务中的工作。保留其作为历史记录；不要归档，也不要继续编辑共享工作区。

排除事项

• 不要使用 fork_thread；复制完整历史会破坏上下文重置。
• 不要启动子 Agent；委派并非用户拥有的续接任务。
• 不要使用 handoff_thread；它会转移其他任务的 Git 环境。
• 不要创建或恢复交接文档；这是以文件为中心的工作流。
• 不要因普通的继续当前任务请求而触发。

使用 evals/trigger_cases.json 维护手动触发边界，并使用 evals/output/cases.jsonl 维护连续性行为。