Session Handoff 说明文档

# 会话交接技能 ## 概述 会话交接技能创建全面的交接文档，使新的 AI 智能体能够无缝地继续工作，且零歧义。它通过在会话间保留完整的上下文、决策和状态，解决了长期运行的智能体上下文耗尽问题。 ## 目的 当与 AI 智能体进行复杂的多会话项目时，上下文会在会话间丢失。此技能提供了一种结构化的方法来： - **保留上下文** - 在上下文窗口填满前捕获所有关键信息 - **实现连续性** - 允许新智能体从你离开的地方准确接手 - **记录决策** - 记录架构选择及其基本原理 - **跟踪进度** - 保持已完成和待办工作的清晰状态 - **链接会话** - 为长期运行的项目链接相关的交接记录 ## 何时使用 ### 用户触发 - 用户说“保存状态”、“创建交接”、“我需要暂停” - 用户请求“加载交接”、“从...恢复”、“从我们离开的地方继续” - 用户提到“上下文快满了”或“保存这个以备后用” ### 智能体触发（主动） - 上下文窗口接近容量（>80% 满） - 完成了主要的任务里程碑 - 工作会话结束且进展显著 - 在大量工作后（5 次以上文件编辑、复杂调试、架构决策） - 在切换到不同任务之前 ### 恢复场景 - 在现有项目上开始新会话 - 需要不同的智能体继续工作 - 需要回顾之前会话中做出的决策 - 长时间休息后重新开始 ## 工作原理 该技能以两种主要模式运行： ### 创建模式 (CREATE) 生成捕获当前状态的综合交接文档： 1. **生成脚手架** - 智能脚本预填充元数据（时间戳、git 状态、修改的文件） 2. **完成文档** - 填写关键部分（状态、上下文、决策、下一步） 3. **验证** - 对完整性、质量和安全性进行自动检查 4. **确认** - 向用户展示位置和摘要 ### 恢复模式 (RESUME) 加载并验证现有的交接文档： 1. **查找交接** - 列出项目中可用的交接记录 2. **检查陈旧度** - 评估上下文是否仍然有效 3. **加载文档** - 读取交接记录（如果已链接则进行链式读取） 4. **验证上下文** - 验证假设和环境 5. **开始工作** - 从“立即执行的下一步”开始 ## 关键特性 ### 智能脚手架 `create_handoff.py` 脚本会自动