session-handoff

# 交接 (Handoff) 创建全面的交接文档，使新的 AI 智能体能够无缝地继续工作，且零歧义。解决了长期运行的智能体上下文耗尽问题。 ## 模式选择 确定适用哪种模式： **正在创建交接？** 用户想要保存当前状态、暂停工作或上下文快满了。 - 遵循：下方的 CREATE 工作流 **从交接中恢复？** 用户想要继续之前的工作、加载上下文或提到了现有的交接记录。 - 遵循：下方的 RESUME 工作流 **主动建议？** 在大量工作后（5 次以上文件编辑、复杂调试、重大决策），建议： > “我们已经取得了重大进展。考虑创建一个交接文档，以便为未来的会话保留此上下文。准备好后请说‘创建交接’。” ## CREATE 工作流 ### 第 1 步：生成脚手架 运行智能脚手架脚本以创建预填充的交接文档： bash python scripts/create_handoff.py [task-slug] 示例：`python scripts/create_handoff.py implementing-user-auth` **对于连续交接**（链接到之前的工作）： bash python scripts/create_handoff.py "auth-part-2" --continues-from 2024-01-15-auth.md 脚本将： - 在需要时创建 `.claude/handoffs/` 目录 - 生成带时间戳的文件名 - 预填充：时间戳、项目路径、git 分支、最近的提交、修改的文件 - 如果从之前的工作继续，添加交接链链接 - 输出用于编辑的文件路径 ### 第 2 步：完成交接文档 打开生成的文件并填写所有 `[TODO: ...]` 部分。优先处理这些部分： 1. **当前状态摘要** - 现在正在发生什么 2. **重要上下文** - 下一个智能体必须知道的关键信息 3. **立即执行的下一步** - 清晰、可操作的第一步 4. **已做出的决策** - 带有基本原理的选择（不仅仅是结果） 使用 [references/handoff-template.md](references/handoff-template.md) 中的模板结构作为指导。 ### 第 3 步：验证交接 运行验证脚本以检查完整性和安全性： bash python scripts/validate_handoff.py 验证器检查： - [ ] 没有剩余的 `[TODO: ...]` 占位符 - [ ] 必需的部分存在且已填充 - [ ] 未检测到潜在的机密信息（API 密钥、密码、令牌） - [ ] 引用的文件存在 - [ ] 质量评分 (0-100) **如果检测到机密信息或评分低于 70，请勿完成交接。** ### 第 4 步：确认交接 向用户报告： - 交接文件位置 - 验证评分