自然言語で自動化ワークフローを作成できるGitHub Agentic Workflowsを試してみた
GitHub Agentic Workflowsを使って、CIの失敗を自動で診断・修正するワークフローを作りました。Markdownに自然言語で指示を書くだけで、AIエージェントがログを解析し、原因を特定し、修正パッチまで生成します。セットアップから検証結果、セキュリティ設計まで実体験をもとに解説します。
目次
GitHub Actions は 2018 年に発表されて以来、ビルド・テスト・デプロイの自動化を担ってきました。YAML で決定論的1なステップを定義するしくみは強力ですが、「ログを解析して原因を推論し、判断して対処する」というタスクは苦手です。この領域に対し、GitHub は 2026 年 2 月、AI エージェントをワークフローとして動作させる GitHub Agentic Workflows (テクニカルプレビュー) を発表しました。
従来、CI 失敗への対応は人間が担ってきました。失敗の原因は外部 API の障害・Git の競合・設定ミスと多岐にわたり、ログを読んで原因を推定する作業は単純ではありません。GitHub はこうした「判断が必要な自動化」を「Continuous AI」と呼び、CI/CD を置き換えるのではなく拡張する位置付けとしています。
私が運用するリポジトリでも同じ問題を抱えていました。ドキュメント取得や CHANGELOG 処理のワークフローがたびたび失敗していました。Issue 作成は自動化していたものの、原因調査と修正は毎回手動でした。今回は Agentic Workflows で CI が失敗したとき自動で診断・修正するワークフローを構築しました。セットアップから実際の動作検証まで、実体験をもとに紹介します。
GitHub Agentic Workflows とは
GitHub Agentic Workflows (以下 gh-aw) は、GitHub Actions 上でコーディングエージェント (AI) を動作させるリポジトリ自動化のしくみです。2026 年 2 月時点ではテクニカルプレビュー2の段階にあります。
従来の GitHub Actions は YAML に「このコマンドを実行して、成功したら次のコマンドを実行する」という手順を事前に決めて書くしくみです。つまり、決めた手順どおりにしか動きません。一方で gh-aw は、Markdown に自然言語で「何をしてほしいか」を書くと、AI エージェントがその指示を読み取り、自分で判断しながらタスクを実行します。
| 観点 | 従来の GitHub Actions | Agentic Workflows |
|---|---|---|
| 定義形式 | YAML (決定論的なステップ) | Markdown (意図・ゴールを自然言語で記述) |
| 実行者 | 固定スクリプト | コーディングエージェント (AI) |
| 判断力 | なし (if/then の分岐のみ) | あり (ログ解析、原因推論、修正案の生成) |
| 適したタスク | ビルド、テスト、デプロイ | トリアージ3、ドキュメント更新、品質改善 |
GitHub はこれを「Continuous AI」と呼んでいます。公式ドキュメントでは "systematic, automated application of AI to software collaboration" (ソフトウェア開発への AI の体系的かつ自動的な適用) と定義されています。CI/CD4 が「ものを作る作業」を自動化するように、Continuous AI は「問題を調べて対応する作業」を AI で自動化します。
何を作ったのか
今回は CI Doctor というワークフローを作りました。対象ワークフロー (ドキュメント取得、CHANGELOG 処理) が失敗したときに、AI エージェントが自動で起動して以下を行います。
- 失敗ログを取得し、根本原因を特定する
- 既存の Issue と重複しないか検索してから、Issue 作成またはコメント追加
- コードバグや設定ミスの場合は修正パッチを生成する
外部 API の障害や Git の競合のように、コードを直しても意味がない失敗では Issue だけ作成し、修正 PR は作成しません。エージェントに原因のカテゴリ分けまでやらせて、対応方針を変えさせるようにしています。
ファイル構成としくみ
gh-aw のワークフローは 2 つのファイルで構成されます。
.github/workflows/
ci-doctor.md ← 人間が編集するファイル (frontmatter + Markdown指示)
ci-doctor.lock.yml ← gh aw compile で自動生成 (GitHub Actions が実行するファイル).md ファイルが「ソース」で、.lock.yml が「コンパイル済み成果物」です。.lock.yml は手動編集しません。この関係は package.json と package-lock.json5 に似ていますね。
.md ファイルの中身
.md ファイルは frontmatter (YAML) と Markdown 指示の 2 つのパートで構成されています。frontmatter にはトリガ条件、権限、ネットワークアクセス、エージェントが実行可能な操作を定義します。Markdown 指示には「何をしてほしいか」を自然言語で書きます。
実際に作った ci-doctor.md を見てみます。
---
description: |
対象ワークフロー(ドキュメント取得、CHANGELOG処理)の失敗を自動診断する。
ログ解析により根本原因を特定し、既存Issueへのコメントまたは新規Issue作成を行う。
設定ミスやコードバグなど単純な原因の場合は修正PRを作成する。
on:
workflow_run:
workflows:
- "Fetch Claude Code Documentation"
- "Fetch and Analyze CHANGELOG"
types:
- completed
branches:
- main
skip-if-match: 'is:pr is:open label:ci-doctor'
status-comment: true
if: ${{ github.event.workflow_run.conclusion == 'failure' }}
permissions:
contents: read
actions: read
issues: read
pull-requests: read
network:
allowed:
- defaults
- node
- github
safe-outputs:
create-issue:
title-prefix: "[CI Doctor] "
labels: [bug, automated, ci-doctor]
max: 1
close-older-issues: true
add-comment:
max: 3
create-pull-request:
title-prefix: "[CI Fix] "
labels: [bug, automated, ci-doctor]
max: 1
github-token: ${{ secrets.GH_AW_GITHUB_TOKEN }}
tools:
github:
toolsets: [issues, pull_requests, actions]
cache-memory: true
engine: copilot
timeout-minutes: 15
---
# CI 失敗診断エージェント
あなたはこのリポジトリの CI 失敗を診断するエキスパートエージェントです。
失敗したワークフローのログを分析し、根本原因を特定し、可能であれば修正を行います。
## 現在のコンテキスト
- **リポジトリ**: ${{ github.repository }}
- **ワークフロー実行ID**: ${{ github.event.workflow_run.id }}
- **実行URL**: ${{ github.event.workflow_run.html_url }}
- **コミットSHA**: ${{ github.event.workflow_run.head_sha }}
- **結論**: ${{ github.event.workflow_run.conclusion }}
## プロジェクト構造
このリポジトリは pnpm workspace モノレポで以下の構成:
```
apps/
www/ - Astro フロントエンド (Cloudflare Workers デプロイ)
docs-tracker/ - ドキュメント取得 (GitHub Actions 定期実行)
changelog-fetcher/ - CHANGELOG パーサー (GitHub Actions 定期実行、Gemini API 使用)
```
重要な規約:
- ログ・コメント・Issue本文・コミットメッセージは **日本語** で記載する
- コード修正後は `pnpm run ai-check` でフォーマット・リント・型チェックを実行する
- 以下のファイルは **自動生成のため手動編集禁止**:
- `apps/docs-tracker/metadata/last_update.json`
- `apps/changelog-fetcher/metadata/last_fetch.json`
- `apps/changelog-fetcher/changelogs/v*.md`
- `apps/changelog-fetcher/analysis/analysis_v*.json`
- `apps/changelog-fetcher/inferred/inferred_v*.json`
## 対象ワークフローの失敗パターン
### Fetch Claude Code Documentation (`fetch-docs.yml`)
よくある原因:
- ドキュメント取得スクリプトのエラー (`apps/docs-tracker/`)
- git rebase/push の競合
- GitHub API レート制限
- pnpm セットアップの問題
### Fetch and Analyze CHANGELOG (`changelog-auto-inference.yml`)
よくある原因:
- CHANGELOG 取得・パースのエラー (`apps/changelog-fetcher/`)
- Gemini API 呼び出し失敗 (レート制限、APIキー期限切れ)
- 分析/推論ファイルの生成失敗
- git rebase/push の競合
- pnpm セットアップの問題
## 診断手順
### フェーズ 1: ログ取得と初期分析
1. 失敗した実行の詳細を取得する
2. 失敗したジョブを特定する
3. 失敗ジョブのログを取得する
4. エラーメッセージ、スタックトレース、終了コードを抽出する
### フェーズ 2: 根本原因の分類
失敗を以下のカテゴリに分類する:
| カテゴリ | 例 | 修正PR作成 |
| ------------ | --------------------------------------------- | --------------- |
| コードバグ | TypeScript コンパイルエラー、ランタイムエラー | 可能 |
| 設定ミス | ワークフローYAML、package.json の誤り | 可能 |
| 外部API障害 | Gemini API、GitHub API のレート制限/障害 | 不可(Issueのみ) |
| インフラ問題 | ランナー障害、ネットワーク問題 | 不可(Issueのみ) |
| git競合 | rebase/push 失敗 | 不可(Issueのみ) |
### フェーズ 3: 重複チェック
> `skip-if-match` により ci-doctor ラベルのオープンPRがある場合はここに到達しない。
1. `/tmp/gh-aw/cache-memory/last-diagnosis.json` を確認し、同一 `root_cause` なら既存Issueにコメント追加のみ行う
2. ラベル `ci-doctor` または `automated` のオープンIssueを検索し、同じ原因なら新規Issue作成せずコメント追加のみ行う
3. 該当Issueがなければ新規Issueを作成する
4. 診断結果を `/tmp/gh-aw/cache-memory/last-diagnosis.json` に保存する
### フェーズ 4: 修正PR作成
**以下をすべて満たす場合のみ** 修正PRを作成する:
- カテゴリが「コードバグ」または「設定ミス」
- フェーズ3で同じ原因の既存Issue・PRが見つかっていない
- キャッシュに同一 `root_cause` の記録がない
修正PRを作成する場合:
1. 根本原因に基づいて修正を実装する
2. `pnpm run ai-check` を実行して修正を検証する
3. 修正PRを作成する (自動生成ファイルは変更禁止、コミットメッセージ・PR説明は日本語)
### フェーズ 5: 報告
Issue または PR の本文には以下を含める:
```md
## 診断結果
**失敗ワークフロー**: [ワークフロー名]
**実行URL**: [リンク]
**失敗日時**: [タイムスタンプ]
## 根本原因
[原因の詳細な説明]
## エラーログ (抜粋)
[関連するエラーメッセージ]
## 対応
[実施した対応または推奨する対応手順]
## 再発防止
[再発を防ぐための提案]
```
## 重要な制約
- **既存のIssue・PRがある場合、新規作成せずコメント追加のみ**
- 外部API障害・git競合の場合はIssue作成のみ (PR作成不可)
- Issue・PR・コメントはすべて **日本語** で記載する
- セキュリティに関わる情報 (APIキー、トークン等) はログやIssueに含めない
on で workflow_run の completed + failure フィルタを指定しています。対象ワークフローが失敗で完了したときだけエージェントが起動します。skip-if-match は冪等性6のために重要な設定です。is:pr is:open label:ci-doctor と書くと、ci-doctor ラベルが付いたオープン PR が 1 件でも存在すれば、AI エージェントが起動する前にワークフロー全体がスキップされます。これがないと、同じ原因の CI 失敗が繰り返されるたびにブランチと PR が量産されてしまいます。
permissions はすべて read のみです。エージェントに write 権限を与えません。「read しかないのにどうやって PR を作るのか」という疑問が浮かびますが、エージェントは「PR を作りたい」というリクエストを記録するだけです。実際の作成は、コンパイラが自動生成する別ジョブ (safe_outputs) が write 権限で行います。この権限分離の詳細はセキュリティ設計のセクションで説明します。
safe-outputs がエージェントの「できること」を定義しています。Issue は 1 回の実行で最大 1 件、コメントは最大 3 件、PR も最大 1 件。max で暴走を防止しています。close-older-issues: true を設定すると、同じ接頭辞の古い Issue を自動でクローズしてくれるので、Issue がたまりません。
tools の cache-memory: true を設定すると、エージェントがラン間で診断結果をキャッシュファイルに永続化できます。skip-if-match を通過したケース (PR はクローズ済みだが同じ原因の失敗が再発した場合など) でも、前回の診断結果と照合して重複対応を防止できます。skip-if-match がフロントマターレベルの第 1 層、cache-memory が AI 実行レベルの第 2 層として、多層的に冪等性を担保しています。
engine は copilot を選択しました。Copilot サブスクリプション7のプレミアムリクエスト内で動作するため、追加の API 費用が不要です。claude、codex、gemini も選択できますが、それぞれ Anthropic / OpenAI / Google のアカウントと API キーが別途必要で、各社の従量課金が発生します。GitHub のプレミアムリクエストとは別の課金体系です。
普段 Claude Code の CLAUDE.md8 を書いている感覚と同じです。エージェントに「あなたはこのリポジトリの CI 失敗を診断するエキスパートです」と伝え、プロジェクトの構造や規約を教え、何をどの順番でやるかを指示します。
セットアップの手順
以下の手順は GitHub CLI (gh) がインストール済みであることを前提としています (GitHub CLI 公式サイト)。
まず gh-aw CLI を GitHub CLI の拡張機能としてインストールします。
gh extension install github/gh-aw次に Issue/PR に付与するラベルを事前に作成しておきます。
gh label create "ci-doctor" --description "CI Doctor による自動診断" --color "7057ff".md ファイルの作成後、.lock.yml にコンパイルします。
gh aw compile初回はエラーが出ました。
Validation failed for field 'expressions'
1 unauthorized expressions found:
- github.event.workflow_run.name
(did you mean: github.event.workflow_run.number?)Markdown 指示部分で ${{ github.event.workflow_run.name }} を使っていたのですが、この式は許可リストに含まれていませんでした。gh-aw はプロンプトインジェクション防止のために、使用可能な式を厳密に制限しています。ワークフロー名 (name) は取得できず、代わりに実行 ID (id) や実行 URL (html_url) は使えます。エージェントは URL を見ればどのワークフローかわかるので、実質的な問題はありません。
修正後に再コンパイルすると成功します。
✓ .github/workflows/ci-doctor.md (67.5 KB)
✓ Compiled 1 workflow(s): 0 error(s), 0 warning(s)約 188 行の .md から約 1,365 行の .lock.yml が生成されます。ほとんどはセキュリティ基盤のコードです。
最後にシークレットを設定します。engine: copilot を使う場合、GitHub Actions のランナーから Copilot のエージェント API を呼び出すための認証情報が必要です。リポジトリ操作用の GITHUB_TOKEN はエージェント API へのアクセス権限を持たないため、別途 fine-grained Personal Access Token (PAT)9 を作成します。
- GitHub Settings > Developer settings > Fine-grained tokens で PAT を作成する (スコープは
copilot-requests) - リポジトリシークレットをghコマンド、またはGUIから設定する
gh secret set COPILOT_GITHUB_TOKEN検証してみた
意図的に CI を失敗させて動作を確認しました。fetch-docs.yml の steps 先頭に exit 110 のステップを追加して即座に失敗させる方法です。
01:00:08 fetch-docs.yml 手動実行
01:00:09 "CI Doctor test" ステップで exit 1 → 即座に失敗
01:00:09 既存処理が Issue #31 を自動作成
01:00:18 ci-doctor ワークフローが workflow_run トリガーで起動
01:00:18 ├─ pre_activation (17秒): チームメンバーシップ確認
01:00:37 ├─ activation (23秒): プロンプト生成・バリデーション
01:01:02 ├─ agent (2分27秒): # メインのエージェント実行
01:03:31 ├─ detection (23秒): 脅威検出
01:03:56 ├─ safe_outputs (28秒): Issue/PR の実際の作成
01:04:26 └─ conclusion (18秒): 完了処理
01:04:18 Issue #32 が作成される
# 合計: 4分ちょいfetch-docs の失敗から Issue 作成まで約 4 分ほどで、そのうちエージェント本体の実行は 2 分 27 秒、残りはセキュリティ基盤の環境構築です。
実際にエージェントが作成した Issue #32 はこちらです。

