wehub-resource-sync
98 lines
3.6 KiB
Markdown
98 lines
3.6 KiB
Markdown
# Checklist SOP
|
||
|
||
## Booter（启动者/用户）
|
||
|
||
**Checklist 模式**（单人，master自己执行）：
|
||
```python
|
||
from checklist_helper import CL
|
||
cl = CL("cl_xxx", goal="<用户要求任务，尽量原样>")
|
||
cl.start_master() # Only for Booter，Master严禁调用
|
||
```
|
||
|
||
**MapReduce 模式**（多人，master派发+worker执行）：
|
||
```python
|
||
from checklist_helper import CL
|
||
cl = CL("cl_xxx", goal="<用户要求任务，尽量原样>", workers=2)
|
||
cl.start_master() # Only for Booter，Master严禁调用
|
||
```
|
||
|
||
goal 写法：只写「做什么 + 参考哪个SOP」，不写怎么做。Master 自己读 SOP 决定 plan。
|
||
|
||
## Master（reflect agent 使用）
|
||
|
||
```python
|
||
from checklist_helper import CL
|
||
cl = CL("cl_xxx") # 加载状态（BBS已在跑）
|
||
cl.add(["任务1", "任务2"]) # 在你的笔记中记录TODO项
|
||
cl.look() # 查进度
|
||
cl.mark(id, "摘要") # 验收
|
||
cl.close() # 全部完成后关闭
|
||
```
|
||
|
||
## Master plan示例
|
||
|
||
目标可分解为多个**不相干、可并行**的子任务 → add 子任务。
|
||
B 要等 A 的结果 → 不要硬拆，串行做。
|
||
|
||
任务使用短句，派发时再补充信息。
|
||
|
||
1. 下载网盘 /game 下所有文件
|
||
→ 先 webscan 拿文件列表，再每个文件一条任务
|
||
`cl.add(["下载A.exe", "下载B.zip", "下载C.zip"])`
|
||
|
||
2. 从语法、风格、格式角度检查 a.pdf
|
||
→ 三个维度天然独立
|
||
`cl.add(["检查语法", "检查风格", "检查格式"])`
|
||
|
||
3. 查所有 VPS 中版本 < 22 的，升级到 24
|
||
→ 第一轮：每台一条查版本任务
|
||
`cl.add(["查 node03 版本", "查 node09 版本", "查 Dell 版本"])`
|
||
→ reduce：master 筛出 < 22 的
|
||
→ 第二轮：每台需升级的一条任务
|
||
`cl.add(["升级 node03 到 24", "升级 Dell 到 24"])`
|
||
|
||
## Master 循环
|
||
|
||
```
|
||
cl.look()
|
||
├─ 有未完成任务 → 去 BBS 派发（mapreduce模式）/ 自己干（无worker checklist模式）
|
||
└─ 全部完成
|
||
├─ 用户最终目标已达成 → close()
|
||
└─ 最终目标未达成 → plan 下一步
|
||
├─ 可解耦 → add() 新一批任务
|
||
├─ 需串行前置 → 自己做一步，再回 look
|
||
└─ 基本搞定 → 自己整合结果，交付最终报告
|
||
```
|
||
|
||
master会被持续唤醒直到其显式成功调用close()。
|
||
|
||
## 派发任务（有workers模式下）
|
||
|
||
worker无法看到add的任务，只能看到BBS！
|
||
每条任务 prompt 须**自包含**——worker 没有 master 的上下文。
|
||
每次最多只派发3个任务，不要一次性把所有任务贴到bbs上。
|
||
worker足够聪明，只允许写目标和需要的信息，不要干预
|
||
**master不允许执行已经派发出去的任务，会导致重复执行！** 没事就sleep！
|
||
|
||
写 prompt 要点：
|
||
1. **背景**：worker 需要的信息直接给（路径、数据、约定），不要假设 worker 知道
|
||
2. **交付物**：明确产出什么、格式、写到哪里
|
||
3. **不限手段**：说要什么结果，别规定怎么做
|
||
4. **不干预 BBS 行为**：禁止教 worker 如何抢单/回帖/报告，那是 worker 自己的机制
|
||
|
||
交付规范（写进任务 prompt）：
|
||
- 交付结果和报告信息必须分开。交付 = 纯成品；报告 = 过程/问题/备注
|
||
- 交付文件禁止出现说明性废话
|
||
- 长结果写文件，短结果直接回帖
|
||
|
||
## 验收
|
||
|
||
Master 收到 worker 回帖或自己完成子任务后：
|
||
- 检查结果，语义判断 pass/fail → `cl.mark(id, "结果摘要")`
|
||
- 交付物含过程废话 → 要求重写交付物
|
||
- 失败 → 可重发、换 prompt、或自己补
|
||
|
||
## 注意
|
||
|
||
- 若子任务需要 web 工具，提醒并行 worker 新建 tab 并使用自己的 tab
|