用途:把 Grok Build 当作同一台机器上的独立编码智能体,由 Codex 等监督方智能体委托有边界的任务,例如调查、审查、实现或提供另一种意见。它是外部任务,不进入 Codex 的原生 spawn_agent 树,也不继承其对话内容。
前提:Grok Build 需已安装并配置好。使用项目的 Python 3.12+ 解释器运行脚本,客户端只用标准库;若项目无解释器,可用 uv run --python 3.12 的方式。脚本路径要相对已安装技能解析。
主要能力与用法:客户端会启动 grok agent --no-leader stdio,保持 ACP 会话,并立即返回 task_id。委托时需给出目标、绝对工作目录、相关文件与证据、范围边界,以及证明完成所需的检查。主要命令包括 start、wait、status、reply、cancel、close;wait 的超时只返回当前状态并不取消任务,reply 用于继续同一会话,不再需要追问时 close。--help 是命令参考,输出字段、存储、超时和排障见 references/client.md。
配置与权限:默认继承 Grok 的模型、认证和权限配置;start 的 --model、--effort、--permission-mode、--sandbox 是逐任务覆盖项,不需要时省略。--effort 应按任务复杂度、错误代价和可核查性选择,不确定时省略以继承配置。权限应与授权范围匹配,只读任务保留只读限制。状态为 needs_approval 时,查看 pending_permissions 并用 permission 命令按 Grok 实际提供的选项回应,优先单次批准。配置的 Grok 允许规则可能无需 ACP 审批,只读提示词或拒绝请求并不等于操作系统沙箱。
监督与限制:避免两个智能体同时编辑同一文件,需要时用独立 worktree 并通过 --cwd 传入绝对路径,该工具不创建 worktree。返回 task_id 只表示工作进程已启动,completed 也不代表结论已验证,须检查实际改动或证据并运行相关检查。若 Grok 不可用或安装、认证等失败,应明确告知用户并检查部分结果,不要擅自替换为自身或其他智能体。