用途:当需要把规格明确的实现任务交给 xAI 的 Grok Build CLI 无头执行时使用,也可按 Markdown 实施计划逐任务执行并在每步后做 diff 审查。用户说“use grok”“grok build”“have grok implement”或“send to grok”时触发。编排者负责规划、撰写自包含任务规格、派发任务、审查每个 diff 并拥有最终结果。
安全门:每次派发前,向用户展示将发送给 xAI 的完整任务规格、目标 worktree 和权限模式,获得明确批准;任务规格中绝不包含机密、专有源码、客户数据或凭据。未经单独明确批准,不运行 grok update、--always-approve 或破坏性恢复命令。
会话预检(首次派发前一次):运行 grok update --check --json,若 updateAvailable 为 true 告知用户;仅在明确批准后运行 grok update,再用 grok --version 确认。运行 grok models,若报错或显示未登录,停止并请用户运行 grok login。
逐任务循环(默认串行):1)写规格,保存到目标仓库外的临时目录,如 POSIX 下 mkdir -p "${TMPDIR:-/tmp}/grok-specs" 后写 task.md,Windows 下 New-Item -ItemType Directory -Force "$env:TEMP\grok-specs";Grok 无对话上下文,不能只用一句话提示。2)保持干净状态,无未提交源码改动,先提交或贮藏。3)派发,POSIX 示例:grok --prompt-file <task-file> --output-format json --always-approve --max-turns 30 --cwd <repo>;Windows 用反引号续行。解析 JSON 输出并保存 sessionId。4)审查门(不可跳过):自己阅读 diff(git diff -- <files from the spec>),运行规格中的验收命令;通过则按仓库惯例提交,失败则先询问用户。
任务规格模板含标题、上下文(仓库、惯例)、文件(修改/创建)、任务描述、约束、验收标准。执行 Markdown 计划时每次派发一个任务,完成后勾选复选框。仅当计划明确标记任务独立时才可并行,用 --worktree=<task-slug>,然后逐个审查合并;合并冲突常抵消收益,优先串行。
失败处理:stopReason 为 Cancelled、空文本或无 diff 通常因缺少 --always-approve,补上重试;CLI 错误或超时重试一次,之后自己做并记录回退;认证过期停止并请用户 grok login;两轮修复耗尽则保留 diff 请用户决定;派发时树脏则拒绝,先提交或贮藏。
限制:Grok 是第三方服务,不应接收机密、专有材料、个人或客户数据;--always-approve 仅在干净且明确批准的 worktree 使用,且不能替代审查;模型输出可能错误、不安全、不完整或超范围,接受前必须审查并运行验收检查;本技能不授权安装、更新、提交、推送、部署或破坏性清理。默认模型 grok-4.5,仅琐碎机械任务可加 -m grok-composer-2.5-fast。