Grok Runner 用于在无头打印模式下执行外部 Grok CLI 提示词，主要面向明确需要调用 Grok CLI、或所选 Grok 路由无法作为原生宿主执行的场景。
用途：通过本地已认证的 grok CLI 在 print 模式下执行调用方限定范围的提示词。共享角色、信封键和结果处理定义在共享引用文件 runner-common.md 中。
使用方式：首先使用 shared/references/model-preview.md 选择分支。确定性检查无需模型选择。实际派发使用一个具体的已批准快照；嵌套调用直接消费该快照，不再重新解析或启用额外 worker。调用时在同一 shell 调用中设置 SKILL_DIR 为已加载技能目录的绝对路径，然后运行：
SKILL_DIR="<absolute path of this skill directory>";
python3 "$SKILL_DIR/scripts/run_grok.py" "<scoped prompt>"
--model <approved-model-id> --effort <approved-effort> --disable-fallback --json
需要从选定快照中复制确切的模型与 effort，并附加其角色、工具模式、回执策略与限制。仅在所选运行时受控路由下才可省略 effort 标志。嵌套调用沿用已保存的选项，不再重新解析默认值。示例不授予源代码共享或工具权限。
原生路由：选择外部路由前需阅读 shared/references/host-model-execution.md。如果当前宿主能在原生子智能体或任务线程中，以所需的 effort、隔离和回执策略派发所选的确切 Grok 模型，则应使用该原生路由。agents/openai.yaml 是宿主 UI 元数据，不负责派发原生模型。
运行时边界：使用本地已认证 grok CLI 的 print 模式。分析角色默认强制执行只读计划模式。--restrict-tools 强制计划模式；--allow-write 在调用方授权范围内选择退出只读。提示词与文件上下文可能被发送到所配置的提供方。会话持久化于 ~/.grok；原生 CLI 没有持久化退出选项。原生 modelUsage 回执标识实际服务模型。直接调用不支持的 effort 值会被钳制并报告；已批准路由必须满足其确切计划。不允许回退。CLI 缺失视为不可用 seat，绝不用其他模型的答案替代。结构化输出在原生 schema 约束后于本地校验。退出码为零并不代表畸形输出成功。
按需加载：references/command-reference.md 用于组合非基础调用时的标志、示例、原生映射与返回码。references/runtime-reference.md 用于配置路由或解释结果时的认证、回退条件、配置与扩展信封字段。references/continuation.md 仅在恢复会话或管理后台任务时使用。
结果处理：读取 agent_message 与包装信封。检查 success、服务模型回执、有效 runner/provider，以及任何回退或畸形输出状态。仅进程完成并不能证明使用了所请求的任务或模型。当调用方授权编辑时，报告所触及的文件。
限制：模型、effort、快照等具体可用值、价格与平台信息未在资料中提供。