7 天建立 Agent 工作流

加入检查、失败
和恢复规则

建立事实、格式、重复、权限与中断检查,并练习从状态文件恢复。

预计阅读 25 分钟公开免费核验于 2026.08.19
内容目录 当前:第 06
7 天完成第一个 AI 项目7
7 天学会 DeepSeek Harness7
7 天建立 Agent 工作流7
7 天做出个人知识库7
本文目录 8 个部分

大家好,我是云途。今天给流程补上质量检查和恢复能力。

自动化能够反复执行,也会反复放大同一个错误。检查需要靠证据阻止错误进入交付物。

先理解今天的原理

检查分为结构检查和内容检查。结构检查可以验证文件、字段、链接和格式,内容检查需要比较来源、事实、推断和适用条件。

恢复记录应该包含已经完成的阶段、证据路径、失败原因、人工决定和下一步。它让新会话无需重新猜测整个过程。

工具结果需要经过检查再进入下一步,失败状态则进入恢复或人工处理。用户提出任务模型选择工具宿主检查权限工具实际执行结果回到上下文
工具结果需要经过检查再进入下一步,失败状态则进入恢复或人工处理。

为什么今天要做这件事

  1. 固定检查可以拦截重复、缺引用和格式缺失。
  2. 失败分类能决定重试、换来源、回退还是人工处理。
  3. 恢复练习可以验证状态文件是否真的够用。

开始前检查

这是第 06 天。先完成下面的检查,再开始操作。缺少关键材料时,先补材料,不要让 Agent 猜。

  1. Skill 可以完成一次正向测试。
  2. 准备包含重复链接、坏链接和事实冲突的测试输入。
  3. 保存当前干净基线。

一步一步完成

第 1 步:建立结构、事实、重复、权限和完成五类检查

这一步负责确认事实。请以当前页面、文件或命令输出为准,同时记下来源、版本和检查时间,避免只凭印象继续操作。

  1. 建立结构、事实、重复、权限和完成五类检查。
  2. 把看到的实际信息摘出来;教程与本机不同的地方单独标注。
  3. 保存链接、截图或命令输出,确保之后可以复查。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 2 步。
完成这一步后,你应该看到:建立结构、事实、重复、权限和完成五类检查,相关来源和实际结果已经保存。

第 2 步:为常见失败规定处理:重试、标记、停止或人工批准

先把这一项单独完成,再继续后面的动作。操作过程要留下可以检查的材料,方便发现偏差时回到当前步骤。

  1. 为常见失败规定处理:重试、标记、停止或人工批准。
  2. 记录输入、实际动作和得到的结果。
  3. 对照今日目标检查;结果不一致时,先保存证据并处理当前问题。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 3 步。
完成这一步后,你应该看到:为常见失败规定处理:重试、标记、停止或人工批准,过程与结果均有可复查证据。

第 3 步:在每个阶段更新 STATE 文件

先把这一项单独完成,再继续后面的动作。操作过程要留下可以检查的材料,方便发现偏差时回到当前步骤。

  1. 在每个阶段更新 STATE 文件。
  2. 记录输入、实际动作和得到的结果。
  3. 对照今日目标检查;结果不一致时,先保存证据并处理当前问题。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 4 步。
完成这一步后,你应该看到:在每个阶段更新 STATE 文件,过程与结果均有可复查证据。

第 4 步:故意让一个来源失败并中断会话

先把这一项单独完成,再继续后面的动作。操作过程要留下可以检查的材料,方便发现偏差时回到当前步骤。

  1. 故意让一个来源失败并中断会话。
  2. 记录输入、实际动作和得到的结果。
  3. 对照今日目标检查;结果不一致时,先保存证据并处理当前问题。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 5 步。
完成这一步后,你应该看到:故意让一个来源失败并中断会话,过程与结果均有可复查证据。
真实工作流因来源缺少官方链接而停止的看板
实际失败演练:输入缺少 officialUrl 时流程立即停止,并给出失败文件与恢复方法。浏览器本机路径已从发布图中裁除。

