② GitHub Project 拡張

既存の Project に Field ・ Status ・ View を追加します。 ① GitHub Project 新規作成 を実行していない既存 Project 向けです。

（ここをクリック）目次

• ✅ 前提
• 📖 使い方
• ⚙️ パラメータ
• 📊 処理フロー
• 🔧 Workflow 仕様
• 📜 関連スクリプト

✅ 前提

この Workflow を実行する前に、クイックスタートを完了してください。

• クイックスタート（GUI）
• クイックスタート（CLI）

📖 使い方

1. Actions タブを開く
2. ② GitHub Project 拡張 を選択
3. Run workflow をクリック
4. パラメータを入力して実行

⚙️ パラメータ

パラメータ	説明	必須	タイプ	例
project_number	対象 Project の Number	✅	number	1

📊 処理フロー

flowchart TD
    A["workflow_dispatch\n（project_number）"] --> B["extend-project Job\n既存 Project にField・Status・View を追加"]
    B --> C{"結果判定"}
    C -- "成功" --> D["workflow-summary-success Job\n成功サマリーを出力"]
    C -- "失敗" --> E["workflow-summary-failure Job\n失敗サマリーを出力"]

🔧 Workflow 仕様

ファイル

.github/workflows/02-extend-project.yml

トリガー

workflow_dispatch（手動実行）

環境変数

環境変数	ソース	説明
GH_TOKEN	secrets.PROJECT_PAT	GitHub PAT（Projects 操作権限）
PROJECT_OWNER	github.repository_owner	Project オーナー
PROJECT_NUMBER	inputs.project_number	対象 Project Number
PROJECT_PAT	secrets.PROJECT_PAT	PAT 形式検証用（ghp_ または github_pat_ で始まるか検証）

Note: 環境変数は Reusable Workflow _reusable-extend-project.yml 内で設定されます。PROJECT_PAT が未設定または無効な形式の場合、 PAT を使用するステップはスキップされます。

Job 構成

.github/workflows/02-extend-project.yml
  ├── extend-project Job
  │   └── _reusable-extend-project.yml             # Field・Status・View セットアップ
  │       ├── scripts/setup-project-status.sh      # Statusカラム設定
  │       ├── scripts/setup-project-fields.sh      # カスタムField作成
  │       └── scripts/setup-project-views.sh       # View 作成
  ├── workflow-summary-failure Job（失敗時）
  │   └── .github/actions/workflow-summary         # 失敗サマリー出力
  └── workflow-summary-success Job（成功時）
      └── .github/actions/workflow-summary         # 成功サマリー出力

📜 関連スクリプト

• setup-project-status.sh — カスタム Status 作成スクリプト
• setup-project-fields.sh — カスタム Field 作成スクリプト
• setup-project-views.sh — View 作成スクリプト