feat: add agent-collaboration-kit

2026-07-06 09:24:22 +08:00
parent f1ed320991
commit c4c68572c3
8 changed files with 970 additions and 0 deletions
@@ -0,0 +1,137 @@
+# Prompt Templates
+
+这些模板用于 Coordinator 给 Developer Worker 派发任务。复制时替换尖括号占位符。
+
+## 1. 初始派发模板
+
+```text
+你现在接到一个受监督的 Orca 编排任务。请在 <dev_worktree> 开发工作树内完成。
+
+编排上下文：
+- taskId: <orca_task_id>
+- dispatchId: <orca_dispatch_id>
+- coordinator: <coordinator_handle>
+
+任务：
+- 修复 <task_id>: <task_title>
+
+请先读取：
+- AGENTS.md
+- tasks.yaml
+- <relevant_spec_or_test_doc>
+
+当前失败证据：
+<copy latest Product/Test evidence>
+
+验收标准：
+1. <expected behavior 1>
+2. <expected behavior 2>
+3. <expected behavior 3>
+
+约束：
+- 只修改 Developer 可写路径。
+- 不要修改 Product/Test 负责的规格和集成测试文件，除非任务明确要求。
+- 不要标记 verified。
+- 不要提交或推送，除非用户明确要求。
+- 最小 diff，避免无关重构。
+
+完成前必须运行：
+- <test command 1>
+- <test command 2>
+- <test command 3>
+
+完成后发送一次 worker_done：
+orca orchestration send --to <coordinator_handle> --type worker_done --subject "<task_id> fix ready round <n>" --body "<三句话内：修了什么、验证、风险>" --payload '{"taskId":"<orca_task_id>","dispatchId":"<orca_dispatch_id>","filesModified":["<paths>"],"verification":["<commands>"]}' --json
+
+如果阻塞，请发送 escalation 或 ask。
+```
+
+## 2. 复测失败再派发模板
+
+```text
+第 <n> 轮 QA 未通过，请继续修 <task_id>。
+
+上一轮开发声称：
+<worker_done summary>
+
+Product/Test 独立复测结果：
+- 运行命令：<commands>
+- 失败页面/API：<page or endpoint>
+- 仍缺失：<missing expected checks>
+- 实际观察：<actual evidence>
+
+关键提示：
+- 不要只满足静态文案，必须满足交互后的真实状态。
+- 如果后端/API 正常而 UI 不更新，请优先排查事件链、状态重置、异步请求、构建产物和服务 worktree。
+- 修复后请自己用浏览器或脚本复现 Product/Test 的完整步骤。
+
+验收不变：
+<copy acceptance criteria>
+
+完成后发送 worker_done，subject 使用：
+"<task_id> fix ready round <n>"
+```
+
+## 3. 三轮失败留档模板
+
+```text
+<task_id> 已完成 3 轮受监督修复，但仍未通过 Product/Test 复测。
+
+最终状态：
+- status: leftover
+- reason: failed after 3 supervised developer rounds
+
+保留证据：
+- round 1: <summary>
+- round 2: <summary>
+- round 3: <summary>
+- final failing evidence: <latest evidence>
+
+处理策略：
+- 不再自动派发同一问题。
+- 继续处理下一个 open / failed_retest 任务。
+- 该问题留给人工专项检查或后续重新设计。
+```
+
+## 4. Developer Worker worker_done 模板
+
+```bash
+orca orchestration send \
+  --to <coordinator_handle> \
+  --type worker_done \
+  --subject "<task_id> fix ready round <n>" \
+  --body "<修了什么。跑了哪些验证。还有什么风险。>" \
+  --payload '{
+    "taskId": "<orca_task_id>",
+    "dispatchId": "<orca_dispatch_id>",
+    "filesModified": [
+      "<file_a>",
+      "<file_b>"
+    ],
+    "verification": [
+      "<command_a>: passed",
+      "<command_b>: passed"
+    ],
+    "risk": "<remaining risk or none>"
+  }' \
+  --json
+```
+
+## 5. Coordinator 最终报告模板
+
+```text
+本轮闭环完成。
+
+已验证：
+- <task_id>: <what passed>
+
+遗留：
+- <task_id>: 三轮仍未通过，已记录为 leftover。最后失败证据：<evidence>
+
+验证命令：
+- <command>: passed
+
+工作树状态：
+- <repo_path>: <git status summary>
+- <dev_worktree>: <git status summary>
+```