Claude Code 会话交接模板：把上下文留给下一个人或下一个 Agent

Claude Code 能被交接时，才适合长期使用

很多失败不是模型不会写代码，而是下一次会话不知道上次改到哪里。handoff note 的作用，是让下一位操作者或明天的自己能安全继续。

这篇文章连接 第一次任务运行手册 和 bug report 模板。

可复制的 handoff 模板

# Claude Code Handoff

## Goal
- 今天要完成:
- 今天不做:

## Current state
- branch:
- last commit:
- dirty files:
- 相关 URL:

## What changed
- 修改内容:
- 触碰文件:
- 意图:

## Verification
- 运行的命令:
- 结果:
- 目视确认:

## Risks
- 容易坏的地方:
- 不要触碰:
- 未确认:

## Next prompt
下一次会话先执行 git status，阅读最近 diff，
确认它和这份 handoff 没有矛盾后再开始。

好例子

## Goal
- 从 /en/products/ 添加到 5/25 三篇文章的内部链接
- 今天不改价格表结构

## Verification
- npm.cmd run build: 成功
- production /en/products/: 200
- mobile 390px: 没有横向溢出

## Risks
- Gumroad link 以英文版为主
- 非英文正文需要在公开 URL 再确认

常见漏项

• 只写 build 成功，不写公开 URL 检查
• dirty files 没说明就交接
• 把未确认写成“大概没问题”
• 没留下下一次要用的 prompt

handoff 不是长日记。它只需要让下一次会话在5分钟内安全启动。

下一步

个人使用请先用 免费 cheatsheet 固定检查步骤。团队标准化可以组合 Setup Guide 和 Prompt Templates。需要导入设计时请看 导入咨询。

handoff 要比 commit message 详细，比工作日记短

handoff note 是让下一次会话安全继续的运行数据。commit message 通常缺少验证和风险，工作日记又太长。你需要留下当前状态、修改原因、验证结果、危险区域和下一条 prompt。

请 review 这份 handoff：
1. 是否和 git status 矛盾
2. 修改原因是否能用一句话说明
3. build 和公开 URL 检查是否分开记录
4. 未确认风险是否被明确写出
5. 下一条 prompt 是否足够重新开始

多语言站点尤其需要写清楚公开 URL、语言、移动端宽度和 CTA 状态。build 通过并不代表用户看到的页面正确。