7 天建立 Agent 工作流

把稳定主流程
写成 Skill

把收集、核验、摘要和检查整理成可复用方法,同时保留项目差异。

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

大家好,我是云途。今天把已经走过的稳定步骤写成 Skill。

Skill 只保存方法。本周主题、来源和输出继续留在项目运行目录。

先理解今天的原理

Skill 适合保存跨多次运行保持不变的流程,例如读取合同、核验来源、填写模板、运行检查。项目规则保存组织边界,运行目录保存当次数据。

流程步骤需要产生中间证据。收集阶段留下来源索引,核验阶段留下状态,摘要阶段引用编号,检查阶段留下报告。这样失败时能找到具体阶段。

Skill 提供执行方法,工作流组织阶段,规则和工具控制真实动作。Harness运行环境Agent判断与行动Skill专项方法Tools实际能力Workflow步骤与交接
Skill 提供执行方法,工作流组织阶段,规则和工具控制真实动作。

为什么今天要做这件事

  1. 稳定流程可以在下一次运行直接复用。
  2. 中间证据帮助定位错误和恢复任务。
  3. 项目差异留在输入中,Skill 不会被某个主题绑死。

开始前检查

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

  1. 前四天流程已经完整手动走过一次。
  2. 模板、示例和合同均已保存。
  3. 确认哪些步骤仍需人工批准。

一步一步完成

第 1 步:定义准确触发条件和必需输入

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

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

第 2 步:把流程写成收集、核验、摘要、检查和交付

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

  1. 把流程写成收集、核验、摘要、检查和交付。
  2. 把看到的实际信息摘出来;教程与本机不同的地方单独标注。
  3. 保存链接、截图或命令输出,确保之后可以复查。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 3 步。
完成这一步后,你应该看到:把流程写成收集、核验、摘要、检查和交付,相关来源和实际结果已经保存。
VS Code 中打开的真实工作流 Skill 定义
Skill 只保存稳定方法:读取输入、核验来源、生成摘要、运行检查并留下阶段产物。

第 3 步:为每一步规定产出文件

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

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

第 4 步:加入来源不足、访问失败和证据冲突的停止规则

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

  1. 加入来源不足、访问失败和证据冲突的停止规则。
  2. 记录输入、实际动作和得到的结果。
  3. 对照今日目标检查;结果不一致时,先保存证据并处理当前问题。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 5 步。
完成这一步后,你应该看到:加入来源不足、访问失败和证据冲突的停止规则,过程与结果均有可复查证据。

第 5 步:用历史输入进行正向、误触发和失败测试

这一步要用证据判断结果。先写预期,再执行测试,最后分别记录实际结果与结论;失败项保留原样,便于定位原因。

  1. 用历史输入进行正向、误触发和失败测试。
  2. 记录测试条件、预期结果、实际结果和是否通过。
  3. 失败时保存复现步骤与证据,修复后重新执行同一项检查。
  4. 对照今天的目标完成最后检查,确认所有证据已经保存。
完成这一步后,你应该看到:用历史输入进行正向、误触发和失败测试,每一项都有预期、实际结果和明确结论。
VS Code 中打开的 Skill 正向与失败测试结果
定义完成后用正向、误触发和失败输入验证,不能只看一次成功运行。
工作流 Skill 结构MARKDOWN
## 触发
用户要求按本项目规则生成一次公开资料周报。

## 输入
运行目录中的 INPUT.md、允许来源和输出模板。

## 流程
1. 收集 → sources.md
2. 核验 → source-check.md
3. 摘要 → summary.md
4. 检查 → test-report.md
5. 交付 → DELIVERY.md

## 停止
来源不足、关键来源不可访问或事实冲突无法说明时停止并报告。
每一步的文件就是检查点,也让流程可恢复。
当天操作记录MARKDOWN
# 第 05 天操作记录

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

## 实际完成的步骤
- [ ] 1. 定义准确触发条件和必需输入。
- [ ] 2. 把流程写成收集、核验、摘要、检查和交付。
- [ ] 3. 为每一步规定产出文件。
- [ ] 4. 加入来源不足、访问失败和证据冲突的停止规则。
- [ ] 5. 用历史输入进行正向、误触发和失败测试。

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

## 与文章不同的地方

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

这次真实操作得到了什么

S03 第 5 天真实操作结果
工作流被整理成可复用 Skill
  1. build-weekly-public-brief 通过官方 Skill 校验,真实生成 2 个来源、6 条事实和 4 个输出文件。
本次实际结果:项目内 venv 提供 PyYAML,没有污染系统 Python。

正确结果长什么样

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

  1. Skill 只包含稳定方法,没有写死本周主题。
  2. 每个阶段都有可检查的文件产出。
  3. 三类测试覆盖成功、误触发和证据不足。
  4. 高风险动作仍然需要人工批准。

常见错误与恢复

把来源列表写进 Skill

来源放回项目资料,Skill 只写读取方法。

流程只有最终摘要

补上来源、核验、检查和交付证据。

失败时仍继续写

增加停止条件并输出缺口报告。

留给明天的材料

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

  1. 经过测试的工作流 Skill。
  2. 阶段产出约定。
  3. 三类测试记录。
完成检查

第 05 天完成检查

  • Skill 只包含稳定方法,没有写死本周主题。
  • 每个阶段都有可检查的文件产出。
  • 三类测试覆盖成功、误触发和证据不足。
  • 高风险动作仍然需要人工批准。

官方依据与延伸阅读

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