实战:任务交接总结
任务结束时,让 CC 生成交接总结。它能帮助下一个人知道改了什么、为什么改、怎么验证、还有什么风险。
交接模板
交接总结不是形式主义。它的作用是让下一个人不用重新问“你到底改了什么、为什么这么改、现在卡在哪里”。
请生成本次任务交接总结。 请按下面格式输出: ## 任务目标 - 原始目标: - 最终完成情况: ## 修改内容 - 修改文件: - 每个文件改了什么: - 为什么要改: ## 验收结果 - 已执行检查: - 通过项: - 失败项: - 未检查项及原因: ## 风险和后续 - 剩余风险: - 需要人工确认: - 建议下一步:
什么时候必须写交接
- 任务跨天。
- 多人协作。
- 修改超过 3 个文件。
- 涉及接口、权限、数据、发布。
- 上下文很长,准备开新会话继续。
- 当前任务没有完全完成。
即使只有一个人开发,只要准备离开一段时间,也建议写交接。很多问题不是今天看不懂,而是明天回来忘了“为什么当时这么判断”。
交接分几种
| 类型 | 适合场景 | 重点 |
|---|---|---|
| 新会话交接 | 上下文太长、准备重开 | 当前状态、下一步最小动作 |
| 同事交接 | 多人协作、转给别人 | 业务目标、技术改动、风险 |
| 发布交接 | 准备上线或交给运维 | 环境、配置、回滚、监控 |
| 自己备忘 | 暂停任务、稍后继续 | 做到哪一步、别重复排查什么 |
交接对象不同,内容深度也不同:
| 对象 | 不需要写太多 | 必须写清楚 |
|---|---|---|
| 新会话 | 聊天过程 | 当前文件状态和下一步 |
| 同事 | 每次对话细节 | 业务目标和风险 |
| 发布负责人 | 代码实现细节 | 环境、配置、回滚 |
| 未来自己 | 完整背景故事 | 下次先检查什么 |
好交接应该包含什么
- 原始目标:一开始要做什么。
- 当前状态:完成、部分完成、未完成。
- 修改范围:改了哪些文件和模块。
- 关键决策:为什么选这个方案。
- 验收证据:跑了什么检查,结果如何。
- 未完成事项:下一步该做什么。
- 风险和注意事项:哪里不能乱碰。
不好的交接通常长这样:
- “已经差不多好了。”
- “剩下你看着处理。”
- “改了一些文件。”
- “应该没问题。”
这些话没有给下一位接手者任何可操作信息。
交接要区分事实和建议
请把交接内容分成三类: 1. 已确认事实。 2. 未验证风险。 3. 建议下一步。 不要把建议写成已经完成的事实。
跨会话继续时怎么用
请生成一个“新会话继续任务”的交接提示词。 要求: 1. 用新会话可以直接复制的格式。 2. 包含任务目标、已完成内容、当前文件、验收结果、剩余风险。 3. 明确下一步应该先只读确认,不要直接修改。 4. 标记哪些结论来自已完成工作,哪些还需要重新验证。
给下一位同事的版本
请生成给同事看的交接总结。 要求: 1. 不要写聊天过程废话。 2. 按业务目标、技术改动、验证结果、风险、下一步组织。 3. 文件名和功能点要写清楚。 4. 如果有未完成事项,请按优先级排序。 5. 如果有人工确认项,请明确负责人或角色。
给发布负责人的版本
请生成给发布负责人的交接总结。 要求: 1. 本次要发布的功能或修复。 2. 涉及的配置、环境变量、数据库或权限变更。 3. 已完成的测试、构建和人工验收。 4. 发布前必须确认的事项。 5. 回滚方案和不可回滚风险。 6. 发布后需要观察的页面、接口或日志。
给未来自己的版本
请生成一份简短备忘。 要求: 1. 100 到 200 字。 2. 写清楚当前做到哪一步。 3. 下一次回来先检查什么。 4. 哪些地方不要重复排查。 5. 哪些地方还不确定。
交接后不要继续扩展
交接总结通常代表一个阶段结束。生成交接后,不要让 CC 顺手继续改代码,除非明确开启下一个小任务。
交接总结已完成。 请暂停开发动作。 不要继续修改文件。 如果要进入下一步,请先给出新的任务计划。
交接常见问题
- 只写“完成了”,没有写怎么验证。
- 只写文件列表,没有写为什么改。
- 把未验证风险写成“应该没问题”。
- 没有下一步最小动作。
- 新会话接手后没有重新只读确认。
交接质量自检
请检查这份交接总结是否合格。 检查: 1. 新接手的人能否知道任务目标。 2. 能否知道改了哪些文件。 3. 能否知道为什么这样改。 4. 能否知道已经验证了什么。 5. 能否知道还没验证什么。 6. 能否直接执行下一步最小动作。 7. 是否包含不必要的聊天过程废话。
交接后怎么继续
接手交接后,不要马上执行下一步。先复查:
我将根据这份交接继续任务。 请先只读确认: 1. 当前文件状态是否和交接一致。 2. 已完成内容是否真的存在。 3. 未验证风险是否仍然存在。 4. 下一步是否仍然是最小动作。 5. 如果交接和当前状态不一致,请先指出,不要修改文件。
交接是起点,不是免检通行证。
验收结果
- 交接能说明目标、改动、验证和风险。
- 下一位接手的人不用重新猜上下文。
- 未完成事项明确。
- 新会话可以直接接上任务。
- 交接版本能根据对象区分:新会话、同事、发布、自己备忘。