概要
GitHub Issueを作成すると自動でPull Requestまで作成してくれる仕組みを、完全無料で構築する。Claude Code GitHub ActionsやGitHub Copilot Coding Agentは高機能だが無料枠が事実上存在しないため、GitHub Models(GitHubアカウントだけで使える無料LLM推論API)をベースに自作のGitHub Actionsワークフローを組む方式を採用する。
トリガー条件は「Issue本文中に@claude(または任意の合図)を含めたときのみ動作」とする。
詳細説明
なぜGitHub Modelsなのか
| 選択肢 | 無料か | 備考 |
|---|---|---|
| GitHub Copilot Coding Agent | ✕ | Pro($10/月〜)以上が必須。無料プランには含まれない |
| Claude Code GitHub Actions | △ | Anthropic APIに恒久無料枠なし。新規登録時の$5トライアルクレジットのみ |
| Cursor Automations | ✕ | Cursor Pro相当の契約が前提 |
| GitHub Models | ○ | GitHubアカウントのGITHUB_TOKENにmodels: read権限を付けるだけで、追加登録・追加課金なしに利用可能 |
GitHub Modelsは、GitHub Actionsワークフロー内で組み込みのGITHUB_TOKENにmodels: read権限を追加するだけで、追加のAPIキー取得手続きなしにLLM推論を呼び出せる。ワークフローが実行するのはあくまで「単発のLLM呼び出し」であり、Claude Agent SDKのような「ファイル読み書き・テスト実行・エラー修正の自律ループ」機能は持たない。そのため、実現できるのは「Issue文面をもとに単一ファイル相当のコードを生成し、それをブランチにコミットしてPRを作る」という比較的シンプルな範囲にとどまる。
全体の処理フロー
- Issueが作成される(本文に
@claudeのような合図フレーズを含む) on: issues: openedイベントでGitHub Actionsワークフローが起動- ワークフロー内でIssue本文に合図フレーズが含まれるかをチェック(条件分岐)
- GitHub Models APIにIssue内容を渡し、実装案・コードを生成させる
- 生成されたコードで新しいブランチを作成しコミット
gh pr create等でPRを作成
実装の骨子
1. 権限設定
ワークフローファイルのpermissionsに以下を指定する。
permissions:
contents: write # ブランチ作成・コミットに必要
models: read # GitHub Models呼び出しに必要
pull-requests: write # PR作成に必要
issues: read # Issue内容の読み取りのみ(write権限は与えない)必要最小限の権限のみ付与するのが公式推奨。Issue内容を読むだけならissues権限をwriteにしないなど、悪意あるIssue内容がモデルに不正な指示を注入するリスクを抑える設計にする。
2. モデル呼び出しの2つの方法
- 公式アクション
actions/ai-inference@v1を使う方法(model名・system-prompt・promptを渡すだけ) - 直接API(
https://models.github.ai/inference/chat/completions)にcurlでPOSTし、Authorization: Bearer $GITHUB_TOKENヘッダーを付ける方法
3. モデル選択
OpenAI GPT-4o(複雑な分析向け)、GPT-4o mini(軽量タスク向け)、Meta Llama 3.1(8B/70B/405B)などから選べる。単一ファイル生成程度であればGPT-4o miniで十分な可能性が高い。
4. Issue→ブランチ→PRの結線
LLMの出力(生成コード)をファイルとして書き出し、git checkout -bでブランチを作成、コミットしてからgh pr createでPRを開く、という一連の処理をワークフローのシェルステップとして自分で記述する必要がある。ここは既製品(Copilot Coding Agent等)が内部で自動化している部分にあたる。
図解
flowchart LR A["Issueを作成\n(本文に@claudeなど合図フレーズ)"] --> B["Actionsワークフロー起動\n(on: issues: opened)"] B --> C{"合図フレーズを\n含むか判定"} C -- Yes --> D["GitHub Models API呼び出し\n(models: read 権限のGITHUB_TOKEN)"] D --> E["LLMが実装案・コードを生成"] E --> F["ブランチ作成 → コミット\n(git / github-script)"] F --> G["PR作成\n(gh pr create)"] C -- No --> H["何もしない"]
まとめ
- Claude Code GitHub Actions・GitHub Copilot Coding Agent・Cursor Automationsはいずれも無料では継続運用できず、GitHub Modelsが唯一の完全無料ルート。
- GitHub Modelsは「単発のLLM呼び出しAPI」であり、自律的なエージェントループ(ファイル操作・テスト・自己修正の反復)は持たないため、既製のCloud Agent系サービスに比べると自作すべき範囲が広い。
- 実現可能な範囲は「Issue文面→比較的シンプルなコード生成→PR化」程度。複雑なマルチファイル修正やテスト駆動の反復修正には不向き。
- セキュリティ面では、Issueは誰でも書き込める入力経路になりうるため、ワークフローの権限は必要最小限に絞ることが重要(プロンプトインジェクション対策)。
- 今後、より高度な自律修正(テスト失敗時の自己修正ループなど)が必要になった場合は、コスト面を許容してClaude Code GitHub ActionsのAPI従量課金に切り替える、という段階的な移行も選択肢になる。
参考リンク
- Quickstart for GitHub Models(GitHub公式ドキュメント)
- Automate your project with GitHub Models in Actions(GitHub Blog)
- Solving the inference problem for open source AI projects with GitHub Models(GitHub Blog)
- actions/ai-inference(GitHub公式アクション)
- Claude Code GitHub Actions(比較検討時の参照)