GitHub Actionsでエージェント型ワークフローを開発する

GitHub Agentic Workflowsを使用して、Markdown の指示をサードパーティのコーディング エージェントを利用した自動化に変換します。

この記事で

Introduction

GitHub Agentic Workflows を使用すると、Markdown でリポジトリの自動化を定義し、それらを実行する AI コーディング エージェントを選択できます。 gh aw拡張機能は、各エージェント型ワークフローをGitHub Actionsのワークフローにコンパイルします。

ワークフローのライフサイクル全体 (作成、デバッグ、最適化) 自体はエージェント的です。 自然言語で必要なものを記述し、コーディング エージェントがワークフローを作成、調整、およびトラブルシューティングしてくれます。

このチュートリアルでは、コーディング エージェントを使用して、変更が適切にテストされているかどうかを確認する自動プル リクエスト レビューアーを作成します。

前提条件

開始する前に、以下の項目があることを確認します:

  • GitHub Actionsが有効で、書き込みアクセス権があるリポジトリ
  • GitHub CLI バージョン 2.0.0 以降がインストールされ、認証済み
  • サポートされているコーディング エージェント ( Claude Code、 OpenAI Codex、または Google Gemini CLI、 Copilot CLIなど) とその必要な認証情報へのアクセス

GitHub CLIを認証するには、次を実行します。

gh auth login --scopes repo,workflow

gh aw拡張機能のインストール

GitHub CLI用のGitHub Agentic Workflows拡張機能をインストールしてください:

gh extension install github/gh-aw

エージェントの選択と認証の構成

ワークフローに最適なエージェント CLI を選択してください。 Claude Code、 OpenAI Codex、または Google Gemini CLI、および Copilot CLI はいずれも GitHub Agentic Workflows を実行できます。

この記事では、エージェントの資格情報をリポジトリ シークレットとして追加する簡単なセットアップについて説明します。 Claude Code、 OpenAI Codex、または Google Gemini CLIを使用する場合は、エージェントの API キーをリポジトリ シークレットとして格納してください。

| エージェント CLI | engine 値 | リポジトリシークレット | | --- | --- | --- | | クロード符号 | claude | ANTHROPIC_API_KEYAnthropic API キーを含む | | OpenAI Codex | codex | OPENAI_API_KEY OpenAI API キーを含む | | Google Gemini CLI | gemini | GEMINI_API_KEY Google AI Studio API キーを含む | | Copilot CLI (既定値) | copilot | 組織リポジトリにシークレットは必要ありません (下記参照)。 個人用リポジトリの場合、Copilot Requests が 読み取り に設定されたきめ細かなpersonal access tokenを含むCOPILOT_GITHUB_TOKEN。 |

Pi (試験段階) などの他のエンジンもサポートされています。 完全な一覧については、 GitHub Agentic Workflows 認証リファレンスを参照してください。

組織の請求情報 GitHub Copilot

組織所有のリポジトリでGitHub Copilotを使用する場合は、personal access tokenの代わりに、GitHub Actionsに組み込まれたGITHUB_TOKENを使用できます。 ワークフロー のフロントマッター permissionsにcopilot-requests: writeを追加すると、個別のシークレットは不要です。 セットアップ手順については、 AUTOTITLE を参照してください。

GitHub UI にシークレットを格納する

Claude Code、 OpenAI Codex、または Google Gemini CLIにシークレットを追加するか、GitHub Copilot個人用リポジトリに追加するには:

  1. GitHubで、リポジトリを開きます。
  2. リポジトリ名の下にある [ 設定] をクリックします。
  3. サイドバーで、[ シークレットと変数] をクリックし、[ アクション] をクリックします。
  4. [新しいリポジトリ シークレット] をクリックします。
  5. [ 名前 ] フィールドに、上記の表のシークレット名を入力します。
  6. [ シークレット ] フィールドに値を入力します。
  7. [シークレットの追加] をクリックします。

ワークフローの作成

コーディング エージェントを使用して、自然言語の説明からワークフローを作成します。

  1. リポジトリ ルートから、エージェント支援のオーサリング用にリポジトリを初期化します。 これにより、コーディング エージェントがワークフローを作成および編集するのに役立つスキルと手順が追加されます。

    gh aw init

  2. Claude Code、 OpenAI Codex、または Google Gemini CLI、Copilot CLI、VS Code エージェント モードなどを使用して、リポジトリのコンテキストでコーディング エージェント セッションを開始します。

  3. agentic-workflows スキルを使用し、必要なワークフローを記述してください。

    Copilot prompt
    /agentic-workflows create a pr reviewer that ensure the changes are tested.

    エージェントは、 .github/workflows/にワークフロー Markdown ファイルを作成し、対応する .lock.ymlGitHub Actions ワークフロー ファイルをコンパイルし、両方のファイルを確認してコミットするように求めます。

  4. 生成されたワークフローを確認し、エージェントにファイルのコミットとプッシュを依頼します。

ヒント

同じエージェント的アプローチを使用して、ワークフローの実行後にワークフローを更新および改善できます。 エージェントにレビュー条件の調整、チェックの追加、失敗した実行のデバッグを依頼します。すべて自然言語で行います。 ワークフローのフロントマッターを後で編集する場合は、変更をコミットする前に gh aw compile を実行してください。

ワークフローの実行

生成されたワークフローは pull request で自動的にトリガーされるため、次にリポジトリで pull request を開くか更新するときに実行されます。

  1. リポジトリで pull request を開きます。
  2. GitHubで、リポジトリに移動し、[アクション] タブをクリックします。
  3. 左側のサイドバーで、エージェントが作成したワークフローを選択します。
  4. 実行が完了すると、ワークフローは、変更に十分なテストが含まれているかどうかを示すプルリクエストレビューを残します。

次のステップ