name: session-handoff
display_name: 会话交接台
version: 1.3.0
license: MIT-0
author: 小浣熊肖恩
description: |
结构化交接文档生成器 + 跨平台搬运工具。
把决策链、当前状态、未完成事项写成一份可复用的交接文档，
配套启动提示词，让新工作区或新平台的对话 30 秒接续上一段工作。
10 个平台适配，8 份场景案例，64 项自检清单。
tags:
- 对话管理
- 上下文持久化
- 项目交接
- 跨平台搬运
- 工作流
- 决策链记录

权限声明：如实列出本包脚本的写入行为，供宿主审核。逐条对应 scripts/ 下脚本的实际代码。

network/execute 刻意为空数组：本包脚本不联网、不调外部命令，这是实测结论。

permissions:
write:
- "scripts/sanitize.py --in-place" # 就地写回，默认先备份 <文件>.bak
- "scripts/task-ledger.py" # 落盘 .handoff/ledger.json（--root 可改）
- "scripts/install.sh" # 建安装目录并 cp 脚本
- "scripts/impact_manifest.py" # 写 docs/impact-manifest.md
read:
- "references/checklist.md"
- "references/platform-matrix.md"
- "templates/handoff-template.md"
network: []
execute: []

外部依赖清单（外部 URL 逐条列明）。

本包零运行时第三方依赖：不联网、不调外部 API。下列 8 条是文档正文真实引用的

外部链接（规范 2 + README 徽章 6），列出仅为可追溯。

刻意不列入的三类（并非遗漏，它们本就不该出现在声明区）：

1. 脱敏正样本里的假端点与假密钥（见 references/privacy-rules.md 第 6 节）：

形似真密钥的字符串放进声明区，会被平台安全扫描判为「疑似密钥泄露」；

2. RFC 2606 保留域名 .example：该域名的语义就是「此处没有真实站点」，

写进依赖声明自相矛盾；3. 平台名或产品名的示意性写法。

三者都是正文里的教学示例，不是本包要访问的地址。

urls:
- "https://keepachangelog.com/zh-CN/1.0.0/"
- "https://semver.org/lang/zh-CN/"
- "https://img.shields.io/badge/License-MIT--0-blue.svg"
- "https://img.shields.io/badge/version-1.3.0-brightgreen.svg"
- "https://img.shields.io/badge/platforms-10-orange.svg"
- "https://img.shields.io/badge/中文-原生-red.svg"
- "https://img.shields.io/badge/version-1.3.0-green.svg"
- "https://img.shields.io/badge/lang-中文-red.svg"
triggers:
- 开个支线
- 分叉
- 交接
- session handoff
- branch this session
- handoff context
- 新对话但保留上下文
- 把当前会话存档
- 导出交接
- 换工作区
- 换平台接续
category: Prompts
platforms:
- 宿主平台
- 通义千问
- 豆包
- Kimi
- 文心一言
- 讯飞星火
- 智谱 ChatGLM
- 扣子
- 办公小浣熊
- 悟空

会话交接台 (Session Handoff)

> 上一段聊到哪、决定了什么、下一步做什么，一份文档带走，新对话 30 秒接续。

一、定位

结构化交接文档生成器 + 跨平台搬运工具。

输入是决策链、当前状态与未完成事项，输出是一份可复用的 handoff.md
加一段启动提示词。产物落在文件里，因此可带到任何工作区、任何平台。

二、能力边界

• 同工作区不主动触发：上下文接续交给宿主原生 memory
• 仅三类场景触发：跨工作区、跨平台、对外交付，三者之一成立才生成
• 历史检索分工：历史对话检索交给原生工具，本技能只做结构化交接

触发信号

不触发：同工作区内继续聊、闲聊与咨询、对话轮次少于 5 轮。
拒答话术与灰区裁决见 references/refusal-and-gray-zone.md。

主动建议

三个条件同时满足时温和建议一次，用户拒绝后本次会话不再建议：工作型对话、已完成里程碑、用户未拒绝过。每段对话最多 1 次，用「建议」而非「应该」。

三、SOP：6 步标准流程

Step 6 四道扫描

bash scripts/validate-handoff.sh <handoff.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/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。

七、失败模式与处理

八、参考

v1.3.0 · MIT-0 · 作者 小浣熊肖恩 · 贡献见 CONTRIBUTING.md ·
变更见 CHANGELOG.md