第 5 步:开启新会话,只读取规则和 STATE 恢复任务

这一步会让环境或项目发生变化。开始前先保存当前状态,执行时记录真实入口、参数和输出,出现异常就停在当前步骤排查。

  1. 开启新会话,只读取规则和 STATE 恢复任务。
  2. 保存执行命令、输入参数、开始前状态和结束后的输出。
  3. 重新运行一次最小检查,确认结果可以稳定复现。
  4. 对照今天的目标完成最后检查,确认所有证据已经保存。
完成这一步后,你应该看到:开启新会话,只读取规则和 STATE 恢复任务,执行过程与可复现结果已经记录。
修正输入后恢复完成并等待人工复核的工作流看板
修正输入后使用同一运行参数恢复,已完成阶段不会重复生成,结果进入人工复核。
检查与恢复表MARKDOWN
| 检查 | 通过条件 | 失败处理 |
|---|---|---|
| 来源 | 关键结论有可访问原始链接 | 标记并停止交付 |
| 重复 | URL 去重后数量一致 | 合并并重新编号 |
| 事实 | 事实可回到来源原文 | 改为推断或删除 |
| 权限 | 仅使用允许来源 | 停止并请求批准 |
| 完成 | 所有规定文件存在 | 列出缺失文件 |

STATE 必须记录:当前阶段、已通过检查、失败原因、证据路径、下一步。
恢复测试的标准是新会话能从失败阶段继续,而非重做全部工作。
当天操作记录MARKDOWN
# 第 06 天操作记录

## 今天使用的入口与版本

## 实际完成的步骤
- [ ] 1. 建立结构、事实、重复、权限和完成五类检查。
- [ ] 2. 为常见失败规定处理:重试、标记、停止或人工批准。
- [ ] 3. 在每个阶段更新 STATE 文件。
- [ ] 4. 故意让一个来源失败并中断会话。
- [ ] 5. 开启新会话,只读取规则和 STATE 恢复任务。

## 保存的证据
- 文件:
- 截图:
- 命令或测试结果:

## 与文章不同的地方

## 下一步
请填写实际发生的情况。没有执行的步骤保持未勾选,遇到的差异直接写入记录。

这次真实操作得到了什么

S03 第 6 天真实操作结果
同一个 run id 完成阻塞与恢复
  1. 缺少 officialUrl 时退出码为 1、STATE=blocked 且没有摘要;修复输入后同 run id 进入 human_review。
本次实际结果:失败状态和恢复证据都保留,不用一次成功覆盖失败过程。

正确结果长什么样

完成操作后,用结果来判断今天是否学会。页面能打开或命令能运行,只能说明流程启动了;下面这些证据同时出现,今天才算完成。

  1. 五类检查都有通过条件和失败处理。
  2. 测试输入中的重复、坏链接和冲突均被发现。
  3. 新会话可以从 STATE 指定阶段继续。
  4. 恢复后没有重复生成已经确认的结果。

常见错误与恢复

失败后一律重试

按原因选择重试、标记、停止或人工批准。

只检查格式

补上来源、事实、权限和完成检查。

STATE 没有证据路径

记录实际文件和最后通过的检查。

留给明天的材料

结束前把今天的关键结果保存到项目目录。下一天会直接使用这些材料,保存清楚可以减少重复说明和错误猜测。

  1. 检查规则与测试集。
  2. 一次故意失败和恢复记录。
  3. 可以供新会话读取的 STATE 文件。
完成检查

第 06 天完成检查

  • 五类检查都有通过条件和失败处理。
  • 测试输入中的重复、坏链接和冲突均被发现。
  • 新会话可以从 STATE 指定阶段继续。
  • 恢复后没有重复生成已经确认的结果。

官方依据与延伸阅读

Codex 系统教学:项目规则Codex 系统教学:第一个 Skill图文教程:规则、Skill 与 Agent