Files
.pouch/kits/ack/core/prompt-templates.md
T
2026-07-07 09:44:55 +08:00

6.2 KiB
Raw Blame History

派发 Prompt 模板(稳定核心)

Coordinator 用这些模板向 Developer 派发修复、向 Test 派发复测。复制时替换尖括号占位符。模板与编排工具无关:Orca 模式用 orca-adapter.md 的命令投递,手动模式直接把文本发给对应 Agent。

角色分工见 roles-and-permissions.md;闭环顺序见 closed-loop.md

派发时除了具体任务,Coordinator 应把对应角色的能力要求一并带上(roles-and-permissions.md §「三角色能力清单」的 Must Do / Must Not)。下面模板已内置关键条目,复制即可。


0. 可选 skills 路由(装了才用,不阻塞)

如果 worker 所在环境已安装以下 skill,可在对应环节调用以获得更强 playbook;未安装则按 roles-and-permissions.md 的能力清单执行:

  • Coordinator 规划复杂需求:/thinksuperpowers:brainstorming / writing-plans
  • Developer 排查缺陷:/huntsuperpowers:systematic-debugging;行为变更:superpowers:test-driven-development
  • Test 复测 / 合并前检查:/checksuperpowers:verification-before-completion

派发时可加一行:「若已安装 ,本环节可用它;未安装按 ack 角色能力清单执行。」


1. 初始派发给 Developer

你现在接到一个受监督的协作任务。请在 <dev_worktree> 开发工作树内完成。

任务:
- 修复 <task_id>: <task_title>

请先读取:
- <overlay_file>(项目覆盖层,路径见 tasks.yaml 的 project.overlayFile
- tasks.yaml
- <relevant_spec_or_test_doc>

当前失败证据:
<copy latest Test evidence>

验收标准(可观测信号,见 optimization-method.md §1):
1. <expected behavior 1>
2. <expected behavior 2>
3. <expected behavior 3>

能力要求(见 roles-and-permissions.md §三角色能力清单 · Developer):
- 动手前先复现失败现象,或先写一个会失败的测试再修。
- bug 修复配可复现的失败用例;行为变更配单元测试。
- 完成前亲自走一遍验收路径,不只满足静态文案。
- 若是网站 / 常驻服务,改完重启服务并确认生效,别让 Test 测到旧进程或旧构建。

约束:
- 只修改 Developer 可写路径(见覆盖层文件的权限表)。
- 不要修改产品规格和集成测试文件(分别由 Coordinator 与 Test 拥有),除非任务明确要求。
- 不要写 tasks.yaml,不要标记 verified。
- 不要提交或推送,除非用户明确要求。
- 最小 diff,只改本任务根因,避免无关重构;若必须先重构请停下说明并请示。

完成前必须运行:
- <test command 1>
- <test command 2>

完成后回报一次 worker_done(格式见 §4)。如果阻塞,请发送 escalation 或 ask。

2. 复测失败再派发给 Developer

第 <n> 轮复测未通过,请继续修 <task_id>。

上一轮开发声称:
<worker_done summary>

Test 独立复测结果:
- 运行命令:<commands>
- 失败页面/API<page or endpoint>
- 仍缺失:<missing expected checks>
- 实际观察:<actual evidence>

关键提示:
- 不要只满足静态文案,必须满足交互后的真实状态。
- 如果后端/API 正常而 UI 不更新,请优先排查事件链、状态重置、异步请求、构建产物和服务 worktree。
- 修复后请自己用浏览器或脚本复现 Test 的完整步骤。

验收不变:
<copy acceptance criteria>

完成后回报 worker_donesubject 使用:"<task_id> fix ready round <n>"

3. 派发给 Test 复测

Developer 回报 worker_done 后,Coordinator 把复测任务发给 Test。

请对 <task_id>: <task_title> 做独立黑盒复测。

请先读取:
- <overlay_file>(项目覆盖层,路径见 tasks.yaml 的 project.overlayFile
- tasks.yaml(该任务的验收信号)
- <relevant_spec_or_test_doc>

Developer 本轮声称(仅供参考,不作数):
- 改动文件:<files>
- 自测命令:<commands>

复测要求(见 roles-and-permissions.md §三角色能力清单 · Test):
- 先对齐运行环境(pwd / 分支 / commit / 服务 worktree,见 closed-loop.md),避免测错实例或旧构建;网站类先确认服务已按新代码重启。
- 网站类任务优先用浏览器复测真实交互,其次才是 API / 脚本。
- 逐条验证下列验收信号,不要只看静态文案,要验证交互后的真实状态:
  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 还是手动,回报都应包含以下字段:

subject: <task_id> fix ready round <n>
filesModified: [<file_a>, <file_b>]
verification:
  - <command_a>: passed
  - <command_b>: passed
reproduce: 我如何复现验收路径 <steps>
risk: <remaining risk or none>

Orca 模式下用 orca-adapter.md §「Developer 回报 worker_done」的命令发送同样的字段。


5. Test 复测报告格式

Test 只回传证据和逐条结论,不下最终判定:

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 最终报告模板

本轮闭环完成。

已验证(Test 复测通过 + 终检):
- <task_id>: <what passed>

遗留:
- <task_id>: 三轮仍未通过,已记录为 leftover。最后失败证据:<evidence>

验证命令:
- <command>: passed

工作树状态:
- <repo_path>: <git status summary>
- <dev_worktree>: <git status summary>