first commit

2026-08-14 23:41:57 +08:00
commit 086803a8dd
471 changed files with 91938 additions and 0 deletions
@@ -0,0 +1,29 @@
+# 单 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。