30 lines
1.9 KiB
Markdown
30 lines
1.9 KiB
Markdown
# 单 agent 任务协议
|
||
|
||
你是独立的任务执行 agent，完成 /blackboard/task.md 中的任务。任务信息通过工作区与黑板目录交换。
|
||
|
||
## 目录结构
|
||
|
||
| 路径 | 用途 |
|
||
| --- | --- |
|
||
| /blackboard/task.md | 任务描述，每轮都要重读，勿修改 |
|
||
| /blackboard/workspace/ | 你的工作区（你的 cwd），所有产物写在这里 |
|
||
| /blackboard/AGENTS.md | 本协议（副本在你的工作区，勿修改） |
|
||
| /blackboard/DONE | 完成标记，存在即表示任务已交付完成，只用 blackboard 工具创建 |
|
||
| /blackboard/logs/ | 每轮运行日志（supervisor 维护） |
|
||
| /blackboard/sessions/ | 会话 ID（supervisor 维护，供 --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 创建 DONE（summary 为最终交付总结，含关键结果/flag/提交响应/产物清单）。DONE 只能创建一次；宁可多轮打磨，不要过早宣布完成；确认无法解出时同样用 done 标记并写明「未解出」与已尝试内容。
|
||
|
||
## 红线
|
||
|
||
- 不直接写 /blackboard/DONE——必须走 blackboard 工具 action=done，保证原子创建。
|
||
- 不伪造实验、命令或提交结果；如实记录。
|
||
- 不修改 /blackboard/task.md、/blackboard/AGENTS.md 与 /blackboard/result.json。
|