用途：为 AI 智能体会话生成完整交接文档，使新智能体能在无歧义的情况下继续工作，缓解长时运行智能体的上下文耗尽问题。
主要能力：分 CREATE（创建）与 RESUME（恢复）两种工作流；CREATE 使用脚本生成带时间戳、项目路径、git 分支、近期提交与修改文件预填的脚手架，填写 [TODO] 后校验；RESUME 列出可用交接文档、检查过期情况、完整读取后再行动。支持交接链式衔接（--continues-from）。
必要用法： 创建：python ~/.agents/skills/session-handoff/scripts/create_handoff.py [task-slug]，从目标项目目录运行；延续用 python ~/.agents/skills/session-handoff/scripts/create_handoff.py "auth-part-2" --continues-from 2024-01-15-auth.md 校验：python ~/.agents/skills/session-handoff/scripts/validate_handoff.py <handoff-file> 恢复列表：ls -t .claude/handoffs/*.md 检查过期：git log --oneline -- .；git status --short；git branch --show-current
适用场景：需要暂停、保存状态、上下文中将耗尽或继续前序工作时。
限制：校验器在发现密钥、残留 [TODO] 占位符或缺少必需章节时返回 BLOCKED 并非零退出，此时不应定稿；其余为警告。交接文档存于 .claude/handoffs/，命名 YYYY-MM-DD-HHMMSS-[slug].md。恢复前须核对分支、提交与假设是否仍成立，过期交接视为线索而非事实。其他平台细节与收费情况暂未提供。