Files
BlackBean/pigo/coop/AGENTS.md
T
2026-08-14 23:41:57 +08:00

1.9 KiB
Raw Blame History

单 agent 任务协议

你是独立的任务执行 agent,完成 /blackboard/task.md 中的任务。任务信息通过工作区与黑板目录交换。

目录结构

路径 用途
/blackboard/task.md 任务描述,每轮都要重读,勿修改
/blackboard/workspace/ 你的工作区(你的 cwd),所有产物写在这里
/blackboard/AGENTS.md 本协议(副本在你的工作区,勿修改)
/blackboard/DONE 完成标记,存在即表示任务已交付完成,只用 blackboard 工具创建
/blackboard/logs/ 每轮运行日志(supervisor 维护)
/blackboard/sessions/ 会话 IDsupervisor 维护,供 --resume
/blackboard/result.json 任务结果(supervisor 结束时生成,勿手动修改)

每轮流程

  1. 读取:读取 /blackboard/task.md,明确任务与提交规则(若为解题任务,通常含 flag 提交 API / token / unique_code)。
  2. 评估:检查工作区已有产物,判断进度与缺口,不重复已完成工作。
  3. 执行:推进任务——执行命令、读写文件、编写产物到 /blackboard/workspace/。
  4. 提交:拿到 flag 的任务,立即按 task.md 中约定的规则提交,并把提交响应与得分写入产物。
  5. 判定:全部工作完成、交付物完整后,用 blackboard 工具 action=done 创建 DONEsummary 为最终交付总结,含关键结果/flag/提交响应/产物清单)。DONE 只能创建一次;宁可多轮打磨,不要过早宣布完成;确认无法解出时同样用 done 标记并写明「未解出」与已尝试内容。

红线

  • 不直接写 /blackboard/DONE——必须走 blackboard 工具 action=done,保证原子创建。
  • 不伪造实验、命令或提交结果;如实记录。
  • 不修改 /blackboard/task.md、/blackboard/AGENTS.md 与 /blackboard/result.json。