当要把有边界的编码任务交给 Mistral Vibe…

把有边界的编码任务委派给 `vibe` 实现，你负责写简报、运行门禁、审查 diff 并提交。

适用场景

解决思路

1. 检查前置条件：安装 `uv`，然后安装 Mistral Vibe：`uv tool install mistral-vibe`。
2. 检查前置条件：用 `vibe --setup` 配置 API key，或在环境中设置 `MISTRAL_API_KEY`。
3. 检查前置条件：确认 `vibe --version` 成功。
4. 检查前置条件：在目标 git repository 中工作，或用 `--cd` 指向目标仓库。
5. 每个任务按五步循环执行；第 1、4、5 步需要判断，第 2、3 步是机械操作。
6. 第 1 步写简报：Vibe 只能看到你发送的文本以及它能在 workspace 中检查的内容，没有 chat history 或共享上下文。
7. 简报中包括：目标、当前状态、要改什么、不要动什么、项目实际的 gates、报告契约。
8. 告诉 Vibe 不要 commit。
9. 每个简报只放一个任务。参考 `references/writing-the-brief.md`。
10. 默认模式无法在 headless 下批准大多数 shell 命令，因此由 orchestrator 运行 gates；只有人类明确授权 `--full-access` 时，才让 Vibe 运行 gates。
11. 第 2 步派发：使用 bundled helper：`node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo`。
12. helper 会包装 Vibe 的 headless `--prompt` 模式，捕获结构化事件流，并写出 `result.json`。
13. 限制轮次以控制成本：添加 `--max-turns <n>`。
14. 设置指示性价格阈值/token 上限：添加 `--max-price <usd> --max-tokens <n>`。
15. 规划/只读：添加 `--plan-only`。
16. 不受限制的 shell 和工具：添加 `--full-access`（需要明确授权）。
17. 恢复最近 session：添加 `--resume-last`（仅 delta brief）。
18. 恢复特定 session：添加 `--session <id>`（仅 delta brief）。
19. 查看所有选项：`node .../relay.mjs --help`。
20. 子进程的 cwd 会固定 workspace。relay 默认把 artifacts 写到系统 temp dir，并且绝不 commit。参考 `references/dispatch-and-poll.md`。
21. 第 3 步等待完成：helper 会阻塞直到 Vibe 完成。
22. 用 orchestrator 的 background-command facility 运行它，或在 shell 中放到后台并轮询 `result.json`。
23. 运行前 usage error 会退出 2 且不写 result；缺少 `vibe` 会退出 127 并写 `status: "vibe_unavailable"`。
24. watchdog 会写 `status: "timeout"`；在 POSIX 上终止 relay 会在停止 Vibe 的 process tree 后写 `status: "aborted"`。
25. 信任 process state 和 working tree，而不是 progress display。完成意味着进程已退出且 `result.json` 存在。
26. 第 4 步审查——不要信任自报：把 Vibe 的最终消息和 gate 声明当作 claims。
27. 自己重新运行项目的 gates。
28. 对照简报读 diff，先看 `touchedFiles`。
29. 如果安装了相关 guard skills，就运行它们。
30. 在移除或重命名后，round-trip migrations 并用 grep 查找 dangling references。参考 `references/review-and-land.md`。
31. 第 5 步落地：implementer 编辑 working tree；orchestrator 负责 commit。
32. 只有 gates 通过且 diff 站得住后才 commit。
33. 如果需要返工，用 `--resume-last` 或 `--session <id>` 发送 delta brief，然后再次审查。
34. 自主性与权限：在 `--prompt` 模式下 relay 总是显式设置 agent profile。
35. 默认：Vibe 获得 `--agent accept-edits`；用于正常实现——内置文件编辑会被批准。
36. `--plan-only`：Vibe 获得 `--agent plan`；用于只读审查、探索或规划。
37. `--full-access`：Vibe 获得 `--agent auto-approve`；用于明确授权、需要任意 shell/tools 的运行。
38. 默认模式允许 Vibe 编辑目标 worktree 内的文件。需要审批的 shell 命令（包括大多数项目 gates）在 headless 下会被拒绝；由 orchestrator 运行 gates。
39. `--full-access` 会禁用 Vibe 的工具审批，并允许在用户账号下执行任意 shell/tool；仅在有明确人类授权时使用。
40. 每次运行后始终检查 `touchedFiles` 和 diff。
41. 始终传入 `--trust`，以防止 headless 运行中出现交互式 directory-trust prompts。它不是 sandbox，也不授予工具权限。
42. 授权模型：委派需要人类主动选择加入。
43. 一旦人类说了“run this queue”、“proceed”，提交已验证、通过 gates 的工作就是约定契约。
44. 两个限制：surface, don't absorb——报告 Vibe 的设计决策、可辩护但未被要求的改动，以及非阻塞 nitpicks。
45. 两个限制：stop for scope changes——如果正确完成需要超出简报，就询问，而不是扩大授权范围。参考 `references/review-and-land.md`。
46. 参考 `references/writing-the-brief.md`——结构、报告契约、真实 gates、argv delivery 和 delta briefs。
47. 参考 `references/dispatch-and-poll.md`——flags、artifacts、`result.json`、polling 和 failure recovery。
48. 参考 `references/review-and-land.md`——review checklist、commit boundary，以及通过 Vibe sessions 返工。
49. 参考 `references/multi-task-queues.md`——sequential queues、constraint carry-forward、progress tracking 和最终 coherence pass。

适用边界 · 注意事项

• 任务小到可以直接内联完成；委派开销不值得。
• `vibe` CLI 未安装或未认证。
• 用户希望直接写代码而不委派。