交接文档书写规范
给跳蛛先生本人和未来 Claude 协作网络中所有需要写交接的会话用 建立日期:2026-05-10 来源:从
跨会话协作/12 份现役交接文档中归纳 设计原则:接手方读完就能开干 · 边界先于内容 · 决策权显式留给跳蛛先生
一、什么时候写交接文档
写,当且仅当满足以下任一条件:
- 主会话上下文已紧张,需要把一块独立任务分流给副会话(Cowork / Claude Code / Chat 副会话)
- 一个项目跨越多次会话,需要让下一次会话无缝接上
- 同一项目从一个工具栈切换到另一个工具栈(例如 Web Claude → Cowork、Cowork → Claude Code)
- 副会话即将”封箱”(任务完结),需要把成果回流给主会话
不写的情况:同一会话内的任务推进、临时实验性 prompt 测试、纯私人对话(参考”心理咨询副会话不汇报”原则)。
二、文件命名规范
命名公式
[项目名]_[子任务/阶段]_[动作]_[接收方].md示例(均来自现役文档)
凝视_Day_2_交接给_Cowork_Claude.md—— 项目 + 阶段 + 动作 + 接收方Lora炼制项目_train_local交接给_ClaudeCode.md—— 项目 + 子任务 + 动作 + 接收方擦干净_sref探索_交接给Cowork.md共创者副会话_夜航西飞_启动brief.md—— 启动型用启动brief回函v2_致小红书运营经理.md—— 回函型用回函vN_致XX擦干净_sref探索_收口简报_20260510.md—— 收口型加日期戳
命名要点
- 接收方明示:
交接给_Cowork/交接给_ClaudeCode/致_主对话—— 让文件名自带路由信息 - 版本/日期:迭代型加
v2、v3,跨日产出加_YYYYMMDD - 动作动词统一使用:
交接给/转交给/启动brief/回函/收口简报/完成报告 - 用下划线分隔,不要用空格
三、文件头规范(前 10 行决定接手方愿不愿意往下读)
标准模板
# [文档标题:与文件名一致或更人性化]
> 致 [接收方]:这是从 [来源] 转接的 [任务类型] 交接。读完这份文档你就能直接进入工作。
> 创建时间:YYYY-MM-DD
> 项目阶段:[一句话定位当前在哪一步]
> 交接原因:[为什么现在要分流]
> 文档版本:[v1 / v2,继承自哪份文档]
---头部必含 5 个字段
- 致谁——明确这份文档的目标读者(避免被当成产出归档误读)
- 创建时间——交接文档有时效性,几天后就可能过期
- 项目阶段——一句话告诉接手方”现在打开的是项目的第几幕”
- 交接原因——让接手方理解”为什么是我接手而不是别人”
- 文档版本——多次迭代型项目,标 v1/v2 并写明继承关系
四、十节标准骨架
按以下顺序写,可按任务复杂度增删,但 0 / 1 / 2 / 8 节必有。
第 0 节 · 致接收方的几件事(必有)
写 5-7 条让接手方”立刻知道怎么和跳蛛先生打交道”的事。模板:
## 致 [接收方]:你需要先知道的几件事
1. **用户是跳蛛先生**——身份(B 站 AI 创作者 / 独立游戏开发者 / 26 岁 / ENTP / 计算机背景)
2. **沟通风格**:直接、简洁、要真实判断不要捧场。可以直说"这个不行""这个判断错了"
3. **决策权完全在他手里**——你的角色是基于事实的判断 + 建议,创作决策全部由他拍板
4. **避免堆砌**:他对没有信息密度的回答(套话、过度铺垫)非常敏感
5. **避免 emoji 和过度 markdown**——保持简洁专业的写作风格
6. **使用"跳蛛先生"称呼或直接进主题**,不要用"用户"为什么这节必有:接手方第一眼看到的应该是”怎么说话”,不是”做什么”。
第 1 节 · 任务边界(必有,且最重要)
这是整份交接文档的灵魂。”❌ 不要做”列表的精度决定副会话产出质量。
## 〇、你的任务边界
### 你**要**做的
- [3-5 条具体动作,每条以动词开头]
- 接收 / 编辑 / 维护 / 判断 / 对比 / 建议
### 你**不要**做的
- ❌ 不要替我做创作判断
- ❌ 不要扩写测试文档之外的内容
- ❌ 不要给我"无脑赞同"的反馈
- ❌ 不要催我推进
- ❌ 不要试图把测试合并简化铁律:❌ 列表的具体度 ≥ ✅ 列表的具体度。原则参考《我的Claude协作工作流》原则 1:“那些 ❌ 列表越具体,副会话越能放心地在 ✅ 范围内深挖。“
第 2 节 · 项目极简概要(必有,60 秒能读完)
## 一、项目基本盘(60 秒读完)
**项目**:[名称]
**核心命题**:[一句话 / 一句引文]
**当前状态**:[已完成 X / 正在做 Y / 接下来 Z]
**关键数据**(如有):[播放量 / 三连率 / 数据集规模等]写作要点:
- 不展开背景故事,只给”足够让接手方做判断”的最小信息
- 涉及 IP / 角色卡时,给一张表(角色名 / 称号 / 一句话定位)即可,详情指向角色卡文件
- 永远引用源文件,不复制全文(例:“角色卡详情见
character_cards_v2/”)
第 3 节 · 关键决策与定稿(必要时)
把项目走到当前节点已经封箱、不要再讨论的决策列出来。
## 三、已确认的关键决策
### 决策 1:[名称] = **[选择]**
**理由**:
- [3-5 条事实性理由]
> ⚠️ 这个决策直接影响 [下游 X / Y / Z],所有后续步骤都基于此。
### 决策 2:...用意:防止接手方”重新做技术选型权衡”——浪费上下文,且可能动摇定稿。
第 4 节 · 工具栈与资产(必要时)
## 四、关键工具栈
### 主工具:[X]
- 入口 / 配置 / 关键操作要点
- 与备选工具的关系
### 备用方案:[Y]
- 何时切换、切换条件涉及大量文件时,给一棵目录树:
## 五、关键文件位置清单
{AIGC工作站}/[项目]\
├── 00_交接文档/ ← 把本文档放这
├── 01_角色卡/
├── 02_素材/
└── ...第 5 节 · 方法论传承(必要时)
把项目自己沉淀的”工作分工 / 心法 / 反模式”显式写出来,不要假设接手方知道。
## 九、必须传承的方法论原则
### "蒙眼剪辑法"(核心工作分工)
LLM 看不见视频 → 创作者用人耳听 BGM 标卡点 → 反馈给 LLM → LLM 用代码精确执行
### 反馈精度决定迭代速度
✅ 好反馈:"Veritia 出现得晚了 200ms" / "色差转场太弱"
❌ 坏反馈:"再调一下" / "感觉不对"如果方法论已在知识库沉淀,引用文件而不复制:
详见 `{知识库}/04_方法论与洞察\蒙眼剪辑法_方法论笔记.md`第 6 节 · 必须避开的坑(必要时)
## 十、必须避开的坑
1. **不要用 X 做 Y**——理由 / 反例
2. **不要假设 A 有 B 功能**——它没有
3. **不要先 X 再 Y**——必须反过来每条坑必须含:禁止动作 + 一句理由,不要只写禁令。
第 7 节 · 进度快照(强烈建议)
用三态(已完成 / 进行中 / 待做)+ checkbox:
## 十一、当前进度状态(交接时刻的精确快照)
### 已完成
- [x] Day 1 发布(289 播放,41% 三连率)
- [x] 6 角色卡 v2 封板
### 进行中(交接时正在做的事)
- [ ] **跳蛛先生当下的下一步动作**:用 Nano 画布跑 V-02 / V-03 / V-04
### 待做
- [ ] V-01 / V-03 视频段生成
- [ ] BGM 生成
- [ ] **MoviePy 30 秒视频合成代码框架(接手方你的第一项工作)**接手方的第一项工作用粗体标出,让其他待办不抢焦点。
第 8 节 · 第一轮接手时怎么做(必有)
## 十二、第一次启动时
收到这份文档后,你不需要做总结回复。直接说一句"准备好了,等你发第一批 X"就行。或更详细的版本:
### 第一轮接手时建议做的事
1. 读完这份交接文档,确认理解整体结构
2. 跟跳蛛先生确认他的当前状态
3. 开始 [可并行启动的工作]——这件事不依赖于素材到位,可以并行启动
4. 不要急着主导节奏——跳蛛先生会按他的步调推进,你的任务是在他需要时给精确支持铁律:不要让接手方第一回复就堆 500 字”我理解了,任务范围是…”——这是套话,跳蛛先生厌恶。
第 9 节 · 文档版本历史(必要时)
## 文档版本历史
- v1 - 2026-05-08 上午 - 跳蛛先生 + Web Claude(原始启动文档)
- v2 - 2026-05-08 下午 - 跳蛛先生 + Web Claude(交接给 Cowork Claude,本文档)
主要 v1→v2 变更:
- 主静态图工具切换:Niji V7 → Nano
- 剧本敲定:V1 听觉触发版,30 秒整,6 段分镜五、写作风格规范
5.1 称呼与语气
- 称呼跳蛛先生本人:“跳蛛先生” 或 直接进主题(不用”用户”)
- 称呼接手方:“你”(直接对话感),开头明示”致 [接收方]”
- 落款的”我”指写文档的会话(主对话 / Web Claude / 当前 Cowork 等)
5.2 信息密度
- 每段都有信息——没信息就删段
- 不写”很有趣""我觉得这个方向”之类的铺垫
- 不写”希望对你有帮助”之类的客套结尾
- 引用主作品/源文件,不复制全文
5.3 表达对照
| ❌ 不要写 | ✅ 改成 |
|---|---|
| ”感觉不太对" | "Veritia 出现得晚了 200ms" |
| "希望本文档能帮到你” | (删掉,不写) |
| “这是一个非常重要的项目" | "这个项目对我重要。视觉系统是项目能不能出圈的关键变量" |
| "请尽量…" | "必须 / 不要 / 一定 …" |
| "用户" | "跳蛛先生" |
| "我们一起加油” | (删掉) |
5.4 格式约定
- 章节序号:用中文一、二、三(或保留 〇 作为”边界”专用,符合既有惯例)
- 分节符:每节之间用
--- - 状态标识:✅ 完成 / 🟡 进行中 / 🔴 待做 / ⬜ 未开始 / ⚠️ 警告
- 强调:粗体用于关键术语和铁律,
代码块用于 prompt / 命令 / 文件名 - emoji:仅用于状态标识和 ✅❌ 列表,正文中避免装饰性 emoji
- 表格:用于结构化对照(角色 / 工具 / 时间锚点 / 决策对比)
- 代码块:用于 prompt 模板、命令行、配置 toml,语言标识可省略也可标(
toml /python) - 引用块
>:用于元信息(文档头)、原话引用、关键警告
六、不同类型交接文档的差异化模板
类型 A · 启动 brief(开新副会话用)
最长 800-2000 字。重点节:0 / 1 / 8 节。
- 第 0 节:你是谁(角色限定 3 件事)
- 第 1 节:你要 / 你不要(各 3-5 条)
- 第 8 节:第一轮交付要求
参考样本:共创者副会话_启动brief_chat版.md
类型 B · 项目接手交接(跨工具栈用)
完整 3000-6000 字。0-9 节全上。
- 必含工具栈说明(第 4 节)和文件位置清单
- 必含进度快照(第 7 节)+ “你的第一项工作”标注
- 推荐含方法论传承(第 5 节)和避坑清单(第 6 节)
参考样本:凝视_Day_2_交接给_Cowork_Claude.md、Lora炼制项目_train_local交接给_ClaudeCode.md
类型 C · 子任务分流(主对话 → 副对话)
精简 1000-2500 字。重点节:0 / 1 / 2 / 8 节。
- 第 1 节边界写得比项目接手更严(子任务的边界本来就更窄)
- 必含”何时回流主对话”的判断标准
参考样本:擦干净_sref探索_交接给Cowork.md、我的一天_转交给_Cowork_Claude.md
类型 D · 回函/简报(副对话 → 主对话回流)
短 500-1500 字。重点节:进度快照 + 决策建议 + 反对路径。
- 必含”如果跳蛛先生不接受这个建议会怎样”——给决策人留反对路径
- 不写情绪 / 客套 / 自我评价
参考样本:致小红书运营经理_IP扩展决策建议.md、回函v2_致小红书运营经理.md、擦干净_sref探索_收口简报_20260510.md
七、自检清单(写完前过一遍)
- 文件名符合
项目_子任务_动作_接收方.md公式 - 文档头 5 字段齐全(致谁 / 时间 / 阶段 / 原因 / 版本)
- 第 0 节存在,且写明跳蛛先生的沟通风格
- 第 1 节”❌ 不要做”列表的具体度 ≥ ”✅ 要做”列表
- 第 2 节项目概要可在 60 秒内读完
- 凡是引用其他文件,都给了绝对路径(
{AIGC工作站}/...) - 凡是封箱决策,都标注了”⚠️ 不要再讨论”
- 进度快照三态分明,接手方第一项工作粗体标出
- 第一轮回复要求明示(避免接手方堆 500 字总结)
- 没有 emoji 装饰、没有套话、没有”我们一起加油”
- 决策建议都附了反对路径(如适用)
- 文档落款写了”作者 / 接收 / 下游”链路(如跨多级)
八、底层心法(背下来)
来自《我的Claude协作工作流》六原则,在交接文档场景的应用:
- 明确边界 + 充分信任 —— 第 1 节的 ❌ 列表越狠,接手方在 ✅ 范围内越自由
- 平级协作,不互相覆盖 —— 不要在交接文档里替接手方做它领域内的判断
- 通过文件系统互通 —— 凡能用文件路径表达的资源,不要复制内容到文档里
- 给决策人留反对路径 —— 任何建议都附”如果跳蛛先生说不,会怎样”
- 主动暴露认知盲区 —— 写明”本文档可能错的地方”或”我哪里想错了”比堆砌产出更稀缺
- 私人副会话严格隔离 —— 心理咨询 / 私人对话的会话不写交接文档
九、如何使用本规范
- 写新交接文档前,先打开本文件,按”四、十节标准骨架”建空白章节
- 写完后,用”七、自检清单”勾一遍
- 如果发现新的反复模式或反例,回来更新本文档(更新优先于新建,见知识库 README 第 2 条)
- 与本规范冲突的现役文档不需要回头改——规范向前生效即可
这份规范不是为了让交接文档变长,是为了让接手方少读字、快上手。 凡是能让接手方提前 5 分钟开干的字,就值得写;反之,就该删。