GitHub Agentic Workflowsがテクニカルプレビューとして登場。GitHub Actionsでコーディングエージェントを使用し、意図駆動型の自動化を構築しましょう。トリアージ、ドキュメント作成、コード品質向上など、さまざまなタスクを自動化できます。
朝、リポジトリを訪れて、穏やかな気持ちになれることを想像してください。なぜなら：
- Issueがトリアージされている。
- CIの失敗が説明され、修正が提案されている。
- ドキュメントがコードの現状を反映している。新しい分析により、品質とツールの改善点が示されている。
- テストを改善する2つの新しいプルリクエストがレビューを待っている。
すべてが可視化され、検査可能で、あなたが定義した境界内で動作している。
これがGitHub Agentic Workflowsのビジョンです。GitHub Actionsで実行される自動化された意図駆動型のリポジトリワークフローで、プレーンなMarkdownで記述され、コーディングエージェントによって実行されます。GitHub上で作業する人々、つまり単一のリポジトリを自動化する個人から、エンタープライズやオープンソース規模で運用するチームまで、すべての人のために設計されています。
GitHub Nextでは、シンプルな問いから GitHub Agentic Workflowsの調査を始めました：AIコーディングエージェントの時代に、強力なガードレールを備えたリポジトリ自動化とはどのようなものか？GitHub上のスケーラブルなリポジトリ自動化の中心であるGitHub Actionsから始めるのが自然でした。自動化されたコーディングエージェントをGitHub Actionsに組み込むことで、何百万ものリポジトリでその使用を可能にしながら、いつどこで使用するかの決定を、最も重要な開発者の手に委ねることができます：あなた自身に。
GitHub Agentic Workflowsは現在、テクニカルプレビューとして利用可能です。この記事では、それが何であり、どのように機能するかを説明します。リポジトリレベルのAI自動化が最も価値を発揮する場所を探るため、ぜひお試しください。
ユーザーの声
Home Assistantには数千のオープンIssueがあります。何がトレンドになっているか、どの問題が最も多くのユーザーに影響を与えているかを、人間が追跡することはできません。私はIssueを分析し、重要なものを浮かび上がらせるGitHub Agentic Workflowsを構築しました。これこそがメンテナーを本当に助ける判断力の増幅です。
Franck Nijhof氏、Home Assistantプロジェクトリード（GitHubでコントリビューター数トップのプロジェクトの1つ）
GitHubのAgentic Workflowsを採用することで、AIツールの実験の障壁が下がり、スタッフ、メンテナー、新規参入者にとって格段に容易になりました。CNCF内では、ドキュメント自動化の改善や、組織全体のチームレポーティングの改善から恩恵を受けています。これはコミュニティにとって単なる技術的なアップグレードではなく、エコシステムがAIとエージェントツールでより速くイノベーションを起こすことを可能にする文化的シフトの一部です。
Chris Aniszczyk氏、Cloud Native Computing Foundation（CNCF）CTO。クラウドネイティブコンピューティングを世界中で普遍的なものにすることをミッションとしている
GitHub Agentic Workflowsにより、複数のリポジトリにまたがる変更を含む、大規模な実際のエンジニアリング作業にエージェントを適用する方法を拡大できます。柔軟性と組み込みのコントロールにより、Carvanaの複雑なシステム全体でAgentic Workflowsを活用する自信が得られます。
Alex Devkar氏、Carvana エンジニアリング＆アナリティクス担当シニアバイスプレジデント
AIリポジトリ自動化：シンプルさによる革命
GitHub Agentic Workflowsの背後にあるコンセプトはシンプルです：望む結果をプレーンなMarkdownで記述し、これを自動化ワークフローとしてリポジトリに追加すると、GitHub Actionsでコーディングエージェントを使用して実行されます。
これにより、最新のコーディングエージェントのパワーがリポジトリ自動化の中心に組み込まれます。GitHub Agentic workflowsは、GitHub Copilot CLI、AnthropicのClaude、OpenAI Codexなど、複数のコーディングエージェントによって動作します。従来のGitHub Actions YAMLワークフローと並行して実行されますが、コンテキストと判断力が必要な繰り返しタスク向けに設計されています。GitHub Agentic workflowsは、チームやエンタープライズが必要とする可視性、制御、監査可能性の重要なニーズに対応するため、追加のガードレール、ログ、サンドボックス化とともに実行されます。
GitHub Agentic Workflowsの使用により、開発者チームがGitHub上ですでに作業している方法に自然にフィットする形で、まったく新しいカテゴリのリポジトリ自動化とソフトウェアエンジニアリングが可能になります。6つのアプリケーション領域と、それに対応するサンプルを考えてみましょう。これらの各タスクは、コンテキスト、判断力、時間をかけた繰り返しを必要とするため、固定スクリプトとして表現することが困難です：
- 継続的トリアージ：新しいIssueを自動的に要約、ラベル付け、ルーティングします。
- 継続的ドキュメント作成：READMEとドキュメントをコード変更に合わせて最新の状態に保ちます。
- 継続的コード簡素化：コード改善を繰り返し特定し、プルリクエストを作成します。
- 継続的テスト改善：テストカバレッジを評価し、価値の高いテストを追加します。
- 継続的品質維持：CIの失敗を積極的に調査し、的を絞った修正を提案します。
- 継続的レポーティング：リポジトリの健全性、アクティビティ、トレンドに関する定期レポートを作成します。
これらは、GitHub Agentic Workflowsが実用的かつ安全に実装できるようにするリポジトリ自動化のほんの一例です。私たちはこれをContinuous AIと呼んでいます：継続的インテグレーションと継続的デプロイメント（CI/CD）のプラクティスと同様に、自動化とコラボレーションを強化するAIのSDLCへの統合です。
GitHub Agentic WorkflowsとContinuous AIは、既存のCI/CDを置き換えるのではなく、拡張するように設計されています。ビルド、テスト、リリースパイプラインを置き換えるものではなく、そのユースケースは決定論的なCI/CDワークフローとほとんど重複しません。Agentic WorkflowsがGitHub Actionsで実行されるのは、GitHubがサンドボックス化された実行、権限、ログ、監査、豊富なリポジトリコンテキストに必要なインフラストラクチャを提供しているからです。
チームやエンタープライズが、エージェント支援のリポジトリ自動化を通じてリポジトリを健全で、ナビゲートしやすく、高品質に保つための新しい可能性の世界が開かれています。
ガードレールと制御について
安全性と制御のための設計は譲れません。GitHub Agentic Workflowsは、意図しない動作やプロンプトインジェクション攻撃から保護する多層防御セキュリティアーキテクチャを実装しています。
ワークフローはデフォルトで読み取り専用権限で実行されます。書き込み操作には、サニタイズされた安全な出力を通じた明示的な承認が必要です。これは、PRの作成やIssueへのコメント追加など、事前承認されたレビュー可能なGitHub操作にマッピングされます。サンドボックス化された実行、ツールの許可リスト、ネットワーク分離により、コーディングエージェントが制御された境界内で動作することを保証します。
このようなガードレールにより、エージェントを単発の実験としてではなく、継続的に実行することが実用的になります。詳細については、セキュリティアーキテクチャをご覧ください。
エージェントによるリポジトリ自動化の代替アプローチとして、GitHub CopilotやClaudeなどのコーディングエージェントCLIを、リポジトリへの広範な書き込み権限を持つ標準のGitHub Actions YAMLワークフロー内で直接実行する方法があります。しかし、このアプローチは推奨されません。それらの権限は粗すぎることが多いためです。対照的に、GitHub Agentic Workflowsはデフォルトで読み取り専用アクセスでコーディングエージェントを実行し、GitHub操作には安全な出力に依存するため、より厳密な制約、より明確なレビューポイント、より強力な全体的な制御を提供します。
シンプルな例：日次リポジトリレポート
シンプルな例を見てみましょう：リポジトリメンテナー向けの日次ステータスレポートを作成します。
実際には、通常AIアシスタンスを使用してワークフローを作成します。ワークフローの作成をご覧ください。最も簡単な方法は、インタラクティブなコーディングエージェントを使用することです。たとえば、お気に入りのコーディングエージェントで次のプロンプトを入力できます：
コーディングエージェントはあなたと対話して特定のニーズと意図を確認し、Markdownファイルを作成し、その有効性をチェックします。その後、ワークフローをリポジトリに追加する前に、レビュー、改良、検証できます。
これにより、.github/workflowsに2つのファイルが作成されます：
daily-repo-status.md（agentic workflow）daily-repo-status.lock.yml（GitHub Actionsでワークフローを実行できるようにするagentic workflowロックファイル）
daily-repo-status.mdファイルは次のようになります：
---
on:
schedule: daily
permissions:
contents: read
issues: read
pull-requests: read
safe-outputs:
create-issue:
title-prefix: "[repo status] "
labels: [report]
tools:
github:
---
# Daily Repo Status Report
Create a daily status report for maintainers.
Include
- Recent repository activity (issues, PRs, discussions, releases, code changes)
- Progress tracking, goal reminders and highlights
- Project status and recommendations
- Actionable next steps for maintainers
Keep it concise and link to the relevant issues/PRs.
このファイルには2つの部分があります：
- フロントマター（
---マーカー間のYAML）：設定用 - Markdown指示：ジョブを記述
Markdownが意図ですが、トリガー、権限、ツール、許可された出力は最初に明示されます。
お好みで、ワークフローを手動でリポジトリに追加することもできます：
- ワークフローを作成：フロントマターと指示を含む
daily-repo-status.mdを追加 - ロックファイルを作成：
gh extension install github/gh-aw gh aw compile
- コミットしてプッシュ：ファイルをリポジトリにコミットしてプッシュ
- 必要なシークレットを追加：たとえば、コーディングエージェント用のトークンまたはAPIキーを追加
このワークフローをリポジトリに追加すると、自動的に実行されるか、GitHub Actionsを使用して手動でトリガーできます。ワークフローが実行されると、次のようなステータスレポートIssueが作成されます：
GitHub Agentic Workflowsで構築できるもの
さらなるインスピレーションをお探しなら、リポジトリワークフロー自動化の強力な世界への魔法の旅を用意しました！Peli’s Agent Factoryは、適応、リミックス、リポジトリ間で標準化できる実用的なパターンを含む、幅広いワークフローのガイドツアーです。
便利なメンタルモデル：リポジトリでの繰り返し作業が言葉で説明できるなら、それはagentic workflowに適しているかもしれません。
デザインパターンをお探しなら、ChatOps、DailyOps、DataOps、IssueOps、ProjectOps、MultiRepoOps、Orchestrationをご覧ください。
エージェント支援のリポジトリ自動化の用途は、特定のリポジトリと開発の優先事項によって異なることが多いです。チームや会社のソフトウェア開発へのアプローチは、他のチームとは異なります。あなたのチームのあなたのリポジトリのために、あなたの目標に向けてエージェント自動化をどのように使用できるか、想像力を働かせることが大切です。
チームのための実践的なガイダンス
GitHub Agentic workflowsは思考の転換をもたらします。完璧なプロンプトではなく、目標と望む出力に焦点を当てると最もうまく機能します。成功とは何かを明確にし、ワークフローがそれを達成する方法を探索できるようにします。いくつかの境界はデフォルトでagentic workflowsに組み込まれており、他の境界は明示的に定義するものです。これにより、エージェントは探索し推論できますが、その結論は常に安全で意図的な制限内にとどまります。
ワークフローは非常に一般的なもの（「ソフトウェアを改善する」）から非常に具体的なもの（「この教育ソフトウェアのすべての技術ドキュメントとエラーメッセージが10歳以上の聴衆に適したスタイルで書かれていることを確認する」）まで様々です。チームに適した具体性のレベルを選択できます。
GitHub Agentic Workflowsは実行時にコーディングエージェントを使用するため、課金コストが発生する場合があります。デフォルト設定でGitHub Copilotを使用する場合、各ワークフロー実行は通常2つのプレミアムリクエストを消費します：1つはエージェント作業用、もう1つは安全な出力のガードレールチェック用です。使用するモデルは、これらのコストを管理するために設定できます。現在、GitHub Copilotの自動化された使用はユーザーアカウントに関連付けられています。他のコーディングエージェントについては、詳細はドキュメントをご参照ください。チームがすぐに価値を得るためのヒントをいくつか紹介します：
- プルリクエスト作成を有効にする前に、コメント、ドラフト、レポートなどの低リスクな出力から始めましょう。
- コーディングの場合、機能開発ではなく、定期的なリファクタリング、テストカバレッジ、コード簡素化などの目標指向の改善から始めましょう。
- レポートの場合、フォーマット、トーン、リンク、いつ停止するかなど、「良い」とは何かを具体的に指示してください。
- GitHub Agentic workflowsは、エージェントが定義された条件の下で行動するため、自律的になることができるエージェント専用のサブループを作成します。しかし、レポート、Issue、プルリクエストを通じて、リポジトリの前進におけるより広いループに人間がとどまることが重要です。GitHub Agentic Workflowsでは、プルリクエストは自動的にマージされることはなく、人間が常にレビューし承認する必要があります。
- ワークフローのMarkdownをコードとして扱いましょう。変更をレビューし、小さく保ち、意図的に進化させてください。
Continuous AIは、CI/CDと併用すると最もうまく機能します。CI/CD用のGitHub Actions YAMLワークフローの代替としてagentic workflowsを使用しないでください。このアプローチは、従来のCI/CDでは表現が難しい、より主観的で繰り返しの多いタスクに継続的自動化を拡張します。
私たちと一緒に自動化の未来を築きましょう
GitHub Agentic Workflowsは現在テクニカルプレビューとして利用可能で、GitHub、Microsoft Research、Azure Core Upstreamのコラボレーションです。ぜひお試しいただき、リポジトリ自動化の未来を一緒に形作ってください。
GitHub Agentic Workflowsは、リポジトリのメンテナンスと改善の自動化方法を再考する招待状です。コーディングエージェントの機能とGitHub Actionsの信頼性と制御を組み合わせることで、チームがリポジトリを健全で、ナビゲートしやすく、高品質に保つことを支援することを目指しています。
ぜひご参加ください！コミュニティディスカッションでご意見をお聞かせください。また、GitHub Next Discordの#agentic-workflowsチャンネルで、私たちや他の素晴らしいメーカーたちと一緒に交流しましょう。GitHub Agentic Workflowsであなたが何を構築するか楽しみにしています。Happy automating！