DAY 04 · 把成功步骤写成工作流

Day 3 已经证明任务至少能由人和 AI 配合完成一次。今天要把那次成功过程从聊天记录里拿出来，写成另一次运行也能照做的 WORKFLOW.md。

工作流不是愿望清单，也不是把提示词保存下来。它必须说明每一步读取什么、做什么、产生什么、什么时候停止，以及谁负责确认。

完成后的结果

今天结束时，你会得到一份从输入检查到最终保存的 WORKFLOW.md。另一个人只读 TASK、WORKFLOW 和本次输入，应该能说出下一步该做什么。

第一步：只复盘实际发生过的动作

打开 Day 3 的 plan.md、输出版本和 issues.md，按时间顺序写下真正发生过的动作。例如：

1. 检查必填输入；
2. 复述任务和边界；
3. 等待人工确认计划；
4. 生成第一版；
5. 按完成标准检查；
6. 只返工失败部分；
7. 保存最终结果和问题记录。

不要加入“以后也许会用”的复杂步骤。今天只固化已经验证有效的最小流程。

第二步：为每一步补齐五个字段

每一步都回答：

• 输入：这一步读取什么；
• 动作：具体做什么；
• 输出：产生什么记录或文件；
• 完成条件：怎样知道可以进入下一步；
• 失败处理：不满足时暂停、提问还是返工。

合成示例的一步可以这样写：

### 1. 输入预检
- 输入：TASK.md、runs/{run-id}/input.md
- 动作：检查必填字段、禁止信息和文件可读性
- 输出：runs/{run-id}/preflight.md
- 完成条件：所有必填项均存在，禁止信息为 0 项
- 失败处理：停止执行，只列出缺失或需要删除的信息

“检查输入”太模糊；上面的写法才允许下一次重复。

第三步：明确人和 AI 的责任

对每一步标注负责人：

• AI：读取、整理、生成、按规则检查；
• 人：提供真实输入、确认业务含义、决定外部动作；
• 自动工具：只有已经实际使用并验证过时才写入。

第一次工作流至少保留两个人工确认点：执行计划确认、最终结果确认。涉及发布、付款、删除、审批、联系客户或修改生产数据时，必须在动作发生前确认。

第四步：写出最小 WORKFLOW.md

复制下面的骨架，并用 Day 3 的真实过程替换：

# 工作流

## 目标
读取 TASK.md 和本次真实输入，产出符合完成标准的结果。

## 运行目录
runs/{run-id}/

## 执行步骤

### 1. 输入预检
【输入、动作、输出、完成条件、失败处理】

### 2. 计划与人工确认
AI 写出计划；人在确认前不生成最终结果。

### 3. 生成第一版
严格使用输出契约，未知事实进入待确认区。

### 4. 逐项验收
对每条标准记录通过、失败和证据。

### 5. 局部返工
只修改失败范围；两次失败后停止并回到任务卡。

### 6. 保存交付
保存最终版本、检查记录和未解决问题。

## 人工确认点
- 执行计划开始前
- 最终结果用于外部场景前

第五步：删除只对第一次有效的细节

检查文档是否写死了这些内容：

• 某个具体日期、客户名或本次主题；
• runs/001 这样的固定运行编号；
• 只适用于第一份输入的字段；
• “像刚才那样”“按上面的聊天”等会丢失上下文的表述。

把每次变化的内容改成变量，例如 {run-id}、{input-file}、{output-file}；稳定规则继续保留。

第六步：做一次纸面走查

暂时不运行 AI。从第一步开始，用手指逐项走到最后，检查：

1. 每一步的输入是否来自上一步或明确文件；
2. 每一步的输出是否有保存位置；
3. 失败时是否知道停在哪里；
4. 人工确认发生在高风险动作之前；
5. 最后能回到 TASK.md 的完成标准。

任何一步需要依赖“你应该懂”的隐含知识，都应补写进文档。

常见错误与修正

把结果描述当流程。 “生成高质量草稿”没有动作和完成条件，应拆成生成、核对和返工。

步骤过细。 不必记录每次点击；只记录会影响结果、判断或交接的动作。

没有失败出口。 工具失败、输入缺失或连续返工时必须知道暂停，而不是无限重试。

把人工确认放在发布之后。 确认点必须发生在外部副作用之前。

今日练习与验收

把 WORKFLOW.md 给一个没有参与 Day 3 的人，或者开启一个不带昨日聊天上下文的新会话，只让对方复述流程。

满足以下条件才算完成：

• 至少覆盖输入预检、计划、生成、验收、返工和保存；
• 每一步都有完成条件或失败处理；
• 至少两个明确人工确认点；
• 没有依赖“刚才”“上面”或特定运行编号；
• 可以指出最终结果保存在哪里。

明天会把 Day 3 的真实失败点变成 CHECKLIST.md，让流程不仅会成功，也知道何时暂停。