其他
需要显式 `/orchestrate <goal>`…
当用户显式输入 `/orchestrate <goal>` 要把大任务分解到并行 Cursor cloud agents 时,用规划器/子规划器/worker/verifier 树和结构化 handoff 完成编排。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 38/100 ×0.15
适用场景
需要显式 `/orchestrate <特定
解决思路
- 仅通过显式 `/orchestrate <goal>` 将大任务扇出到并行 Cursor cloud agents;Workers 彼此不通信,只通过结构化 handoff 向上汇报。
- 将 spawn、wait、handoff 循环放在 `scripts/cli.ts` 中。
- 由 planner 写 `plan.json`,脚本执行它,planner 读取 handoffs 决定下一步。
- 长期运行的 agent 循环会漂移;使用带 JSON 状态文件的脚本保持其稳定。
- 必读 `cursor-sdk` skill([cursor/plugins/cursor-sdk](https://github.com/cursor/plugins/tree/main/cursor-sdk));Spawning、auth 和错误分类都在那里,不要重新实现该 skill 已记录的内容。
- 配置 `CURSOR_API_KEY` 必须是 personal/user key;从 Cursor Dashboard > Integrations 创建,然后在使用前阅读 `cursor-sdk` 的 Auth。
- 可选配置 `SLACK_BOT_TOKEN`:设置后,向 `kickoff` 或第一个 `run --root` 传 `--slack-channel <id>`,或设置 `SLACK_CHANNEL_ID`;脚本把 channel 存入 `plan.slackChannel`,在那里发布 kickoff thread,同步任务状态,并读取 Andon reactions;未设置 token 时,脚本记录一次日志并在没有 Slack 可见性的情况下运行,正确性不变。
- Planner 拥有 scope 并发布 tasks,不写代码:写 `plan.json`、读 handoffs、决定下一步是 planner 工作;编辑文件、运行 `git merge`、内联修复冲突不是;若 planner 想写代码,改为发布一个 task 给 worker。
- Planner 不知道谁接手 tasks;脚本把每个 task 路由到 cloud agent;planner 的心智模型停留在 task 层。
- Worker 相互隔离;一个 task、一个 repo clone、不与其他任何 agent 有 channel;完成时提交一个 handoff。
- Subplanner 是递归 planner;planner 发布一个“subplan this slice”task,subplanner 完全拥有该 slice,并交回聚合 handoff。
- 通过 handoffs 保持持续运动;自认为完成的 planner 可以收到迟到 handoff 并重新规划;在 planner 决定停止发布前没有“finished”状态。
- 传播而非同步;兄弟节点之间不交谈;层级之间不共享状态;每一层只看其 children 的 handoffs。
- Planner:运行循环;scope 为整个用户目标;输出面向用户消息 + 可选 PR。
- Subplanner (↻):运行循环;scope 为 parent's scope 的一个 slice;输出给 parent 的 handoff。
- Worker:不运行循环;scope 为一个具体 task;输出给 spawning planner 的 handoff。
- Verifier:不运行循环;scope 为一个 target 的 acceptance criteria;输出给 spawning planner 的 verdict handoff。
- Git:不运行循环;作为 shared medium;输出 branches (code) + `handoffs/` (meaning)。
- 两个角色共用一个 skill;阅读你的角色参考文件,并跳过另一个。
- Dispatcher:在本地 IDE session 中用户输入 `/orchestrate <goal>` 时,启动一个 cloud root planner 并返回其 URL;参见 `references/dispatcher.md`;这是一次性操作;你不是 planner。
- Planner(root 或 sub):当你被以结构化 prompt 启动,且开头是“You are the root planner for:”或“You are a subplanner for:”,或用户选择在本地运行 planning loop 时;你拥有一个 scope,发布 tasks,读 handoffs,决定下一步;参见 `references/planner.md`。
- `disable-model-invocation: true` 表示此 skill 只在显式调用时加载。
适用边界 · 注意事项
- 不要在用户未显式输入 `/orchestrate <goal>` 时自主调用;该技能只在显式调用时加载。
- 没有 Cursor SDK 或 `CURSOR_API_KEY`(且为 personal/user key)时不可用。
- 如果任务不是需要分解的大任务,或不需要并行 cloud agents,不要使用。