Repolode
github

github/gh-aw

MarkdownでAIを活用したリポジトリ自動化を記述し、GitHub Actionsで安全に実行できるGitHub CLI拡張機能です。

スター
5,422
フォーク
596
未解決の Issue
339
最終コミット
6 時間前

これは何?

GitHub Agentic Workflows(gh-aw)を使うと、開発者はYAML frontmatterを含むMarkdownファイルで、リポジトリ向けのAIエージェントタスクを定義できます。gh aw compileコマンドは各ワークフローを標準的なGitHub Actionsワークフローファイルに変換し、GitHub上で実行します。

課題のトリアージ、プルリクエストのレビュー、CI失敗の調査、ドキュメントの保守、依存関係の分析、リポジトリのレポート作成など、推論や解釈が必要なタスクを想定しています。決定的に実行できるビルド、テスト、デプロイは通常のActionsワークフローに任せ、エージェント型ワークフローをその隣で活用できます。

組み込みエンジンとしてGitHub Copilot、Claude Code、OpenAI Codex、Google Gemini、Piを利用できます。エージェントのジョブはデフォルトで読み取り専用かつサンドボックス内で実行され、GitHubへの書き込みは、権限を絞った検証済みのsafe-outputsジョブを通じて適用されます。

主な機能

  • 01トリガー、権限、ツール、エンジンの選択をYAML frontmatterに記述し、Markdownでワークフローを定義できます。
  • 02gh aw compileを使って、各ワークフローを標準的なGitHub Actionsワークフローにコンパイルできます。
  • 03GitHub Copilot、Claude Code、OpenAI Codex、Google Gemini、Piの各エンジンに対応しています。
  • 04エージェントのジョブはデフォルトで読み取り専用かつサンドボックス内で実行されます。
  • 05権限を絞った検証済みのsafe-outputsジョブを通じて、GitHubへの書き込みを適用します。

ユースケース

  • 新しいissueをトリアージし、自動でラベルを付ける。
  • CIの一環として、AIエージェントにプルリクエストをレビューさせる。
  • 失敗したCI実行を調査し、原因を要約する。
  • ドキュメントを最新の状態に保ち、定期的なリポジトリレポートを作成する。

クイックスタート

  1. 1

    GitHub CLI拡張機能をインストールする

    gh extension install github/gh-aw
  2. 2

    クイックスタートに従ってAIエンジンを選択し、サンプルワークフローを追加して、GitHub Actionsで実行する

使う前に知っておきたいこと

  • GitHub Copilot、Claude Code、OpenAI Codex、Google GeminiなどのAIエンジンのアカウントまたはAPIキーが必要です。
  • エージェント型ワークフローには慎重な人間の監督が必要です。READMEには自己責任で使用するよう記載されています。
  • セキュリティ脆弱性が見つかったため、バージョン0.83.3以上0.85.4未満は提供を終了しました。

トピック

よくある質問

gh-aw とは?
MarkdownでAIを活用したリポジトリ自動化を記述し、GitHub Actionsで安全に実行できるGitHub CLI拡張機能です。 GitHub Agentic Workflows(gh-aw)を使うと、開発者はYAML frontmatterを含むMarkdownファイルで、リポジトリ向けのAIエージェントタスクを定義できます。gh aw compileコマンドは各ワークフローを標準的なGitHub Actionsワークフローファイルに変換し、GitHub上で実行します。
gh-aw は無料で使えますか?ライセンスは?
gh-aw は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
gh-aw は今もメンテナンスされていますか?
活発にメンテナンス中。gh-aw の最終コミットは 2026年10月20日 です。
gh-aw は何に使えますか?
新しいissueをトリアージし、自動でラベルを付ける。 CIの一環として、AIエージェントにプルリクエストをレビューさせる。 失敗したCI実行を調査し、原因を要約する。 ドキュメントを最新の状態に保ち、定期的なリポジトリレポートを作成する。
gh-aw のインストール方法は?
GitHub CLI拡張機能をインストールする: gh extension install github/gh-aw クイックスタートに従ってAIエンジンを選択し、サンプルワークフローを追加して、GitHub Actionsで実行する
gh-aw はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/github/gh-aw

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト