# 第一条 AI 工作流模板

这份模板用来验证：一项重复工作能否跨会话继续，而不是每次从头开始。

先只选一条每周至少重复一次的工作。连续运行两次，再决定是否增加自动化或更多 Agent。

## 0. 建立最小目录

```text
my-workflow/
├── WORKFLOW.md
├── inputs/
│   └── weekly-notes.md
├── outputs/
└── trace.md
```

- `WORKFLOW.md`：固定目标、边界和完成条件；
- `inputs/`：每次变化的新材料；
- `outputs/`：可以直接使用的正式产物；
- `trace.md`：交接状态、人的纠错与下一步。

## 1. 工作流身份

```yaml
workflow: 这条工作流的名字
purpose: 它最终帮助谁解决什么问题
owner: 谁承担最终判断
entry: 新任务和新材料统一放在哪里
deliverable: 正式产物固定放在哪里
```

## 2. 本次任务

```yaml
task: 这次只完成什么
context:
  - 接手前必须读的文件、链接或历史决定
allowed_writes:
  - 可以修改的文件或系统
forbidden_writes:
  - 只能读取、不能修改的区域
done_when:
  - 可以逐项检查的完成条件 1
  - 可以逐项检查的完成条件 2
handoff_to: 由谁验收
```

## 3. 给 AI 的执行指令

```text
请按这份工作流执行任务。

开始前：
1. 复述本次 task、allowed_writes 和 done_when；
2. 如果完成条件无法验收，先指出缺口；
3. 不要扩大任务范围。

完成后不要只回复“已完成”，请交付：
1. 可直接使用的正式产物；
2. 产物路径或链接；
3. 对照 done_when 的逐项验收结果；
4. 本次使用过的关键输入；
5. 下一次接手时必须知道的状态、问题和建议。

不要修改 allowed_writes 之外的内容。
```

## 4. 交付记录

```yaml
status: complete | degraded | blocked
artifact: 正式产物路径或链接
acceptance:
  - 条件 1: pass | fail
  - 条件 2: pass | fail
open_issues:
  - 尚未解决的问题
next_action: 下一步唯一动作
feedback_to_keep:
  - 下次不应再犯的错误
  - 已验证、可以复用的做法
```

## 5. 第二次运行后的验收

只检查四个问题：

- 第二次是否少解释了背景？
- 产物能否直接进入下一步？
- 失败时能否明确定位断点？
- 第一次的纠错是否被保留？

只要其中几项开始改善，这条工作流就值得继续打磨。不需要机械地追求某个分数；沿着仍未改善的断点继续修：背景重复说明，修 `context`；产物不可用，修 `done_when`；结果找不到，修 `deliverable`；错误反复出现，修 `trace.md`。等真实摩擦出现，再增加自动化、多个 Agent、长期记忆或跨机协同。