Codex 项目交接 Prompt：在线程切换前整理标准交接资料

为什么它值得单独存在

很多项目不是死在“做不出来”，而是死在“下一轮接不上”。工程说明书负责告诉 Codex 这个项目要做什么，但当任务做了一半、文件已经动过、风险已经出现、验证做了一部分时，下一轮真正缺的往往不是目标，而是当前状态。

如果这一步没做，后续 Thread Handoff、Record & Replay 或人工接手都会变得很脆弱。因为对方看到的是代码和线程，不一定能立刻看到你已经确认过什么、还有什么没做、哪里最容易踩坑。

使用说明

更稳的做法是先准备好几个输入：项目目标、当前轮次已完成项、关键文件路径、验证结果、待确认风险、下一步动作，以及是否已经有工程说明书或 AGENTS.md。这样输出才能直接变成 handoff 文档，而不只是聊天摘要。

推荐 Prompt 模板

请基于下面这个 Codex 项目当前状态，帮我整理成一份标准项目交接资料，供下一轮线程、下一台机器或下一位执行者继续接手。

项目名称：
- [项目名]

项目目标：
- [这个项目最终要完成什么]

当前轮次已完成：
- [已完成动作]

当前未完成：
- [剩余动作]

关键文件与路径：
- [文件路径 + 为什么重要]

已经验证过的结果：
- [构建、页面、接口、部署、审计、截图、命令等]

已知风险与阻塞：
- [问题、影响范围、是否需要额外确认]

下一步最推荐动作：
- [下一轮最应该先做什么]

已有文档：
- [工程说明书 / handoff / AGENTS.md / checklist / 报告路径]

请输出：
1. 项目背景与目标
2. 当前完成状态
3. 关键文件与入口路径
4. 已验证结果
5. 风险与注意事项
6. 下一步建议
7. 如果适合，请补一段可以直接贴到 handoff Markdown 的简短摘要

这份交接资料至少要覆盖什么

• 不要只写“改了首页”，要写清楚具体页面、路径、模块和修改目的。
• 不要只写“测试过了”，要写清楚测了什么、用什么命令测、结果是什么。
• 不要只写“还差一点”，要写出下一轮第一个动作应该是什么。
• 如果有线上、远端或权限约束，要把实际可复用命令和限制一起带上。
• 如果某些事实还没确认，要显式标为待验证，而不是混成已完成。

FAQ

• Q：这个 Prompt 最适合什么时候用？
  A：最适合在线程切换、换机器、换环境、暂停工作、交给下一轮 Codex 或交给人继续接手之前使用。
• Q：它和工程说明书是什么关系？
  A：工程说明书负责定义项目目标和边界，项目交接 Prompt 负责整理当前执行状态、已完成项、风险、证据和下一步动作。
• Q：它能替代 Thread Handoff 吗？
  A：不能。Thread Handoff 负责转移线程和 Git 状态，这个 Prompt 负责把当前项目整理成容易继续接手的交接资料。

相关教程

相关 Blog

相关 Prompt

相关专题