7 天建立 Agent 工作流

建立项目规则
和资料真源

把长期边界、目录、命名和来源要求写进项目,让每次运行使用同一套规则。

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

大家好,我是云途。今天把长期不变的要求放进项目,而非每次在聊天里重新解释。

资料真源指可以追溯和更新的原始输入。摘要、缓存和中间结果都能重建,不能反过来冒充来源。

先理解今天的原理

项目规则保存长期边界,如允许来源、目录、命名、批准点和完成检查。本次主题与日期属于变化输入,应该放在每次运行目录。

真源和产物分开后,错误结论可以回到原始链接或文件检查。每次运行保留独立目录,也便于比较流程是否逐步稳定。

规则、真源、模板、测试和每次运行产物各有固定位置。终端输入窗口Shell解释命令路径指出位置项目限定范围
规则、真源、模板、测试和每次运行产物各有固定位置。

为什么今天要做这件事

  1. 长期规则进入项目后,新会话也能读取。
  2. 真源可追溯可以降低转述和版本混淆。
  3. 独立运行目录能保留历史证据和回滚点。

开始前检查

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

  1. 工作流合同已经确认。
  2. 准备允许来源和禁止来源清单。
  3. 确定每次运行的日期或编号规则。

一步一步完成

第 1 步:建立 sources、templates、runs 和 tests 目录

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

  1. 建立 sources、templates、runs 和 tests 目录。
  2. 打开新材料逐项检查,删除示例占位内容,补上本次真实信息。
  3. 记录保存路径,并确认关闭页面或重新打开项目后仍能找到。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 2 步。
完成这一步后,你应该看到:建立 sources、templates、runs 和 tests 目录,产物内容完整并且可以重新找到。
VS Code 中打开的资料真源与目录映射
先把规则、来源、模板、运行记录和测试分别放进固定目录,避免真源与产物混在一起。

第 2 步:在项目规则中写允许范围、命名和批准点

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

  1. 在项目规则中写允许范围、命名和批准点。
  2. 打开新材料逐项检查,删除示例占位内容,补上本次真实信息。
  3. 记录保存路径,并确认关闭页面或重新打开项目后仍能找到。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 3 步。
完成这一步后,你应该看到:在项目规则中写允许范围、命名和批准点,产物内容完整并且可以重新找到。
VS Code 中打开的项目 AGENTS 规则
项目规则明确允许来源、命名、事实引用、人工批准和停止条件,新会话也能按同一标准工作。

第 3 步:把长期来源清单放入 sources

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

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

第 4 步:建立本周运行目录并复制本次输入

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

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

第 5 步:让 Agent 只读检查规则、目录和缺失项

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

  1. 让 Agent 只读检查规则、目录和缺失项。
  2. 把看到的实际信息摘出来;教程与本机不同的地方单独标注。
  3. 保存链接、截图或命令输出,确保之后可以复查。
  4. 对照今天的目标完成最后检查,确认所有证据已经保存。
完成这一步后,你应该看到:让 Agent 只读检查规则、目录和缺失项,相关来源和实际结果已经保存。
建议目录和规则摘要TEXT
weekly-research/
├── AGENTS.md
├── WORKFLOW-CONTRACT.md
├── sources/allowed.md
├── templates/
├── tests/
└── runs/2026-08-19/
    ├── INPUT.md
    ├── sources.md
    ├── summary.md
    └── STATE.md

AGENTS.md 至少写明:允许来源、文件命名、事实引用、人工批准、停止条件和完成检查。
一次运行的主题和结果留在日期目录,长期规则留在根目录。
当天操作记录MARKDOWN
# 第 03 天操作记录

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

## 实际完成的步骤
- [ ] 1. 建立 sources、templates、runs 和 tests 目录。
- [ ] 2. 在项目规则中写允许范围、命名和批准点。
- [ ] 3. 把长期来源清单放入 sources。
- [ ] 4. 建立本周运行目录并复制本次输入。
- [ ] 5. 让 Agent 只读检查规则、目录和缺失项。

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

## 与文章不同的地方

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

这次真实操作得到了什么

S03 第 3 天真实操作结果
资料真源只接受结构化官方记录
  1. 真实输入使用 DeepSeek 官方仓库与 Anthropic Claude Code CLI 官方文档,均保存 HTTPS 链接、核验日期和事实数组。
本次实际结果:模板不保存事实,事实只能来自 inputs/sources。

正确结果长什么样

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

  1. 长期规则与本次输入已经分开。
  2. 每条关键结论都能回到原始来源。
  3. 新的运行目录可以按同一规则创建。
  4. 只读检查没有发现来源不明或路径冲突。

常见错误与恢复

把本周主题写进长期规则

移到本次运行的 INPUT 文件。

摘要成为唯一资料

保留原始链接、日期和访问记录。

每次结果覆盖上一次

使用独立日期目录保存运行。

留给明天的材料

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

  1. 完整项目目录。
  2. 长期项目规则和来源清单。
  3. 第一份独立运行目录。
完成检查

第 03 天完成检查

  • 长期规则与本次输入已经分开。
  • 每条关键结论都能回到原始来源。
  • 新的运行目录可以按同一规则创建。
  • 只读检查没有发现来源不明或路径冲突。

官方依据与延伸阅读

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