‹ 返回笔记 · Back to notes

现场手记

《Codex 使用手册》· 第 7 章|形成成果与最小修复

完成连续案例并只修正受影响内容。

CHAPTER 07 · 7.5–7.9

教材版本:v1.0 · 官方资料核验:2026-08-23 · 当前界面与账号可用性以读者实际状态为准。

7.5 画出从开始到交接的任务地图

7.5 画出从开始到交接的任务地图教学示意
图 7-05 · DIA-07-05。把开始阶段、变化阶段、修复阶段和交接阶段放进同一张任务地图;教学示意·非产品界面。
结业实战的只读输入、三个输出与人工停止点
图 7-06 · UI-07-05-01。2026-08-22 本机虚构结业实战。画面证明项目在执行前已锁定只读输入、三个输出、四项待确认和人工停止点;不能证明虚构规则可用于真实领用流程。

任务地图是一张能看懂的路线图,不是复杂的项目管理系统。本次可以拆成八个阶段:

  1. 确认练习目标、允许范围和可写文件清单。
  2. 只读打开旧说明待确认卡更正便签保持未打开。
  3. 把初始已知事实和四项待确认事项分开。
  4. 写初始任务说明,并依次形成三份初始草稿。
  5. 在 7.9 收到并复制更正便签,记录它带来的局部变化。
  6. 保留旧值和新值,只修三份草稿中受影响的位置。
  7. 一致性表对照三份修订稿,保留差异和未知。
  8. 经过人工交付闸门后,仍停在发送或发布之前。

在每个阶段旁边写一个检查点。检查点就是停下来也能核对进度的位置,例如“材料已复制但未改动”“四项待确认已列出,但仍未有结论”“三份草稿都已打开”。如果没有证据能说明当前在哪个阶段,就不要继续往下写。

你可以这样说:

请把八个阶段做成任务地图。
每个阶段写:目标、输入文件、要留下的记录、通过条件、停止条件。
地图只能覆盖本地虚构练习;不要生成定时任务,不要连接外部系统。

你要检查每个阶段是否有输入、输出和停止条件,尤其是第5、6阶段是否先保留更正前后的差异、再修订草稿。常见坑是把“打开文件”当成“核对完成”;打开只是动作,只有记录了看到什么并由人检查,才算有证据。

7.6 把已知事实和待确认事项分开

7.6 把已知事实和待确认事项分开教学示意
图 7-07 · DIA-07-06。将旧说明支持的事实与待确认卡中的未知事项分开,暂不引入更正便签;教学示意·非产品界面。

先做两栏表。第一栏写“开始阶段材料明确写了什么”,第二栏写“材料没有决定、必须留给人什么”。此时已知事实只来自旧说明:登记时间、字段名称、常规物品处理表述和特殊物品不承诺供应时间。更正便签尚未引入,不能提前把新时间、新字段或练习稿提示写进草稿。待确认栏必须完整保留四项:

  1. 登记放在哪里。
  2. 由谁作为值班同学。
  3. 是否保留纸质登记。
  4. 若无法提供物品,怎样通知登记人。

“待确认”不等于“没有答案”,而是当前材料不足以让你安全下结论。把它改成肯定句会让后续的人误以为已经得到负责人同意。

你可以这样说:

请只读旧说明待确认卡两份个人副本,建立“初始已知事实”和“待确认事项”两栏。
每条已知事实注明来源材料和位置;四项待确认事项逐字保留。
不得推测责任人、地点、纸质流程或通知方式。
输出核对记录草稿,不生成最终启用说明。

你要检查每条初始事实能回到材料,四项待确认事项没有被改写成“已确定”,更正便签也没有被提前当作输入。常见坑是把“值班同学”当成已知角色;材料只说有这个角色,没有说是谁,所以必须保留未知。

7.7 写出第一份可执行的任务说明

7.7 写出第一份可执行的任务说明教学示意
图 7-08 · DIA-07-07。把为什么做、用什么、做什么、做到哪里停写成下一位可执行的任务说明;教学示意·非产品界面。

任务说明要让下一位处理人知道“为什么做、用什么、做什么、做到哪里停”。建议包含六个字段:

字段 本练习要写的内容
目标 更新虚构的办公用品领用说明并留下可回查记录
输入 开始阶段为旧说明待确认卡两份个人副本;7.9 后再加入更正便签个人副本
允许动作 读取、比较、起草、记录差异,并只在个人副本目录中保存本章列明的练习文件
禁止动作 联网、登录、上传、删除、覆盖原始材料、发送、发布
结果 需求卡任务说明,以及更新说明、核对记录交接便签三份初始草稿;7.9 后形成修订稿、一致性表人工交付闸门勾选表复盘表
人工验收 人逐份打开,核对事实、未知、文件位置和停止线

