gemma-runner

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. ランナーの識別情報を gemma に設定して、共有の pi-runner 実装に処理を委任します（エンベロープには 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 と報告します。これは担当モデルの忠実性を保証するものであり、すべてのランナーが守る不変条件です。Gemma の担当に別のモデルの回答を代用することはありません。
4. 共有ラッパーのエンベロープを維持するため、各協議会は Gemma の出力を他のランナーと一貫した形式で比較できます。

移行に関する注意

このスキルでは Cline ベースのシムを使用しなくなり、pi と OPENROUTER_API_KEY のみに依存します。Minimax は引き続き cline-runner に処理を委任するため、影響を受けません。他のツールが引き続き cline を直接シェルから呼び出す場合も、影響はありません。

統合

agents/openai.yaml は、このスキルを Codex アプリのネイティブなサブエージェント担当として公開します（Codex UI の表示メタデータとデフォルトのプロンプト）。削除しないでください。