用途
grok-delegate 是一个面向编排型 AI 代理的技能文档,用于在用户明确要求时将范围有限的编程任务委派给独立的 Grok Build CLI(grok)实现器,然后由编排者(即使用该技能的代理)负责审查产出并提交代码。它不依赖特定的编排代理,只要代理能执行 shell 命令和读取文件即可使用。文档说明其设计目标为 Claude Code 和 Cursor,其他编排器被视为“设计支持但尚未验证”。
主要能力
该技能定义了一个五步委派循环:
- 撰写简报:简报应包含目标、当前状态、需要修改的内容、不应触碰的内容、项目实际的检查命令(从 CLAUDE.md/AGENTS.md/Makefile 中发现,而非假设),以及报告契约。明确告知 Grok 不会提交代码(由编排者提交)。每个简报只包含一个任务。
- 派发:提供了运行
scripts/relay.mjs的示例命令,支持--read-only(只读审查/诊断)、--resume-last(继续上一个 Grok 会话)和--timeout(硬性时间限制)等选项。注意该分发仅包含文档,scripts/relay.mjs缺失,需从上游获取、固定并审查运行时后再使用示例命令。 - 等待完成:继电器会阻塞直到 Grok 完成。文档给出了在不同编排器中后台运行的方法(如 Claude Code 的
run_in_background: true,普通 shell 的后台运行与轮询结果文件)。运行完成的标志是result.json存在且包含状态。 - 审查:不信任 Grok 的自报告,需自行重新运行项目的检查命令,对照简报阅读差异,检查是否有范围蔓延或遗漏,可使用 guard 技能(如 clean-code-guard、test-guard)判断产出。
- 提交:仅在检查通过且差异符合要求后,由编排者提交已验证的工作。如需修改,使用
--resume-last发送增量简报并再次审查。
使用方式
使用前需要检查前置条件:grok version 成功;若未安装,可使用 npm i -g @xai-official/grok 安装并认证(grok login、grok login --device-auth 或设置 XAI_API_KEY);确认 PATH 中的 grok 二进制;位于目标 git 仓库中或通过 --cd 指向仓库。
继电器默认使用写能力(workspace-write)自治配置:--always-approve --sandbox workspace,并将产物写入临时目录,使待审查的仓库保持干净。--read-only 使用 --sandbox read-only --permission-mode plan,但文档明确指出这是尽力而为而非硬性保证,需事后检查 touchedFiles。--full-access 使用 --always-approve --sandbox off,仅在明确需要无限制工具时使用。
适用场景
适用于用户明确要求将范围有限的编程任务委派给 Grok Build 实现器,并希望由编排者自行审查差异和提交的场景。不适用于任务小到可以直接内联完成(委派开销不值得)、grok CLI 未安装/未认证/账户无 Grok Build beta 访问权限,或只想审查而不需要实现器运行的场景。
限制
- 该分发为仅文档导入,可执行脚本
scripts/relay.mjs未包含,需参考上游获取完整运行时。 - 需要 grok CLI、Node 18+、git。
- 继电器从不提交,只返回结构化结果 JSON;编排者负责审查和提交。
--read-only是尽力而为,不是硬性保证,最终以差异审查为准。- 文档改编自 amElnagdy/delegate-skills(MIT),仅文档,运行时未捆绑。