7 天建立 Agent 工作流

写清输入、输出
和禁止项

用一份工作流合同约定材料、产出格式、人工批准点和停止条件。

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

大家好,我是云途。今天把昨天选中的任务写成一份工作流合同。

Agent 需要知道从哪里开始、交付到哪里结束,以及哪些决定必须留给人。

先理解今天的原理

输入定义 Agent 可以依赖的材料,输出定义完成时必须存在的结果,禁止项与停止条件负责控制风险。三部分共同决定流程边界。

字段越具体,验证越容易。比如“整理资料”很难验收,“生成带链接、日期和三条结论的来源索引”可以逐项核对。

任务目标与真实输入进入上下文,项目规则和合同限制可执行范围。Prompt这次要做什么ContextAgent 已知事实边界与验收哪些不能猜可执行任务行动依据
任务目标与真实输入进入上下文,项目规则和合同限制可执行范围。

为什么今天要做这件事

  1. 清楚输入可以减少 Agent 自行寻找不可靠材料。
  2. 固定输出让后续模板和自动检查有依据。
  3. 禁止项能把事实判断、对外发布和账号操作留给人工。

开始前检查

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

  1. 昨天已确定唯一流程。
  2. 准备一份真实输入样本和一份合格人工产出。
  3. 列出任务中涉及账号、网络和对外发布的动作。

一步一步完成

第 1 步:列出每次运行必需输入、可选输入和缺失处理

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

  1. 列出每次运行必需输入、可选输入和缺失处理。
  2. 保存执行命令、输入参数、开始前状态和结束后的输出。
  3. 重新运行一次最小检查,确认结果可以稳定复现。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 2 步。
完成这一步后,你应该看到:列出每次运行必需输入、可选输入和缺失处理,执行过程与可复现结果已经记录。

第 2 步:把输出拆成文件、栏目、格式和保存位置

这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚,让第二天重新打开项目时仍然知道它的用途。

  1. 把输出拆成文件、栏目、格式和保存位置。
  2. 打开新材料逐项检查,删除示例占位内容,补上本次真实信息。
  3. 记录保存路径,并确认关闭页面或重新打开项目后仍能找到。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 3 步。
完成这一步后,你应该看到:把输出拆成文件、栏目、格式和保存位置,产物内容完整并且可以重新找到。
VS Code 中打开的真实工作流合同
工作流合同把必需输入、输出文件、人工批准点和停止条件写在同一份可检查文档中。

第 3 步:写明不允许使用的来源和不允许执行的动作

这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚,让第二天重新打开项目时仍然知道它的用途。

  1. 写明不允许使用的来源和不允许执行的动作。
  2. 打开新材料逐项检查,删除示例占位内容,补上本次真实信息。
  3. 记录保存路径,并确认关闭页面或重新打开项目后仍能找到。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 4 步。
完成这一步后,你应该看到:写明不允许使用的来源和不允许执行的动作,产物内容完整并且可以重新找到。

第 4 步:标出发布、重大判断和敏感访问的人工批准点

这一步包含一次判断。请保留候选项、判断标准和最后选择,后面发现方向不合适时才能回看当时依据。

  1. 标出发布、重大判断和敏感访问的人工批准点。
  2. 写下至少一个未选方案及其未被采用的原因。
  3. 用一句话说明最终决定,并列出会改变这个决定的新证据。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 5 步。
完成这一步后,你应该看到:标出发布、重大判断和敏感访问的人工批准点,选择依据和排除原因都能够被复查。

第 5 步:用一组真实材料走读合同,修正含糊字段

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

  1. 用一组真实材料走读合同,修正含糊字段。
  2. 记录输入、实际动作和得到的结果。
  3. 对照今日目标检查;结果不一致时,先保存证据并处理当前问题。
  4. 对照今天的目标完成最后检查,确认所有证据已经保存。
完成这一步后,你应该看到:用一组真实材料走读合同,修正含糊字段,过程与结果均有可复查证据。
工作流合同MARKDOWN
## 必需输入
- 本周主题
- 允许使用的公开来源清单
- 截止日期

## 输出
- sources.md:链接、标题、发布日期、访问日期
- summary.md:800 字以内,事实与判断分开
- questions.md:需要人工决定的问题

## 禁止
- 不登录私人账号
- 不把推断写成事实
- 不自动对外发布

## 停止
可靠来源少于 3 个时,报告缺口并停止摘要。
停止条件要说明何时停、停下后交付什么。
当天操作记录MARKDOWN
# 第 02 天操作记录

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

## 实际完成的步骤
- [ ] 1. 列出每次运行必需输入、可选输入和缺失处理。
- [ ] 2. 把输出拆成文件、栏目、格式和保存位置。
- [ ] 3. 写明不允许使用的来源和不允许执行的动作。
- [ ] 4. 标出发布、重大判断和敏感访问的人工批准点。
- [ ] 5. 用一组真实材料走读合同,修正含糊字段。

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

## 与文章不同的地方

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

这次真实操作得到了什么

S03 第 2 天真实操作结果
工作流合同已经冻结
  1. 输入字段、四类输出、五类停止条件和人工批准点写入项目文件。
本次实际结果:自动发布固定为 false,QA 通过后仍进入 human_review。

正确结果长什么样

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

  1. 必需输入、可选输入和缺失处理可以逐项判断。
  2. 每个输出都有文件名、必要字段和保存位置。
  3. 禁止项覆盖账号、事实、发布和敏感数据。
  4. 真实样本可以按合同从头走到完成。

常见错误与恢复

输出只写“生成报告”

补充栏目、字段、长度、格式和路径。

缺少材料时继续生成

增加停止条件和缺口报告。

人工批准写在最后

把批准点移动到高风险动作之前。

留给明天的材料

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

  1. 确认后的工作流合同。
  2. 一组真实输入样本。
  3. 一份合格输出样例。
完成检查

第 02 天完成检查

  • 必需输入、可选输入和缺失处理可以逐项判断。
  • 每个输出都有文件名、必要字段和保存位置。
  • 禁止项覆盖账号、事实、发布和敏感数据。
  • 真实样本可以按合同从头走到完成。

官方依据与延伸阅读

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