派活 Brief 模板：协调者怎么把一件事一次说清，然后闭嘴
一、为什么单拎 brief 出来写
我是 Hugozen。在旗舰那篇里，我讲过协调者模型：bot 只拆任务、写 brief、验收，真活交给家里一台常开的机器上的订阅制命令行 agent。整体架构那篇已经讲过，这里不重复。
这篇只拆一个小东西：一份 brief 到底该写什么。
协调者模型里，brief 是唯一的接口。worker 看不到我和 bot 之前聊了什么，只看得到这一份文字。这份文字缺了什么，worker 就会自己补什么，补出来的往往不是我要的。我踩过很多次，所以现在把 brief 当成一件要认真写的东西。
二、一份 brief 的五个部分
早期我用「背景、任务、红线、交付物」四段，后来发现还差一块，就是验收证据。现在固定写五件事：
1. 目标。 一两句话说清「做完之后，世界有什么不同」。不要只写动作（「改一下说明页」），要写结果（「说明页补齐，小屏能正常看」）。
2. 边界。 能动哪些目录、哪个分支，产出放哪里。边界写得清楚，worker 做砸了也只是整体丢弃，不会波及别处。
3. 验收证据。 要求 worker 交活时必须附上可核对的东西：构建结果、线上访问的返回、小屏截图、改动文件清单。协调者只验证据，不通读全部代码。「我做完了」不算证据。
4. 禁区。 我认为这是最重要的一段。比如：不部署、不改 DNS、不碰支付和 webhook、不碰数据迁移、不碰密钥。这几类事必须我本人批准，brief 里写死。另外，个人项目和其他工作要隔离，brief 里要写明这件事属于哪一边，用哪边的模型和账号。我吃过「没先判归属」的亏，一次部署落到了不该落的账号下，只能删掉重建。
5. 交付格式。 产出是什么文件、放哪、命名怎么写、汇报用什么结构（做了什么、没做什么、风险、怎么回退）。格式定死，协调者验收才快。
三、可复制模板
下面是脱敏后的骨架，括号里换成你自己的内容：
# 任务：【一句话标题】
## 目标
【做完之后应该是什么状态】
## 边界
- 可改：【目录/分支】
- 产出位置：【约定目录】
- 在独立分支工作，不碰主分支
## 验收证据（交活时必须附）
- 构建结果：【命令与输出摘要】
- 线上/本地访问检查：【怎么查、期望什么】
- 小屏检查：【截图或说明】
- 改动文件清单
## 禁区
- 不部署、不改 DNS
- 不碰支付 / webhook / 数据迁移 / 密钥
- 不出现【某类敏感信息】
- 这件事属于【个人/其他】，只用对应的模型与账号
## 交付格式
- 文件：【名称与位置】
- 汇报：做了什么 / 没做什么 / 风险 / 怎么回退
- 遇到边界之外的问题：停下来写进汇报，不要自行扩展
最后一条「遇到边界外的问题，停下来写进汇报」，是后来加的。它能挡住 worker 好心办坏事。
四、派出即结束 turn，不轮询
brief 写完派出去之后，协调者这一轮就结束，不守着、不追问、不每隔一会儿问一句「好了吗」。
这样做有两个理由。
省额度。 我的额度大头就耗在这类地方：高频例程、群聊里 bot 互相叫醒、反复轮询。而且每个会话的第一次请求就已经带着很大的底座，每多醒一次，就多付一次这个底座。派完就停，这笔钱就不用花。
更稳。 轮询时，协调者的上下文会被一堆「还在跑」「还没好」塞满，之后的判断变差。它也容易忍不住插手，半路改需求，worker 拿到的就成了两份互相矛盾的指令。一次说清，然后闭嘴，等结果回来再验收，边界清楚得多。
代价是：brief 必须一次写够。这反过来逼着我在派活前把五件事想清楚，我觉得这是好事。
五、新 bot 不会自动继承规则
这是最容易忽略的一点。换一个新接手的 bot，或者新开一个账号，它不会自动知道你之前定的这些规则：什么该派出去、禁区有哪些、验收看什么。你以为规则在，其实它不在。
我的做法是：新 bot 接手时，主动推送派活 SOP 和 brief 模板，再让它复述一遍它理解的红线。同时我维护一份「接手必读」文档，把规则和已知踩坑写进去，新 bot 先读它再干活。跨 bot 的红线拿不准时，统一问主协调的那一个，不各自猜。
六、可执行清单
- brief 固定五段：目标、边界、验收证据、禁区、交付格式。
- 目标写结果，不只写动作。
- 要求交活必附证据；协调者只验证据，不通读代码。
- 支付、webhook、数据迁移、密钥、DNS 一律写进禁区，必须本人批。
- 每份 brief 标明属于个人还是其他工作，模型与账号分开用。
- 加一句「超出边界就停下汇报」。
- 派出即结束 turn，不轮询、不半路改需求。
- 新 bot 接手先推送 SOP 与模板，让它复述红线。
七、小结
brief 写得好，协调者才能放心闭嘴。更完整的协调者模型、任务流和踩坑，在这篇里：我怎么用一群 AI bot，一个人跑独立站矩阵。
博客在 /posts 下按 Agent 协作、SEO·出海、商业化三条线更新，想追更可以订阅 RSS。