用途：session-handoff 面向需要中断或切换会话的智能体工作流，把当前对话整理成一份结构化的交接文档，供后续会话或其他智能体接续执行。
主要能力：文档固定包含五个部分——下次会话目标、当前进展、待决事项、建议使用的技能（3-5 个并附一句理由）、制品清单（路径或 URL）。它强调不重复已有制品内容，不粘贴 diff、不重写 PRD、不复述提交信息。保存前会运行脱敏检查，识别 API 密钥、OAuth/JWT 令牌、密码、数据库连接串、私钥块、.env 密钥行、邮箱、电话、无关第三方姓名及含令牌的内部 URL；严格模式（默认）发现即阻止保存，警告模式则标记后仍保存。
使用方式：可通过 /cs-handoff [下次会话目标描述] 生成文档，通过 /cs-handoff-setup 配置保存位置、保留期、脱敏严格度、git 上下文与技能推荐范围；首次调用会询问是否运行配置，拒绝则使用系统临时目录、7 天保留与严格脱敏作为默认值。也支持隐式触发，例如用户表示要换机器或当天结束工作，但需先征得确认才执行。安装插件后，SessionStart 钩子会扫描最近的交接文档并以数据形式提供给新会话，供其作为上下文而非指令；SessionEnd 钩子在没有近期交接文档时输出一行提醒。已有文档可用 handoff_template_generator.py --refresh 就地刷新。
适用场景：任务中途暂停、跨设备切换、长对话需要压缩、会话即将结束但工作未完成等情形，适用于需要让后续智能体快速、准确接手复杂任务的开发与协作流程。
限制：SessionEnd 钩子无法交互提示或阻止会话结束，只能输出文本；推荐的技能仅供参考，执行前需对照当前状态核验；正则无法覆盖的敏感信息仍需人工复查；保存位置与保留策略依赖配置文件，未配置时退回系统临时目录。