创建全面的交接文档，使新AI代理能够无缝继续工作，消除歧义。解决上下文耗尽问题。 时机：(1)用户请求保存交接，(2)上下文即将满，(3)主要任务完成，(4)会话结束，(5)恢复工作时。 关键词：保存状态、创建交接、上下文已满、暂停、从...恢复、加载交接、保存进度、会话转移、交接
会话 Handoff
功能概述
会话 Handoff是一项面向实际任务的技能，主要用于创建让新代理能够无缝继续工作的交接文档；用户想要保存状态, 暂停工作, 或者上下文是满的；
核心要点
- @ info。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
使用与执行
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
结果检查与注意事项
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
会话交接
创建交接文档，使新代理能够无缝延续工作。
模式选择
是否要创建交接文档？ 用户希望保存当前状态、暂停工作，或上下文已满。 → 执行 CREATE 流程
是否要从交接文档恢复？ 用户希望继续之前的工作或加载上下文。 → 执行 RESUME 流程
是否需主动建议？ 在完成大量工作后（例如：修改 5+ 个文件、复杂调试、关键决策）：
“建议创建一份交接文档以保留当前上下文。准备就绪时，请说 ‘create handoff’。”
CREATE 流程
第 1 步：生成脚手架
运行智能脚手架脚本：
python scripts/create_handoff.py [task-slug]
如为延续性交接（需关联先前工作）：
python scripts/create_handoff.py "auth-part-2" --continues-from 2024-01-15-auth.md
该脚本将创建 .claude/handoffs/ 目录，并生成一个带时间戳的文件，其中预填充了元数据（时间戳、项目路径、Git 分支、最近提交记录、已修改文件列表）。
第 2 步：完善文档内容
打开生成的文件，补全所有 [TODO: ...] 占位内容。优先填写以下部分：
- 当前状态摘要 —— 当前正在发生什么
- 重要上下文 —— 下一位代理必须了解的关键信息
- 下一步待办事项 —— 明确、可执行的首个动作
- 已做决策 —— 包含依据的决策说明（不仅列出结果）
完整结构请参阅 references/handoff-template.md。
第 3 步：验证文档
python scripts/validate_handoff.py
校验项包括：
- 无残留的
[TODO: ...]占位符 - 必需章节均已存在且已填写内容
- 未检测到潜在敏感信息（如 API keys、密码、tokens）
- 所引用的文件均真实存在
- 质量评分（0–100 分）
若检测到敏感信息，或质量评分低于 70 分，则不得完成交接文档。
第 4 步：确认并反馈
向用户汇报以下信息：
- 交接文档所在路径
- 验证得分及警告信息
- 已捕获上下文的简要总结
- 下一阶段的首个行动项
RESUME 流程
第 1 步：查找可用交接文档
python scripts/list_handoffs.py
第 2 步：检查时效性
python scripts/check_staleness.py
时效性等级说明：
- FRESH：可安全恢复
- SLIGHTLY_STALE：恢复前需先审阅变更
- STALE：需谨慎核验上下文一致性
- VERY_STALE：建议新建交接文档
第 3 步：加载并核实
完整阅读交接文档；若属于交接链中的一环，还需一并阅读前序交接文档。
参照 references/resume-checklist.md 执行核验：
- 确认项目目录与 Git 分支匹配
- 检查阻塞问题是否已解决
- 验证原有假设是否仍成立
- 审查已修改文件是否存在冲突
第 4 步：启动工作
从 “Immediate Next Steps” 中的第一项开始执行。
工作过程中可随时参考以下内容：
- “Critical Files”：关键文件位置
- “Key Patterns Discovered”：已识别的重要约定
- “Potential Gotchas”：需规避的已知风险点
交接链（Handoff Chaining）
针对长期运行的项目，可通过链接多个交接文档来维持上下文的连续性：
handoff-1.md （初始工作）
↓
handoff-2.md --continues-from handoff-1.md
↓
handoff-3.md --continues-from handoff-2.md
从交接链中恢复时，应首先阅读最新一份交接文档，再按需回溯查阅其前序文档。
存储位置
位置：.claude/handoffs/
命名格式：YYYY-MM-DD-HHMMSS-[slug].md
质量标准
高质量的交接文档具备以下特征：
- 对当前状态的描述零歧义
- 下一步待办事项清晰、编号明确
- 关键决策附有合理依据（不只罗列结果）
- 必要时提供带行号的文件路径
- 不含任何敏感信息或凭据
严禁行为（NEVER）
- 在交接文档中包含 API keys、密码、tokens 或其他凭据
- 在最终版交接文档中遗留
TODO占位符 - 跳过验证步骤
- 创建不含 “Important Context” 章节的交接文档
- 对质量评分低于 70 分的交接文档执行最终化操作
热门AI工具
相关专题
session失效通常是由于 session 的生存时间过期或者服务器关闭导致的。其解决办法：1、延长session的生存时间；2、使用持久化存储；3、使用cookie；4、异步更新session；5、使用会话管理中间件。
856
2023.10.18
session失效的原因有会话超时、会话数量限制、会话完整性检查、服务器重启、浏览器或设备问题等等。详细介绍：1、会话超时：服务器为Session设置了一个默认的超时时间，当用户在一段时间内没有与服务器交互时，Session将自动失效；2、会话数量限制：服务器为每个用户的Session数量设置了一个限制，当用户创建的Session数量超过这个限制时，最新的会覆盖最早的等等。
560
2023.10.17
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
0
2026.10.22
热门下载
相关下载
精品课程