“允许动作”写清你可以做什么,“禁止动作”写清你不能做什么;这两栏合起来就是本次边界。不要只写“整理资料”,因为那无法判断什么动作越界。

你可以这样说:

请把现有需求整理成一份可执行任务说明。
必须包含目标、输入、允许动作、禁止动作、结果、人工验收。
结果只能写入本章列明的个人副本文件:需求卡任务说明、三份草稿、一致性表人工交付闸门勾选表复盘表;禁止真实发送或发布。
遇到材料冲突或缺失,标记为待确认并停止扩写。

你要检查任务说明是否能由不熟悉项目的人读懂,是否写出“个人副本目录”和全部允许文件,是否把人工验收放在最后。常见坑是把“检查”交给助手自己宣布;助手可以列检查结果,人仍要打开文件做最后判断。

7.8 分步推进,并留下可复查的记录

7.8 分步推进,并留下可复查的记录教学示意
图 7-09 · DIA-07-08。每完成一步就记录动作、文件、依据和下一步,为暂停与恢复保留位置;教学示意·非产品界面。

现在才开始按地图执行。每完成一步,就在“核对记录”中写四件事:做了什么、打开了哪份文件、依据是什么、下一步是什么。这里的“依据”是你实际看到的文件或文字位置,不是助手的推测。

在 Codex 桌面端的新任务中,可以把旧说明待确认卡两份个人副本任务说明一起放入同一个本地练习文件夹。请求先读后写,要求每次只改一个目标草稿。先依次形成更新说明、核对记录交接便签三份初始草稿;完成一份后,你亲自打开该文件,确认文件名、内容和状态,再让助手处理下一份。更正便签在本节仍不打开。

你可以这样说:

请只处理“更新说明_草稿.md”。
读取旧说明待确认卡两份个人副本任务说明,先列出将引用的初始事实。
只写旧说明明确支持的内容,四项待确认保持“待确认”;不要打开或引用更正便签。
完成后列出文件位置、使用的来源和未决定事项。
禁止修改输入、创建额外文件、发送或发布。

你要检查每次输出是否只写入指定草稿,核对记录是否同步写了来源和下一动作,三份初始草稿是否都标为“初始草稿,待后续变化与人工验收”。常见坑是一次要求助手同时生成三份成果,导致差异难以定位;更稳妥的做法是一次一个草稿,再由人逐份打开。

7.9 发现变化时,怎样做最小修复

现在才模拟收到中途变化:由人打开原始材料区的更正便签,复制成“更正便签_个人副本”,并在核对记录写下收到时间和文件位置。更正便签显示:旧说明的“每周二、周四”改为“每周一至周四16:00前”;“用途”改为“使用原因”;常规物品的处理描述也变了;更新稿需增加练习稿提示。最小修复的意思是只改受影响的句子和记录,不把没有变化的内容全部重写。

安全的修复顺序是:先在核对记录中保留旧值,再记录更正来源和新值;然后依次修订个人副本中的更新说明、核对记录交接便签;最后重新打开三份草稿,检查受影响处是否同步。原始旧说明和原始更正便签都不删除、不覆盖。

材料与事实图:三份离线材料分成已知事实和待确认事项
图 7-10 · DIA-07-09-01。保留更正前的旧值,记录变化来源和受影响草稿,先不覆盖原始材料;教学示意·非产品界面。

你可以这样说:

请只读刚复制的“更正便签_个人副本”、三份初始草稿和任务说明,做一次最小修复。
先在核对记录中保留旧值、新值和更正位置,再只更新三份草稿中受影响的句子。
不要删除旧记录,不要替四项待确认事项做决定。
完成后列出受影响的三份草稿位置,等待人工检查。

你要检查旧值仍可找到,新值有更正依据,三份修订稿没有互相矛盾。常见坑是直接把旧说明改成新说明,导致后来的人无法知道发生过什么;一旦旧值消失,立刻停止并回到仍保留初始草稿的个人副本

留痕与修复图:保留旧值、记录更正并只修影响范围
图 7-11 · DIA-07-09-02。只修复受影响句子并复查三份草稿,保留未变化内容和未知事项;教学示意·非产品界面。
结业实战中更正发生后的最小修复范围
图 7-12 · UI-07-09-01。2026-08-22 本机虚构更正演练。画面证明变化被限定到一个事实字段和三个受影响文件,原始输入与四项待确认保持不变;不能证明真实流程已经批准或生效。
本页目录
  1. 7.5 画出从开始到交接的任务地图
  2. 7.6 把已知事实和待确认事项分开
  3. 7.7 写出第一份可执行的任务说明
  4. 7.8 分步推进,并留下可复查的记录
  5. 7.9 发现变化时,怎样做最小修复

继续读下去

这些是同一条线索附近的记录。也可以继续追问、回到目录,或从标签进入同一主题。

追问这篇 回到目录 浏览标签