# New Convo Handoff

> 新对话上下文交接指令生成器（v2.0，支持跨体模式）。当用户因上下文过长/想新开对话继续某个长项目、问"新开对话怎么写 Prompt""启动指令怎么写""怎么把上下文交接给新会话"时说；也用于把工作交接给另一个智能体（跨智能体/跨体交接，如 WorkBuddy ↔ Zcode/Claude Code/Codex）。触发词包括：新开对话、新对话、上下文太长、启动指令、handoff、交接上下文、怎么写prompt给新会话、跨智能体、跨体交接、转给 Zcode、让另一个智能体接手。触发后，AI 自动扫描当前项目的关键文档（框架/PRD/设计稿/约束文件），抽取真源文件指针、隐性规则（已否决清单/口头约定/失真点）、跨文件同步规则、速查表，生成一份可直接粘贴进新对话首条消息的"启动指令" Markdown（指针式，不复制真源内容），让新会话无需复述历史对话即可承接工作；跨体模式下额外生成环境差异声明、能力边界、回交接协议与闭环钩子。基于 2026-08-27 WorkBuddy↔Zcode POC 实测验证。

- Skill: `sichenai/new-convo-handoff` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sichenai/new-convo-handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sichenai/new-convo-handoff/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: sichenai (https://skillmd.com/u/sichenai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sichenai/new-convo-handoff

---


# 新对话上下文交接指令生成器

## 何时触发

用户出现以下任意信号时启用本 skill：
- 明确说"新开对话""新对话""上下文太长/太满，开个新会话"
- 问"新开对话怎么写 Prompt""启动指令怎么写""怎么把上下文交接给新会话"
- 提到 handoff / 上下文交接 / 让另一个会话接着干
- **跨体信号（v2.0 新增）**：提到"转给 Zcode/Claude Code/Codex/另一个智能体""跨智能体/跨体交接""让 XX 工具接手这个项目"

目标：产出一份**指针式**交接指令文档（指针 + 隐性规则 + 时效自检，不复制真源内容）。**两种模式**：
- **同体模式**：粘贴到同一智能体的新对话首条消息，按指针承接工作。
- **跨体模式**：交接给另一个智能体（如 WorkBuddy ↔ Zcode）。目标智能体读指令后不仅承接任务，还继承纪律（红线/否决清单），并把执行结果按协议写回执，形成闭环。

**模式判定（Step 0）**：出现跨体信号或用户指定了目标智能体 → 跨体模式；否则同体模式。判定不了就问一句。

## 跨体模式的三条铁律（2026-08-27 POC 实测教训，违反即翻车）

1. **回执闭环必须有钩子**：光写"对方写回执"是幽灵闭环——发起方智能体没有任何机制会自动读回执。**必须在发起方的项目记忆文件（MEMORY.md 或等价物）写入钩子**：「若 outputs/ 下有 `xx_回执_*.md`，任何会话先读最新回执再继续相关工作」。POC 首版漏此钩子被对抗性审查抓为严重问题（幽灵闭环）。
2. **红线用指针不用复制，但必须设硬前提**：安全红线（不编造/来源声明/溯源纪律）若半复制半指针，两头不靠——对方跳读就漏。正确做法：指令顶部设「硬前提」节（执行任何任务前先读记忆文件全文），红线节只写一行指针。理由：复制=第二真相源会漂移，但对方环境无自动注入，必须有强制读取动作兜底。
3. **自相矛盾自检**：生成后通读全文，查「修改/同步规则」与「禁止编辑」是否打架（POC 首版让 Zcode 写 `.workbuddy/memory/`，同时声明该目录只读——修复时才抓到）。记忆写入一律收归发起方：对方只写回执，不写记忆。

## 核心原则

- **指针优先，禁止复制（2026-08-04 第一性原理重构）**：启动指令 = 指针 + 防破坏清单 + 时效自检。真源文件里已有的约束细节（色值、字号、功能清单、优先级等）**一律不复制进指令，只给文件名和章节号**——复制即产生第二真相源，产出即开始漂移。
- **启动指令的边际价值 = 真源里没写的东西**：只写三类内容——① 读哪些文件（指针）；② 隐性规则（同步规则、已否决清单、冲突裁决顺序、口头约定）；③ 时效自检。真源已覆盖的内容交还给真源。
- **不依赖对话历史**：新会话按指针读完真源 + 隐性规则清单，即等效于继承上下文。
- **单一真相来源优先**：先找到项目的总纲/框架/README，它是指针的锚点；指令本身永远不是真相来源。
- **同步规则显性化**：项目里"改 A 必须同步改 B"的隐性规矩，必须写进启动指令——这是新会话最大的破坏来源，也是本 skill 的核心价值。
- **长度上限**：正文（不含场景示例）≤60 行。指令越长遵守率越低，冷启动成本越高；超限时优先砍"看起来像是从真源抄来的"内容。
- **可粘贴即用**：输出是纯 Markdown，开头就是"复制以下内容到新对话首条消息"。

## 生成工作流

### Step 1 · 锁定项目根目录
- 默认用当前 workspace 根目录。
- 若当前对话不是项目对话（如临时闲聊），用 AskUserQuestion 确认要交接的项目路径。

### Step 2 · 盘点关键文档
用 Glob + Read 扫描，识别以下类型（按项目实际存在情况取舍）：
- **总纲/框架/需求框架**：`需求框架_*.md`、`README.md`、`ARCHITECTURE.md`、`*.framework.md`
- **详细规格**：`*PRD*.md`、`*规范*.md`、`*spec*.md`
- **设计/实现**：`设计稿*/`、`*设计*.md`、配色/Token 文件
- **裁决/审查记录**：`*交叉审查*`、`*审查报告*`、`*裁决*`
- **记忆/状态**：`.workbuddy/memory/` 下的 MEMORY.md、近期日期日志（提取已确认决策）

为每个文件写一句"用途注解"（读它能解决什么）。

**兜底规则**：若项目没有明确的"总纲/框架"文件（如空 workspace、临时对话），则退回读取 `README.md` 与 `.workbuddy/memory/MEMORY.md` 作为约束来源；两者皆无时，仅依据近期日期日志与用户口头约束生成，并在输出顶部标注"⚠️ 未找到框架文件，约束可能不完整"。

**扫描成本控制**：对超大文件（如 >50KB 的 PRD）只读关键章节（开头摘要、约束/Token 段、变更记录），不要整篇 Read，避免 token 浪费。

### Step 3 · 确定真源指针与裁决顺序（不复制约束细节）
从总纲 + 约束文件 + 近期日志中确认：
- **唯一真相来源是哪份文件**、多文件冲突时以谁为准（只写文件名 + 裁决顺序，不抄内容）
- 每个真源文件的一句话用途注解（读它能解决什么）

**只允许写入指令的"约束类"内容**（即真源里没有的隐性知识）：
- 已移除/已否决的功能清单（避免新会话复活）——若真源已明确标注则只写指针
- 口头约定、未落文档的规矩（如"PRD 禁写技术词"若未写进 PRD 模板）
- 已知的真源滞后/失真点（如"需求框架 v4 已过时，以 PRD 为准"）

**禁止写入**：色值、字号、功能清单、章节内容摘要、优先级列表——这些属于真源，只写"见 `配色方案.md`""见 PRD §3.8"。

### Step 4 · 抽取"跨文件同步规则"
识别隐性耦合，写为"改 X 必须同步改 Y"清单。例：
- 改 Token → 全局同步所有 :root 块
- 改 PRD → 同步对应设计稿
- 新增文件 → 更新索引页
- 改需求框架 → 先确认再同步各端 PRD

### Step 5 · 生成速查表
做一张表：`你想做什么 | 先读 | 再读/同步更新`，覆盖项目主要改动类型。这是新会话最高频使用的部分。

### Step 6 · 写文件命名规则（可选，但强烈建议）
若项目文件有编号/前缀体系（如 00=组件规范、08=聊天主界面），列出映射表，新会话才不会改错文件。

### Step 7 · 组装并输出

**文件命名规则**（2026-08-02 起，用户偏好）：
- 命名格式：`新对话启动指令_<项目名>_<YYYY-MM-DD>.md`，例：`新对话启动指令_WorkBuddy_2026-08-02.md`
- **跨体模式命名**：`跨体交接指令_<项目名>_<YYYY-MM-DD>.md`
- `<项目名>` 取 workspace 根目录名或项目通用简称（如 WorkBuddy、素材库），简短可读；日期为生成当天日期
- **同一天生成多版**：追加 `_v2`、`_v3` 后缀区分，例：`新对话启动指令_WorkBuddy_2026-08-02_v2.md`
- 子系统变体在日期后加用途后缀，例：`新对话启动指令_WorkBuddy_2026-08-02_改设计稿.md`
- 写入位置：项目根目录；若项目有 `outputs/` 目录则写 `outputs/` 下
- **保留旧版不覆盖**（含旧的 `新对话启动指令_vX.md` 历史文件），便于新会话对比演进

用对应模式的模板组装后写入文件，同时把全文回显给用户。

### Step 8 · 告知用法

**同体模式**：下次新开对话，把该文件内容整篇粘贴为**首条消息**，新会话会自动读文件、注入上下文，然后在"我要做的是"处填具体任务。

**跨体模式**四步：
1. 把记忆钩子写入发起方 MEMORY.md「待决问题」或等价节（见铁律 1，**这步是生成指令时同步做的，不是提醒用户做**）
2. 目标智能体打开项目，首条消息：`读 <指令文件路径>，按「我要做的是」节执行`
3. 对方完成后会在 `outputs/` 写回执 `<目标体>_回执_<日期>_<HHMM时间戳>.md`（同日多会话防覆盖——日期精确到分钟级时间戳；回执文件名带序号或时间的写法均可，唯一要求 = 能区分同日多份。实测教训：仅到日期的命名在多会话并发时会互相覆盖，2026-08-28 Zcode 实测抓出）
4. 回发起方智能体说「看回执」，由发起方验收接回（独立抽验，不只轻信回执内容）

**跨体 POC 验证任务模板**（首次交接给某个智能体时，把两组任务写入「我要做的是」节做能力验证）：
- **第 1 组 · 指针遵循**：一个只报告不修改的核对任务（如 sitemap 与文件差异比对）——验证它真去读了真源文件
- **第 2 组 · 红线触发**：一个带诱导的任务（如"把非实测数据写得更确定些"）——验证它在利诱下守不守来源纪律。⚠️ 第 2 组必须设计红线触发面，否则必然假通过（POC 首版实测方法无红线触发面，被审查抓出后才补）

## 跨体模式输出模板（v2.0，在通用模板骨架上增补以下六节）

```markdown
# 跨体交接指令（<项目名> · YYYY-MM-DD）

> **用法三选一**：① 粘贴全文到目标智能体首条消息；② 让它读本文件路径并执行时效自检；③（POC 后常规用）让它按「我要做的是」节直接执行。
>
> **时效自检**：同通用模板。
>
> **环境声明**：本指令来自 <发起方智能体>，交接目标为 <目标智能体>。双方共享同一本地文件系统（路径见下），这是交接成立的物理基础。

[通用模板的全部节：真源指针 / 裁决顺序 / 隐性规则 / 同步规则 / 速查表 / 命名规则]

## 硬前提（未完成前禁止执行任何任务）
先读 `<项目记忆文件>` 全文——特别是红线/规范节。本文不复制红线细节（避免第二真相源漂移），红线以该文件为准。

## 环境差异（发起方机制在目标体中不存在）
| 机制 | 发起方行为 | 目标体降级执行 |
|---|---|---|
| skill 体系 | <可调用的 skill> | **不可用**，相关任务回发起方执行 |
| 记忆自动注入 | 每次会话自动加载 | **不注入**，本文档即记忆载体，执行前必读记忆文件 |
| 部署/外部副作用 | <发起方策略> | 可执行但须用户口头确认 |

## 能力边界（为什么交接给目标体）
- **留给目标体**：<它擅长的，如重编码/批量改写/终端验证>
- **回发起方**：<发起方独有的，如风格写作/发布/记忆维护>

## 禁止编辑（只读，越界即事故）
- 发起方记忆系统目录（回执除外——回执只写 `outputs/`）
- 姐妹项目目录、看板、规范手册：**只读**，修改建议写进回执
- 品牌资产、已发布内容源稿

## 回交接协议（目标体完成任务后必做）
把以下内容写入 `outputs/<目标体>_回执_YYYY-MM-DD_HHMM.md`（**时间戳必带**——同一项目多会话/多日协作时防同日覆盖；发起方侧以 mtime 最新的回执为「最新回执」接回）：
1. 任务一句话
2. 新建/修改文件路径清单（逐个列）
3. 未决问题 / 需发起方或用户决策的事项
4. 已验证项（跑过的命令与结果）
写完回执后，提醒用户「回 <发起方> 报告已写回执」。

**可选增补 · 存档纪律段（模板不含，按项目实际情况由发起方生成指令时加写）**：若项目已 git 化，在回交接协议节追加：每会话改动完成、写回执前先 `git add -A && git commit -m "<一句话>"` 存档（禁 push 无远端 / 禁 revert reset 已有存档）；回执第 2 节附 commit 哈希前 7 位与 `git diff --stat` 摘要，发起方据此做内容级抽验。2026-08-28 GEO 项目已按此实践（基线 15bb6a4）。

## 我要做的是：
> 【具体任务，或首次交接时的 POC 两组验证任务】
```

**自检清单（跨体模式生成后必过，缺一重做）**：
1. 记忆钩子已写入发起方 MEMORY.md？未写 = 幽灵闭环
2. 硬前提节存在且指向记忆文件？
3. 「修改/同步规则」与「禁止编辑」有无打架？（铁律 3）
4. 有 POC 验证任务且第 2 组有红线触发面？
5. 全部指针路径 ls 校验存在（零悬空）？

## 输出模板（同体模式 · Markdown 骨架）

```markdown
# 新对话启动指令（<项目名> · YYYY-MM-DD）

> 粘贴以下内容到新对话首条消息。AI 会自动读取所有文件，然后等你交代任务。
>
> **时效自检（新会话必做）**：本指令生成于 YYYY-MM-DD。执行两项检查——① **指针悬空检查**：下方列出的真源文件是否都还存在、未改名（用 Glob 验证）——悬空即提醒用户重新生成本指令；② **隐性规则复核**：若某真源文件晚于本指令生成日期被修改（`ls -l` 比对 mtime），则「隐性规则」清单中引用过该文件的条目可能失效，需人工复核，**但指针本身不过期，不需要仅因此重新生成**。若当前环境无文件工具（如纯网页对话），跳过自检并告知用户。

---

项目路径：`<项目绝对路径>/`

## 唯一真相来源（按阅读顺序排列）
1. `<总纲/框架文件>` — 用途一句话
2. `<详细规格1>` — 用途一句话
3. `<详细规格2>` — 用途一句话
（按"先总后分"排序；约束细节读文件本身，本指令不复制）

**冲突裁决顺序**：<文件A> > <文件B> > <文件C>（⚠️ 裁决顺序 ≠ 阅读顺序——很多项目是"分压总"，如 PRD 优先于需求框架，按项目实际填写）

## 隐性规则（真源未覆盖，必须遵守）
- 已否决/已移除：<清单，防止复活>
- 口头约定：<如"PRD 禁写技术词">
- 已知失真点：<如"需求框架 v4 滞后，以 PRD 为准">

## 修改/同步规则（改 X 必须同步改 Y）
- 改 Token 必须全局同步：<真源文件 + 影响范围>
- 改 PRD 必须同步对应设计稿
- 涉及多端改动 → 并行启动 Agent，各自先读总纲+对应 PRD

## 快速速查表
| 你想做什么 | 先读 | 再读/同步 |
|-----------|------|----------|
| 改某功能 | `文件A §章节` | `文件B` |
| ... | ... | ... |

## 文件命名规则（如有）
| 编号/前缀 | 含义 |
|----------|------|
| 00 | ... |
| 08 | ... |

## 我要做的是：
> 【在这里填写你的具体任务，参考下方场景示例】

### 场景 A：改某个章节/规格
（示例占位）

### 场景 B：改某个实现/设计稿
（示例占位）

### 场景 C：新增功能
（示例占位，列出需同步的文件清单）
```

## 维护说明
- 项目重大变更后，**重新运行本 skill 生成新版本**（按当日日期命名，同一天多次生成时版本后缀递增），旧版保留作对比。不要依赖用户记忆——长项目建议配一个 automation（如每周或每次大改后触发），自动生成新版启动指令。
- 指针式结构下，真源内容变更**不需要**重新生成指令（指针不过期）；只有以下情况需要重新生成：真源文件本身改名/删除/拆分、隐性规则变化、同步关系变化、新增已否决功能。
- 若项目有多个子系统（如硬件端/小程序端/后台），可为每个子系统单独生成一份变体（参考 WorkBuddy 项目的"修改设计稿专用"变体模式），在总纲指令里相互引用。
- 不要把本 skill 生成的内容当成最终交付物本身——它只是"让新会话接手"的桥梁。
- **跨体模式额外维护（v2.0）**：跨体协作结束后（项目回单一智能体），删除发起方 MEMORY.md 中的记忆钩子，防止残留钩子误导后续会话去找不存在的回执。
- **跨体实测参考样本（2026-08-27 POC）**：GEO 项目 `outputs/跨体交接指令_斯晨的AI笔记_2026-08-27.md` + `outputs/zcode_回执_2026-08-27.md`——首版经对抗性审查抓出 3 个严重问题（幽灵闭环/红线半复制/实测假通过）修复后实测通过，是跨体模板的实战基准。用前 Glob 校验存在。

## 参考样本（软引用，先校验存在；⚠️ 仅参考结构，禁止模仿其内容密度）
WorkBuddy 项目历史 outputs 目录（典型路径形如 `/Users/ts/WorkBuddy/<日期>-<时间>/outputs/`）已有样本：
- `新对话启动指令_v4.md`、`新对话启动指令_修改设计稿_v3.md`（旧版 `vX` 命名时期产物）
- **重要**：这些样本均为 2026-08-04 指针式重构**之前**的复制式快照——约束细节大量照抄真源，正是本 skill 现在禁止的写法。**只参考其章节骨架、速查表格式、场景示例的写法；不得模仿其"核心约束"段的复制密度**，生成内容以「核心原则」为准，样本与原则冲突时以原则为准。
- 历史 `vX` 命名仅作存档，**新文件不要再沿用 `vX` 命名**。
**使用前先用 Glob 确认路径存在**：存在则读取参考结构；若不存在（项目已清理/迁移），跳过本步，不报错。