SuperAPI AI 工具集

vibe-delegate

编程与开发

查看项目

更新于 10-15 16:48

技能介绍

用途:作为编排者,把边界明确的编码任务交给另一个实现者——Mistral Vibe CLI(vibe),随后审查其产出并自行落地提交。你撰写任务说明并承担判断责任,Vibe 在自身会话中动手,你负责验证与提交。该循环只需 shell 命令和文件访问,任何同类编排器都可驱动。

不适用情形:任务小到可直接内联完成,委派开销不划算;或 vibe CLI 未安装、未认证。

前置条件(检查一次):安装 uv,再安装 Mistral Vibe:uv tool install mistral-vibe;用 vibe --setup 配置 API key,或在环境中设置 MISTRAL_API_KEY;确认 vibe --version 成功;在目标 git 仓库中工作,或用 --cd 指向它。

循环共五步。第 1、4、5 步需要判断,第 2、3 步是机械操作。

  1. 撰写任务说明:Vibe 只能看到你发送的文本和它能在工作区检查的内容,没有聊天历史或共享上下文。需包含目标、当前状态、要改什么、不要动什么、项目实际的质量门(gates)以及报告约定,并要求 Vibe 不要提交。每份说明只放一个任务。默认模式无法在无头环境下批准大多数 shell 命令,因此质量门由编排者运行;仅当人类明确授权 --full-access 时才让 Vibe 运行。
  2. 派发:使用随附助手,它包装 Vibe 的无头 --prompt 模式,捕获结构化事件流并写出 result.json。node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo。可用 --max-turns、--max-price、--max-tokens 控制成本,--plan-only 只读规划,--full-access 放开 shell 与工具(需明确授权),--resume-last 或 --session <id> 续接会话(仅发增量说明)。子进程 cwd 固定工作区;relay 默认把产物写到系统临时目录,且从不提交。
  3. 等待完成:助手会阻塞至 Vibe 结束,可用后台命令运行并轮询 result.json。运行前用法错误退出码 2 且不写结果;缺少 vibe 退出码 127 并写 status: "vibe_unavailable";看门狗超时写 status: "timeout";在 POSIX 上终止 relay 会停止 Vibe 进程树后写 status: "aborted"。以进程状态和工作树为准,完成意味着进程已退出且 result.json 存在。
  4. 审查:不要相信自述。自行重跑项目质量门;从 touchedFiles 开始按说明读 diff;若安装了相关 guard 技能则运行;迁移要往返验证,删除或重命名后要 grep 悬空引用。
  5. 落地:实现者改工作树,编排者提交。仅在质量门通过且 diff 成立后提交。需要返工时用 --resume-last 或 --session <id> 发增量说明,然后重新审查。

自主性与权限:--prompt 模式下 relay 始终显式设置 agent profile。默认使用 --agent accept-edits(批准内置文件编辑);--plan-only 使用 --agent plan(只读);--full-access 使用 --agent auto-approve(需明确授权,允许任意 shell/工具)。默认模式允许 Vibe 在目标工作树内编辑文件,但无头环境下需批准的命令(含多数质量门)会被拒绝,由编排者运行质量门。--full-access 会关闭工具审批,在用户账户下允许任意 shell/工具执行,仅在人类明确授权时使用;每次运行后都应检查 touchedFiles 与 diff。--trust 始终传入以避免无头运行的目录信任交互提示,它不是沙箱,也不授予工具权限。

授权模型:委派需人类主动选择。一旦人类说“运行这个队列”“继续”,提交已验证且通过质量门的工作就是约定契约。两个限制:暴露而非吸收(报告 Vibe 的设计决定、可辩护但未被要求的改动、非阻塞的小问题)以及范围变更时停下(若正确完成需要超出说明,应询问而非扩大授权)。

参考资料:references/writing-the-brief.md(说明结构、报告约定、真实质量门、argv 传递与增量说明)、references/dispatch-and-poll.md(标志、产物、result.json、轮询与失败恢复)、references/review-and-land.md(审查清单、提交边界、通过 Vibe 会话返工)、references/multi-task-queues.md(顺序队列、约束传递、进度跟踪与最终一致性检查)。