- 根本原因を正確に特定し、
exit 1を含むテストステップが原因と正しく診断 - 該当ステップのログを正確に抜粋
exit 1ステップを削除する Git コミットを作成し修正パッチを作成- 既存 Issue(Issue #31)との紐づけ
エージェントが生成した修正パッチは以下のような diff でした。
--- a/.github/workflows/fetch-docs.yml
+++ b/.github/workflows/fetch-docs.yml
@@ -33,9 +33,6 @@ jobs:
commit_sha: ${{ steps.get-sha.outputs.sha }}
steps:
- - name: CI Doctor test
- run: exit 1
-
- name: Checkout repositoryコミットメッセージもエージェントが日本語で作成していて、Co-authored-by に Copilot が付与されています。今回は意図的なエラーで修正は単純ですが、実際の運用ではログ解析から修正パッチ生成までの調査が自動化されます。
lock.yml から読み解くセキュリティ設計
正直に言うと、gh-aw を使う前は「AI にリポジトリの write 権限を渡すのは怖い」と思っていました。AI が意図せず既存のコードを書き換えたり、大量の Issue や PR を作成したりする不安です。でも .lock.yml の中身を読んでみて、その印象は変わりました。
約 1,365 行の lock.yml のうち、ユーザーが書いた内容が反映される部分は 2 割程度です。残りの 8 割はコンパイラが自動挿入したセキュリティ基盤です。いくつか紹介します。
エージェントには read 権限しかない
agent: # ← エージェントが動くジョブ
permissions:
actions: read
contents: read
issues: read
pull-requests: read # すべて read のみ
safe_outputs: # ← GitHub 操作を実際に実行するジョブ
permissions:
contents: write
issues: write
pull-requests: write # write 権限はここだけエージェントが動く agent ジョブと、GitHub への write 操作を担う safe_outputs ジョブは分離されています。エージェントは「Issue を作りたい」というリクエストを safe-outputs に記録するだけです。実際の作成は、別ジョブが別の権限で行います。身近な例で言えば、会社の経費精算に似ています。担当者は「申請」しかできず、実際にお金を動かすのは経理部門だけ、という分業です。AI エージェントも「申請」しかできず、実際の操作は別の安全なしくみが行います。
ネットワークファイアウォール
frontmatter で network: [defaults, node, github] と書くと、コンパイラがこれを 80 個以上のドメインを含むホワイトリストに展開します。実際に lock.yml に生成されるコマンドを見ると、3 語の抽象指定がどう変換されるかがわかります。
# ci-doctor.md で書いた内容
# network:
# allowed: [defaults, node, github]
# lock.yml で展開された結果 (80ドメイン以上、一部抜粋)
sudo -E awf --allow-domains '*.githubusercontent.com,api.github.com,
registry.npmjs.org,yarnpkg.com,nodejs.org,npm.pkg.github.com,...'実行時は Agent Workflow Firewall が Squid プロキシ11をコンテナ内で起動し、このホワイトリスト以外への通信をすべてブロックします。
エージェントがコード実行権限を持つ以上、curl で任意のサーバにデータを送信する可能性があります。ホワイトリスト外への通信をネットワーク層でブロックすることで、エージェントのコードレベルでの制御に依存しない防御を実現しています。
AI の出力を AI が検証する
detection ジョブでは、agent ジョブが生成した出力 (Issue 本文、PR 本文、パッチ) を別のエージェントが安全性を検証します。
detection:
needs: agent
steps:
- name: Execute GitHub Copilot CLI
run: |
copilot --allow-tool 'shell(cat)' --allow-tool 'shell(grep)' \
--allow-tool 'shell(head)' --allow-tool 'shell(jq)' \
--allow-tool 'shell(ls)' --allow-tool 'shell(tail)' \
--allow-tool 'shell(wc)'検出エージェントに許可されているのは、cat, grep, jq 等の読み取り専用シェルコマンドのみです。agent ジョブとは独立したコンテキストで動作し、write 権限もネットワークアクセスもありません。「AI の出力を AI が検証する」という構造で、独立したコンテキストが共謀のリスクを下げています。
プロンプトインジェクション対策
ユーザーが書いた Markdown 指示は、セキュリティ用のシステムプロンプトでサンドイッチ12されています。
[XPIA対策のシステムプロンプト]
[safe-outputs の使い方]
[GitHub コンテキスト]
[ユーザーの Markdown 指示] ← ここXPIA13 (Cross-Prompt Injection Attack) 対策として、エージェントがログや Issue 本文に含まれる悪意のあるプロンプトに従わないよう指示が先に注入されています。さらに ${{ }} 式は許可リストで厳密に制限されているため、プロンプトインジェクションの余地を狭めています。
セキュリティ設計の全体像
lock.yml には全部で 11 層の防御が自動で構築されています。
- 実行制御 - チームメンバーシップ検証
- fork 検証 - リポジトリ ID・fork チェック
- プロンプト保護 - XPIA 対策、システムプロンプト注入
- 式バリデーション - プレースホルダの 3 段階置換・検証
- ネットワーク - Squid プロキシによるドメイン制限
- API 仲介 - MCP Gateway14 による全通信仲介
- 出力バリデーション - Safe Outputs の回数・内容制限
- 権限分離 - agent=read / safe_outputs=write
- 脅威検出 - 別エージェントによる出力検証
- 秘密情報保護 - ログ・アーティファクトのマスキング
- 出力制御 - タイトル接頭辞・ラベル強制
ユーザーは「失敗を診断して Issue を作りたい」という意図を 188 行の Markdown で書くだけで、コンパイラがこれだけのセキュリティ防御を自動で構築してくれます。
frontmatter を書くときの注意点
最初に作った frontmatter はいくつか甘い部分がありました。実際にハマったポイントと、設定しておくべき項目を紹介します。
safe-outputs の max は必ず明示するのが安全です。デフォルト値に依存するより、明示的に上限を書いておくことでエージェントが暴走した際のガードレールになります。たとえば create-issue: max: 1 と書けば、1 回の実行で Issue は 1 件しか作成できません。同様に close-older-issues: true を設定すると、同じ接頭辞の古い Issue を自動でクローズするので、Issue がたまるのを防げます。
permissions は read-all ではなく個別に指定するのが推奨です。最小権限の原則に従い、必要な権限だけを明示する方が安全です。
network はデフォルトが strict: true ですので、明示指定しないと外部通信が一切できません。最初は「なぜ pnpm install が失敗するんだ」と悩みましたが、node を追加したら解決しました。エージェントが使う外部サービスに応じて defaults、node、github などを指定します。
tools.github には toolsets で必要な API のみを指定するとよいでしょう。全 API を開放するよりも、[issues, pull_requests, actions] のように限定する方が、エージェントが不要な API にアクセスするリスクを減らせます。
冪等性の設計は最初から意識しておくべきポイントです。safe-outputs の max: 1 は「1 回の実行で 1 つまで」という制限であり、ワークフロー自体が複数回実行されれば PR やブランチは複数作られてしまいます。skip-if-match で実行自体をスキップし、cache-memory で診断結果を永続化し、プロンプトで既存 Issue・PR の重複チェックを指示する。この 3 層を組み合わせることで、定期的に同じ CI 失敗が発生しても、ブランチや PR が量産されずに済みます。skip-if-match を設定せずにプロンプトの指示だけに頼ると、AI が指示を「解釈」するため確実に守られるとは限りません。インフラレベルのガードを最優先にするのが安全です。
まとめ
- GitHub Agentic Workflows は、Markdown に自然言語で指示を書くだけで AI エージェントが GitHub Actions 上でタスクを実行するしくみ
- CI の失敗診断・修正のような「判断が必要なタスク」に向いていて、従来の決定論的な YAML ベースの Actions を拡張する位置付け
- 188 行の
.mdから約 1,365 行の.lock.ymlが生成され、その 8 割はセキュリティ基盤。権限分離・ネットワークファイアウォール・脅威検出など 11 層の自動防御 - エージェントに直接 write 権限を与えず、safe-outputs 経由でのみ操作を許可する特権分離の設計
- テクニカルプレビュー段階だが、意図的な
exit 1を正確に検出し修正パッチまで生成できる実用的な診断能力
テクニカルプレビューなので仕様は変わる可能性がありますが、「AI にリポジトリを触らせる」ことの不安を、プラットフォームレベルのセキュリティで解消しようとしているアプローチには好感を持っています。特に lock.yml を読んでみると、「AI を使うこと」と「AI を安全に使うこと」の間にあるギャップを、ユーザーが意識しなくても済む形で埋めようとしている設計思想が伝わってきます。
参考
Home | GitHub Agentic Workflows
GitHub Agentic Workflows (gh-aw) lets developers define AI-powered repository automation in Markdown with YAML frontmatter and run AI agents through GitHub Actions using controlled permissions, sandboxing, and safe outputs.
How GitHub Agentic Workflows Work | GitHub Agentic Workflows
Learn how GitHub Agentic Workflows (gh-aw) compiles Markdown with YAML frontmatter into GitHub Actions workflows that run AI agents securely.
GitHub Agentic Workflows Quickstart | GitHub Agentic Workflows
Install GitHub Agentic Workflows (gh-aw), choose an AI engine, add a Markdown workflow, and run an AI agent through GitHub Actions.
AI Engines for GitHub Agentic Workflows | GitHub Agentic Workflows
Compare the built-in AI engines for GitHub Agentic Workflows (gh-aw), including selection, authentication, capabilities, limitations, and examples for Copilot, Claude Code, Codex, Gemini, and Pi.
Security Architecture | GitHub Agentic Workflows
Security architecture for GitHub Agentic Workflows across hosted runners, ARC with Docker-in-Docker, gVisor, and Docker sbx microVM isolation.
GitHub Agentic Workflowsを発表 - リポジトリの自動化を実現
itHub Agentic Workflowsがテクニカルプレビューとして登場。GitHub Actionsでコーディングエージェントを使用し、意図駆動型の自動化を構築しましょう。トリアージ、ドキュメント作成、コード品質向上など、さまざまなタスクを自動化できます。
Footnotes
-
同じ入力に対して常に同じ出力を返すこと。「もし A なら B を実行」という固定のルールで動作し、AI のような柔軟な判断は行わない。 ↩
-
製品として一般公開する前の試験的な提供段階。仕様が変わる可能性があり、本番利用は推奨されない。 ↩
-
Issue や障害の重要度・緊急度を判断して優先順位をつける作業のこと。もともとは医療用語で、限られたリソースの中で対応順を決めるプロセスを指す。 ↩
-
Continuous Integration / Continuous Delivery の略。コードをプッシュするたびに自動でビルド・テスト・デプロイを実行する開発手法。 ↩
-
npm が自動生成するファイルで、パッケージの正確なバージョンを固定する。
package.jsonが「方針」、package-lock.jsonが「実際の状態記録」。 ↩ -
同じ操作を何度繰り返しても結果が変わらない性質のこと。ここでは「同じ CI 失敗が何度発生しても、ブランチや PR が 1 つだけ作られる」ことを指す。 ↩
-
GitHub Copilot の有料プラン。AI によるコード補完・チャット機能が利用できる。プレミアムリクエストは月ごとの利用枠が設定されており、枠内の利用であれば追加料金は発生しない。 ↩
-
Claude Code がプロジェクト内で自動的に読み取る指示ファイル。プロジェクト固有のコーディング規約や手順を記述しておくことで、Claude Code が毎回一貫した動作をするようになる。 ↩
-
GitHub の Fine-grained Personal Access Token の略。リポジトリ単位・権限単位できめ細かくスコープを制限できるアクセストークン。従来の classic PAT よりセキュリティが高い。 ↩
-
プログラムが終了するときに返す数値。
exit 0は成功、exit 1以上は失敗を意味する。CI はこの値を見て処理の成否を判断する。 ↩ -
オープンソースのHTTPプロキシサーバ。ここではコンテナ内でフォワードプロキシ(通信の中継役)として動作し、許可されたドメイン以外への通信をブロックする役割を担っている。 ↩
-
前後をセキュリティ用のプロンプトで挟み込む手法のこと。ユーザーの指示より先にセキュリティ制約を注入することで、悪意のある入力による制約の上書きを防ぐ。 ↩
-
Cross-Prompt Injection Attack の略。AI エージェントが処理する外部データ (ログ、Issue 本文など) に悪意のあるプロンプトを埋め込み、エージェントの動作を乗っ取ろうとする攻撃手法。 ↩
-
Model Context Protocol Gateway の略。エージェントと外部サービス (GitHub API など) の間に立ち、すべてのリクエストを仲介・検証するプロキシ。エージェントが直接 API を呼び出せないようにする中間層として機能する。 ↩
理解度チェック
問題1: GitHub Agentic Workflows のセキュリティ設計において、エージェント(agent ジョブ)が Issue や PR を作成する際のしくみとして正しいものはどれですか?
エージェントが write 権限を持ち、直接 Issue や PR を作成する
エージェントは作成リクエストを記録するだけで、実際の作成は別ジョブ(safe_outputs)が write 権限で行う
エージェントが GitHub API を直接呼び出し、トークンの権限で制御する
エージェントの出力を人間が承認してから、手動で Issue や PR を作成する
問題2: GitHub Agentic Workflows において、.md ファイルと .lock.yml ファイルの関係として正しいものはどれですか?
.lock.yml が人間が編集するソースで、.md はそのドキュメント
.md と .lock.yml は独立したファイルで、それぞれ手動で編集する
.md がソースで、gh aw compile により .lock.yml が自動生成される。.lock.yml の約8割はセキュリティ基盤のコード
.md がソースで、GitHub Actions の実行時に自動的に .lock.yml に変換される