エージェンティック・ワークフロー

一言で

Agentic Workflow は GitHub Actions の上で AI エージェント が作業を自動化する仕組み。

cron や issue / PR イベントをきっかけに、文脈を読み、判断し、実行する。

仕組み

概要

GitHub Actions 上で AI エージェント が作業を自動化
現在テクニカルプレビュー中（2026 年 2 月 13 日発表）

構成要素

⚡ トリガー — schedule (cron) / issue / PR / comment / @mention など Actions と同じ
📄 記述 — .github/workflows/NAME.md に 自然言語の Markdown で「やってほしいこと」を書く
🤖 エージェント — Copilot / Claude / Codex などをランナー上で起動
🔌 MCP / ツール — エージェントが GitHub API・外部サービスを呼び出して実作業
🛡️ safe-outputs — デフォルト read-only。書き込みは PR / コメント / Label など 検証済みの境界 経由のみ

何ができるか

ユースケース	何をする
🏷️ Issue Triage	新しい issue を読み、ラベル付け・優先度判定・担当者提案を自動化。曖昧なら追加情報をリクエスト
📚 Wiki Generator	コードベースを定期スキャンし、Wiki / README を自動生成・更新
🔍 CI Failure Analyst	失敗した CI を読み解き、原因を特定して PR にコメント
📝 Docs Maintainer	古いリンク・例・API 説明を検出し、最新の実装に合わせて修正 PR を起こす

🧪 サンプル集 githubnext/agentics に動くテンプレートが揃っている。コピペで動かせる。
📝 開発者の実例ブログ Peli’s Agent Factory も最初に読むと雰囲気が掴める。

始め方（4 ステップ）

Step 1 — CLI 拡張をインストール — gh extension install github/gh-aw
Step 2 — Markdown を書く — .github/workflows/NAME.md にトリガーと指示を記述
Step 3 — コンパイル — gh aw compile で NAME.lock.yml を生成
Step 4 — コミット & push — lock ファイルを含めて push、以降は Actions が自動起動

---
on:
  issues:
    types: [opened]
permissions: read-all
safe-outputs:
  add-comment:
---

# Issue Clarifier
新しく開かれた issue を読み、要件が曖昧なら
- 何が起きているのか / 再現手順 / 期待される挙動
の 3 点を確認するコメントを投稿せよ。明確なら何もしない。

⚠️ lock ファイルは Git にコミット。これが実際に動く Actions ワークフローで、監査・レビューの対象。