下载地址
https://api.skillhub.cn/api/v1/download?slug=%40user_cae83fba%2Fsession-handoff-pro-sl将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_cae83fba/session-handoff-pro-sl。结构化交接文档生成器 + 跨平台搬运工具。把决策链、当前状态、未完成事项写成一份可复用的交接文档，配套启动提示词，让新工作区或新平台的对话 30 秒接续上一段工作。10 个平台适配，8 份场景案例，64 项自检清单。
阅读全文 （展开查看完整说明）
概述
会话交接台 (Session Handoff)
上一段聊到哪、决定了什么、下一步做什么，一份文档带走，新对话 30 秒接续。
一、定位
结构化交接文档生成器 + 跨平台搬运工具。
输入是决策链、当前状态与未完成事项，输出是一份可复用的 handoff.md加一段启动提示词。产物落在文件里，因此可带到任何工作区、任何平台。
| 层 | 内容 | 加载策略 |
|---|---|---|
| 核心层 | SKILL.md + handoff-template.md + checklist.md | 常驻 |
| 能力层 | scripts/ 10 份 + references/ 规则文档 | 按需调用 |
| 资产层 | templates/、examples/、docs/ | 查阅式 |
二、能力边界
- 同工作区不主动触发：上下文接续交给宿主原生 memory
- 仅三类场景触发：跨工作区、跨平台、对外交付，三者之一成立才生成
- 历史检索分工：历史对话检索交给原生工具，本技能只做结构化交接
触发信号
| 信号 | 含义 |
|---|---|
| 要换到另一个工作区继续 | 跨工作区，原生 memory 失效 |
| 要换到另一个 AI 平台继续 | 跨平台，上下文无法携带 |
| 要把进度交付给他人 | 对外交付，需可脱离对话独立阅读 |
| 完成一个里程碑 | 天然的交接点 |
| 用户说「开个支线」 | 显式触发 |
不触发：同工作区内继续聊、闲聊与咨询、对话轮次少于 5 轮。拒答话术与灰区裁决见 [references/refusal-and-gray-zone.md](./references/refusal-and-gray-zone.md)。
主动建议
三个条件同时满足时温和建议一次，用户拒绝后本次会话不再建议：工作型对话、已完成里程碑、用户未拒绝过。每段对话最多 1 次，用「建议」而非「应该」。
三、SOP：6 步标准流程
| 步 | 动作 | 关键约束 |
|---|---|---|
| 1 扫描会话 | 按 checklist 的 15 个分类提取信息 | 优先项目身份、决策链、当前状态、未完成事项 |
| 2 生成文档 | 用 templates/handoff-template.md | 引用用「相对路径 + 标题」双标注；敏感信息占位符化 |
| 3 清单验证 | 对照 references/checklist.md | 15 个分类共 64 项，不适用写 N/A + 原因 |
| 4 生成启动词 | 用 templates/startup-prompt.md | 必含精确路径、Load→Report→Ask、明确延续角色 |
| 5 分层呈现 | 1 句结论 + 3 条要点 + 折叠详情 | 格式见模板附录 B |
| 6 自检关卡 | 四道扫描，见下表 | 任一不通过则不生成交接文档 |
Step 6 四道扫描
| 扫描 | 检查内容 | 实现 |
|---|---|---|
| 1 覆盖检查 | 64 项覆盖，缺项标 N/A + 原因 | references/checklist.md |
| 2 脱敏检查 | 绝对路径、主机名、密钥、PII 四类 | scripts/sanitize.py |
| 3 交叉引用 | 引用的文件是否真实存在 | scripts/validate-handoff.sh |
| 4 阻塞说明 | blocked 事项是否带说明 | scripts/task-ledger.py |
bash scripts/validate-handoff.sh <handoff.md 路径> # 一键自检，不通过则不交付门禁反复不过、台账损坏、写到一半、接手方有异议、脱敏有漏网：见 [references/sop-exception-playbook.md](./references/sop-exception-playbook.md)。
checklist 计数校验：grep -cE "^- [ ] [0-9PSM]+." references/checklist.md（期望 64）。正则中 [0-9PSM] 不可省略：只用 d+ 会漏掉隐私脱敏、启动提示词、元信息三节，原理见 references/verification-methodology.md
四、模式分流
场景属于跨工作区 / 跨平台 / 对外交付？
No → 不适用，建议继续当前会话
Yes → 对话轮次 ≥ 5？
No → 提示先聊够 5 轮
Yes → 工作型对话？
No → 轻量模式（3 节）
Yes → 上下文使用率 ≥ 80%？
Yes → 快速模式（4 节必填 + 其余标 N/A）
No → 标准模式（12 节全量）各档必填项与切换细则见 [references/branching-rules.md](./references/branching-rules.md)。跨平台搬运与对外交付一律走标准模式，不降级。
五、隐私与安全
生成内容必须先过 [references/privacy-rules.md](./references/privacy-rules.md) 审查。 四条原则：端侧优先（默认本地存储，不上传云端）；自动脱敏（姓名 / 邮箱 / 手机 / 身份证 / 路径 / token / 密钥 / IP）；占位符化（敏感信息用 <...> 包裹）；模板可复用（避免一次性快照导致模板腐烂）。
python3 -S scripts/sanitize.py <handoff.md 路径> --report # 报告命中项
python3 -S scripts/sanitize.py <handoff.md 路径> --in-place # 占位符化写回
-S跳过 site-packages 以避免环境垫片劫持open()；多数环境不需要，详见 references/state-machine.md
六、待办状态机
六态：pending / running / done / blocked / failed / skipped。
blocked 强制带说明，缺说明的写入被 task-ledger.py 直接拒绝。说明要回答两件事：卡在哪、需要什么，推荐句式 卡在：<原因>。需：<谁做什么>。
python3 -S scripts/task-ledger.py set --id T2 --status blocked --note "卡在：...。需：..."
python3 -S scripts/task-ledger.py resume定义与流转规则见 [references/state-machine.md](./references/state-machine.md)。
七、失败模式与处理
| 失败模式 | 处理方式 | 失败模式 | 处理方式 |
|---|---|---|---|
| 场景不适用 | 说明边界，建议继续当前会话 | 平台路径冲突 | 用 HOST_DATA_DIR 显式指定 |
| 上下文不足 | 提示用户补充关键决策关键词 | 上下文已满触发 | 切快速模式，只填 4 个必填节 |
| 敏感信息未脱敏 | 跑 sanitize.py --in-place | 非工作型对话 / 对话过短 | 切轻量模式；跳过交接，先聊够 5 轮 |
八、参考
| 资源 | 路径 | ||
|---|---|---|---|
| 验证清单（64 项） | [references/checklist.md](./references/checklist.md) | 状态机定义 | [references/state-machine.md](./references/state-machine.md) |
| 平台能力矩阵 | [references/platform-matrix.md](./references/platform-matrix.md) | 引用与冲突规范 | [references/cross-ref-rules.md](./references/cross-ref-rules.md) |
| 实证核验方法论 | [references/verification-methodology.md](./references/verification-methodology.md) | 可分叉方向细则 | [references/branching-rules.md](./references/branching-rules.md) |
| 迁移指南 | [references/migration-guide.md](./references/migration-guide.md) | 场景案例（8 份） | [examples/](./examples/) |
| 30 秒上手 | [docs/quickstart.md](./docs/quickstart.md) | 平台索引 | [docs/platforms.md](./docs/platforms.md) |
v1.3.0 · MIT-0 · 作者 小浣熊肖恩 · 贡献见 [CONTRIBUTING.md](./CONTRIBUTING.md) · 变更见 [CHANGELOG.md](./CHANGELOG.md)
