方法论与洞察

交接文档不是需求原文,接手第一件事是回溯上游 · v1

一句话律:交接文档是转述。转述会丢信息、会掺进转述者的判断,而且读起来和原文一样确定。接手一项任务,第一件事是找到需求原文并与交接文档逐条对齐,而不是照着转述直接执行。

姊妹律:本条讲别人的转述读起来像原文; 约束型结论先复核律_文档写的不可能会过期_v1自己写的结论读起来像事实。 两条的补救动作不同:前者回溯上游找原文,后者复核那句结论本身。

为什么这条容易被跳过

交接文档天生长着一副”权威”的样子:它有版本号、有”已确认的关键决策(封箱,不要再讨论)“这样的措辞、有踩坑清单和理由。它比原始需求文档读起来更像定论——因为原始需求往往只有一行冷冰冰的表格,而交接文档会告诉你”为什么”。

于是接手的人会跳过”找原文”这一步:文档都写得这么细了,还找什么原文。

问题在于,转述者写下”为什么”的那一刻,就已经掺进了自己的推断。而推断可能是错的。

实证

《Codex 保姆级教学》操作部分 26 条分镜,从上一个会话转手。交接文档「三、已确认的关键决策(封箱,不要再讨论)· 决策 3」写着:

332-338 是”输入提示词不发送”系列,每条必须独立展示自己的那一段提示词,不能累积前一段

措辞是封箱级的,还附了理由(“这是上一轮被跳蛛先生点名的错误”)和知识库引用。我照此录完 7 条,机器校验和人眼抽帧都通过。

之后为了找素材,翻到交付目录里给同事核对用的 对位表.md——这才是需求原文

3.3 | 镜号 332 | 输入提示词片段 1(不发送,文字累积) 3.10 | 镜号 339 | Codex 输入框缓慢滚动展示完整需求

完全相反。 而且三处证据一致指向”累积”才是原意:

  1. 对位表是给需求方同事核对用的,措辞就是「文字累积」;
  2. 逻辑自洽性:只有累积,339 的”滚动展示完整需求”才有东西可滚;
  3. 作者当天已独立裁定 339/340 要用完整七段——与”累积”自洽,与”每条独立”矛盾。

交接文档那条,大概率是转述者把知识库里另一个项目「05 段内容重复」的教训误套了过来:那次的错误是”上一条废弃 take 的残留混进画面”,和”设计上的逐条累积”根本是两回事,但表面现象都是”画面里出现了不止一段”。

代价:重录 7 条(约 3 分钟,因为脚本已成型,只需去掉”清空”那一步)。如果没翻到对位表,返工的是整集 12 条,而且要等到同事核对时才会发现。

第二个领域案例:前置音频修复(2026-09-07)

旧交接把前置耳机无声锁定为“系统更新破坏 OEM 驱动匹配”,要求继续下载驱动;本轮现场已是 Windows 11、新版且匹配的 Realtek 驱动、已安装控制台。重新检查后发现:输出端点存在,却被判为“未插入”。勾选“禁用前面板插孔检测”后,端点恢复可用,作者确认左右测试音正常。

该案补充了两条边界:

  1. 需求原文与现场状态分开核验。 前者解决“到底要什么”,后者解决“现在是什么”。即使需求没有变化,系统版本、安装状态与端点也可能变了。
  2. 功能恢复不倒推出唯一根因。 绕过检测有效,不等于证明系统更新是起因,或检测电路已损坏;“我的判断”即使标了类别,也不能据此封死其他可检验路径。

执行中的权限与目标冲突应向作者澄清;可直接测量的事实偏差则先测量、报告并修正,不必把每个版本差异都变成一次授权询问。旧失败日志继续帮助避免机械重试,但“不要重做失败操作”不等于“不要重新读取当前状态”。详见 2026-09-07_前置音频修复_插孔检测与交接复核复盘_v1

操作规则

  1. 接手先问一句”需求原文在哪”,把交接文档和原文逐条对齐再动手。本例的原文就躺在交付目录里(对位表.md),只是交接文档没提它是原文——它只在”参考文档”里列了知识库路径,没列需求方的核对表。
  2. 发现冲突时不要自己选一个执行。 把两边原文并列摆给决策人,附上自己的判断和理由,让他一句话定。本例裁决只花一次问答。自己选 = 把转述失真变成执行失真,且更难追溯。
  3. 带感情色彩的条款优先回溯。 “这是上一轮被点名的错误”、“封箱不要再讨论”、“血泪教训”——这类措辞读起来最像定论,也最可能是转述者的加工。路径、版本、分辨率等事实条款虽然容易核验,也会过期;会影响下一步决策的条目应先实测。
  4. 冲突暴露得越早越便宜。 对齐成本是分钟级,返工成本是小时级甚至整集级。
  5. 交接文档里的”事实”也要抽查。 同一份文档写”主屏 2048×1152”,实测是 2560×1440。事实条目会过期,而过期的事实不会自己声明过期。

边界

给交接文档写作侧的反向要求

本条同时是对 交接文档书写规范 的一条补充要求:

同族

验证状态

两个领域案例:需求转述失真 + 现场状态过期。新增案例支持“接手需独立核验”的共同原则,不把不同失效机制混作完全相同的重复实验。

关联文档

类型/协作工具链主题/协作主题/交接主题/自动化