GitHub Agentic Workflows（gh-aw）: Markdown で書いた指示を、Copilot・Claude・Codex に GitHub Actions で定期実行させる

gh-aw は、YAML の代わりに「frontmatter 付きの Markdown」でワークフローを書き、GitHub Actions 上でコーディングエージェントに issue の仕分けや CI 失敗の調査、PR 作成をさせる GitHub 製の仕組み。権限、出力先（safe outputs）、コストの制御が最初から付いている。

どんな時に使う？

毎朝のリポジトリ状況レポート、issue の一次仕分け、CI 失敗の原因調査などを自動で回したい
エージェントに GitHub への書き込みを任せたいが、できることは絞りたい

手順

gh v2.0.0 以上でログイン（gh auth login --scopes repo,workflow）
拡張を入れる: gh extension install github/gh-aw（認証で失敗する時は公式のインストールスクリプト）
サンプルを入れて試す: gh aw add-wizard githubnext/agentics/repo-status。対話でエンジン（Copilot、Claude Code、Codex、Gemini など）と認証を選ぶ
自分で書く時は .github/workflows/<名前>.md に、frontmatter（on: のトリガーと safe-outputs: で許す出力）と、本文に指示を書く
markdown
```
---
on: daily
safe-outputs:
  create-issue:
---
昨日の issue を要約し、返信が必要なものに印を付けて。
```
エージェントに丸ごと任せるなら、公式の install.md を読ませて初期化させる方法もある

注意点

有効にする前に、選んだエンジンのデータの扱い、リポジトリの機密度、ログやアーティファクトに誰が触れるかを確認する（公式のクイックスタートもそう求めている）
エージェントが作った変更はマージ前にレビューする
各エンジンの API 利用料や Actions の実行時間がかかる

出典

@azu_re · 2026-02-11
公式: github.github.io/gh-aw/ ・クイックスタート github.github.io