mcpField
G
gemma-runner

gemma-runner

github.com/robsonrungAgent 工作流246 次安装1 天前更新
代码仓库

关于 gemma-runner

gemma-runner 是通过共享 pi-runner 实现调用固定 Gemma 模型的技能，适用于需要稳定 Gemma 执行席位并统一比较运行结果的工作流。

主要功能

  1. 01通过 OpenRouter 固定 Gemma 模型
  2. 02使用共享 pi-runner 执行
  3. 03分析角色默认只读
  4. 04提供 JSON 输出封装
  5. 05不回退到其他提供方

适用场景

  1. 01以 Gemma 执行席位运行提示词
  2. 02在 council 中比较运行结果
  3. 03以只读方式分析文件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/robsonrung/rar-skills --skill gemma-runner

安装后在 Claude Code 中输入/gemma-runner确认已加载。

附带文件agents/openai.yamlscripts/run_gemma.py

详细介绍

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 指定其他 OpenRouter 模型 ID，为 Gemma 席位更换模型。

前置条件

  • 已安装 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

行为

  1. 委托给共享的 pi-runner 实现，并将 runner 身份设为 gemma（封装中报告 runner=gemma、effective_runner=pi）。
  2. 每次调用都会固定使用 --provider openrouter --model google/gemma-4-31b-it，因此实际作答的就是 Gemma 席位对应的模型——不存在可能暗中将请求改道的可变提供方状态。
  3. 绝不回退到其他提供方。如果缺少 CLI，会明确阻止该席位（status: seat_unavailable、return_code -2）；如果缺少凭据，则报告 status: auth_missing 和 auth_ok: false——这就是席位保真，也是每个 runner 都遵循的同一不变原则：绝不以其他模型的回答替代 Gemma 席位的回答。
  4. 保留共享包装器的封装，以便 council 能够一致地将 Gemma 的输出与其他 runner 的输出进行比较。

迁移说明

此技能不再使用基于 Cline 的适配层——现在仅依赖 pi 和 OPENROUTER_API_KEY。Minimax 仍委托给 cline-runner，不受影响。如果其他工具仍直接通过 shell 调用 cline，也不受此次变更影响。

集成

agents/openai.yaml 将此技能作为原生 Codex 应用子 Agent 席位公开（Codex UI 显示元数据和默认提示词）；请勿将其移除。

评论

支持 Markdown