📊 Operate STEP 14 / 15 ⏱ 15分 ⏳ 残り20分

OPERATE: Agentic Workflow

Agentic Workflow とは: GitHub Actions のワークフロー内で Copilot を活用し、リポジトリの変更に応じた自律的なタスク（レポート生成、ドキュメント更新、コード修正など）を実行する仕組みです。

14.1 — Copilot ポリシーと Workflow permissions を確認する

以前は Copilot を使うために PAT（Personal Access Token）の作成・保管が必要でしたが、現在は GitHub Actions 組み込みの GITHUB_TOKEN で動作するため PAT は不要 になりました。長期間有効な PAT を管理する運用・セキュリティ上のリスクがなくなります。

組織が所有するリポジトリで実行すると、消費した AI クレジットは組織に直接請求されます。これを使うために、以下を確認します。

Copilot ポリシーの確認

  1. Organization の Settings → Copilot → Policies
  2. Allow use of Copilot CLI billed to the organization が有効になっていることを確認（既存の Copilot CLI ポリシーが有効であれば既定で有効）

組織への課金を有効にするには、ワークフローの front matter の permissions に copilot-requests: write を追加します（14.3 のプロンプトに含まれています）。

Workflow permissions の確認

  1. Settings → Actions → General
  2. Allow GitHub Actions to create and approve pull requests にチェック

14.2 — （Codespace を使っていない場合）gh-aw 拡張をインストールする

Agentic Workflow をコンパイルする gh aw コマンドは、GitHub CLI の拡張機能 gh-aw で提供されます。ワークショップ用の Codespace には プリインストール済み なので、この手順はスキップして構いません。ローカル環境で作業していてまだ入っていない場合だけ、以下を実行します：

gh extension install github/gh-aw

14.3 — Daily Repo Status ワークフローを作成する

今日のリポジトリ活動を自動レポートする Agentic Workflow を作成しましょう。

エージェントモードで以下を実行：

以下の Agentic Workflow を作成してください。

ファイル: .github/workflows/daily-repo-status.md

目的: リポジトリの活動（Issue、PR、コード変更）を分析し、
日次ステータスレポートを Issue として自動作成する。

フォーマット:
- YAML front matter で設定を定義（on, permissions, tools, safe-outputs）
- Markdown 本文でワークフローの指示を記述

設定:
- トリガー: schedule: daily と workflow_dispatch
- permissions: contents: read, issues: read, pull-requests: read,
  copilot-requests: write（組織課金を有効にするため）
- tools: github（lockdown: false, min-integrity: none）
- safe-outputs: create-issue で title-prefix "[repo-status] "、
  labels: [report, daily-status]、close-older-issues: true

ワークフローの指示:
1. リポジトリの最近の活動（Issue、PR、コード変更）を収集
2. 進捗やハイライトを分析
3. 結果を GitHub Issue として作成

参考: https://github.com/githubnext/agentics/blob/main/workflows/daily-repo-status.md

完了したら `gh aw compile` コマンドを実行してワークフローをコンパイルし、
変更をコミットして PR を作成してください。

PR をマージした後、Actions タブからワークフローを手動実行します：

  1. リポジトリの Actions タブを開く
  2. 左メニューから Daily Repo Status を選択
  3. Run workflow → Run workflow をクリック

Actions から手動実行

実行完了後（⏱ 約2分）、リポジトリの Issues タブに [repo-status] というプレフィックスの Issue が自動作成され、今日の PR、Issue、コード変更の活動サマリーが表示されます。