This commit is contained in:
2026-07-07 00:53:54 +08:00
parent d7a74578dc
commit 6bd03c2f6d
13 changed files with 272 additions and 129 deletions
@@ -1,10 +1,12 @@
# 派发 Prompt 模板(稳定核心)
用于 Coordinator 给 Developer Worker 派发任务。复制时替换尖括号占位符。这些模板与编排工具无关:Orca 模式用 `orca-adapter.md` 的命令投递,手动模式直接把文本发给 Developer
Coordinator 用这些模板向 **Developer** 派发修复、向 **Test** 派发复测。复制时替换尖括号占位符。模板与编排工具无关:Orca 模式用 `orca-adapter.md` 的命令投递,手动模式直接把文本发给对应 Agent
角色分工见 `roles-and-permissions.md`;闭环顺序见 `closed-loop.md`
---
## 1. 初始派发模板
## 1. 初始派发给 Developer
```text
你现在接到一个受监督的协作任务。请在 <dev_worktree> 开发工作树内完成。
@@ -18,7 +20,7 @@
- <relevant_spec_or_test_doc>
当前失败证据:
<copy latest Product/Test evidence>
<copy latest Test evidence>
验收标准(可观测信号,见 optimization-method.md §1):
1. <expected behavior 1>
@@ -27,7 +29,7 @@
约束:
- 只修改 Developer 可写路径(见 AGENTS.md 权限表)。
- 不要修改 Product/Test 负责的规格和集成测试文件,除非任务明确要求。
- 不要修改产品规格和集成测试文件(分别由 Coordinator 与 Test 拥有),除非任务明确要求。
- 不要写 tasks.yaml,不要标记 verified。
- 不要提交或推送,除非用户明确要求。
- 最小 diff,避免无关重构。
@@ -41,7 +43,7 @@
---
## 2. 复测失败再派发模板
## 2. 复测失败再派发给 Developer
```text
第 <n> 轮复测未通过,请继续修 <task_id>。
@@ -49,7 +51,7 @@
上一轮开发声称:
<worker_done summary>
Product/Test 独立复测结果:
Test 独立复测结果:
- 运行命令:<commands>
- 失败页面/API<page or endpoint>
- 仍缺失:<missing expected checks>
@@ -58,7 +60,7 @@ Product/Test 独立复测结果:
关键提示:
- 不要只满足静态文案,必须满足交互后的真实状态。
- 如果后端/API 正常而 UI 不更新,请优先排查事件链、状态重置、异步请求、构建产物和服务 worktree。
- 修复后请自己用浏览器或脚本复现 Product/Test 的完整步骤。
- 修复后请自己用浏览器或脚本复现 Test 的完整步骤。
验收不变:
<copy acceptance criteria>
@@ -68,7 +70,40 @@ Product/Test 独立复测结果:
---
## 3. Developer Worker worker_done 回报格式(通用)
## 3. 派发给 Test 复测
Developer 回报 worker_done 后,Coordinator 把复测任务发给 Test。
```text
请对 <task_id>: <task_title> 做独立黑盒复测。
请先读取:
- AGENTS.md
- tasks.yaml(该任务的验收信号)
- <relevant_spec_or_test_doc>
Developer 本轮声称(仅供参考,不作数):
- 改动文件:<files>
- 自测命令:<commands>
复测要求:
- 先对齐运行环境(pwd / 分支 / commit / 服务 worktree,见 closed-loop.md)。
- 逐条验证下列验收信号,不要只看静态文案,要验证交互后的真实状态:
1. <observable signal 1>
2. <observable signal 2>
3. <observable signal 3>
- 需要时把易反复误判的路径沉淀成可执行测试(见 optimization-method.md §8)。
约束:
- 只读源码,不修改应用代码,不写 tasks.yaml。
- 只回传证据和逐条结论,最终判定由 Coordinator 终检后落盘。
完成后回报一次复测报告(格式见 §5),subject"<task_id> retest round <n>"。
```
---
## 4. Developer worker_done 回报格式
无论 Orca 还是手动,回报都应包含以下字段:
@@ -86,12 +121,37 @@ Orca 模式下用 `orca-adapter.md` §「Developer 回报 worker_done」的命
---
## 4. Coordinator 最终报告模板
## 5. Test 复测报告格式
Test 只回传证据和逐条结论,不下最终判定:
```text
subject: <task_id> retest round <n>
env:
worktree: <path>
branch: <branch>
commit: <short sha>
baseUrl: <base_url>
commands:
- <command_a>: passed/failed
signals:
- <signal 1>: pass/fail (<evidence>)
- <signal 2>: pass/fail (<evidence>)
browser: <snapshot / DOM / API evidence>
conclusion: all-signals-pass / signals-failed
notes: <observations, suspected cause if failed>
```
Orca 模式下用 `orca-adapter.md` §「Test 回报复测结果」的命令发送同样的字段。
---
## 6. Coordinator 最终报告模板
```text
本轮闭环完成。
已验证:
已验证Test 复测通过 + 终检)
- <task_id>: <what passed>
遗留: