Gemma Runner 用于通过共享的 pi-runner 实现，以 Gemma 席位执行提示词。它取代了此前基于 Cline 的垫片：每次调用都会固定 --provider openrouter --model google/gemma-4-31b-it，因此该席位不再依赖 Cline 可变状态所指向的提供商；给出回答的始终是转发的 Gemma 模型，经由 OpenRouter 提供服务。
默认模型
google/gemma-4-31b-it，每次运行都固定为 --provider openrouter --model google/gemma-4-31b-it。可通过 --model 覆盖，将 Gemma 席位指向其他 OpenRouter 模型 id。
前置条件
- 已安装 pi CLI 并在 PATH 中（npm install -g @mariozechner/pi-coding-agent）
- 环境中存在 OPENROUTER_API_KEY（或 Pi 认证存储中有 OpenRouter 凭据）
安全模型
该技能委托给 pi-runner，因此具有与 Pi 包装器相同的执行和数据共享模型——参见 ../pi-runner/SKILL.md。运行是封闭式的（不加载扩展、技能或 AGENTS.md/CLAUDE.md 发现）。分析类角色（除 implementer 外的所有角色）默认处于只读模式（仅启用 Pi 的文件读取工具）。传入 --allow-write 可选择退出，或传入 --no-tools 完全阻止工具。
共享包装器参考
支持的选项、角色、--json 输出信封键契约、返回码和注意事项与共享包装器完全相同——请阅读 shared/references/runner-common.md 了解共享标志、信封键、返回码和席位保真规则。信封由 pi-runner/scripts/run_pi.py 生成，其中 runner=gemma、effective_runner=pi、effective_provider=google（从 google/... 模型 id 推断）；native_provider=openrouter 是服务网关。
使用方式
python3 .agents/skills/gemma-runner/scripts/run_gemma.py "your prompt here"
示例
python3 .agents/skills/gemma-runner/scripts/run_gemma.py "Summarize the core module architecture" python3 .agents/skills/gemma-runner/scripts/run_gemma.py --prompt-file /tmp/review.md --role synthesizer python3 .agents/skills/gemma-runner/scripts/run_gemma.py "Read-only analysis" --restrict-tools --json python3 .agents/skills/gemma-runner/scripts/run_gemma.py "Answer from the brief only" --no-tools --json
行为
- 委托给共享的 pi-runner 实现，runner 身份设为 gemma（信封报告 runner=gemma、effective_runner=pi）。
- 每次调用都固定 --provider openrouter --model google/gemma-4-31b-it，因此实际回答的是 Gemma 席位——不存在可将其静默改道的可变提供商状态。
- 绝不回退到其他提供商。缺少 CLI 会明确阻止该席位（status: seat_unavailable，return_code -2）；缺少凭据会报告 status: auth_missing 且 auth_ok: false——这就是席位保真，即每个 runner 都遵守的不变量：绝不用其他模型的回答替代 Gemma 席位。
- 保留共享包装器信封，以便 council 能一致地比较 Gemma 输出与其他 runner。
迁移说明
该技能不再使用基于 Cline 的垫片——它现在仅依赖 pi 和 OPENROUTER_API_KEY。Minimax 仍委托给 cline-runner，不受影响。如果其他工具仍直接调用 cline，也不受此更改影响。
集成
agents/openai.yaml 将该技能暴露为原生 Codex 应用子代理席位（Codex UI 显示元数据和默认提示词）；请勿移除。