project-setup-automation

GitHub Projects V2 環境自動構築スキル

メタデータ

• トリガー: 「GitHub Project環境構築」「プロジェクトボード設定」「14ステータス設定」「!my_pm_tools」
• 前提条件: gh CLI 認証済み、Classic PAT（ghp_）取得済み、スコープ project,repo,read:org

概要

GitHub Projects V2 の開発環境を一括構築するスキル。 14ステータスワークフロー、5ビュー、カスタムフィールド、ラベル13種、 テンプレート、GitHub Actions 自動化を段階的にセットアップする。

重要: Projects V2 の GraphQL API 操作には Classic PAT（ghp_トークン） が必須。 Fine-grained PAT は個人ユーザー所有の Projects V2 に非対応。

---

Phase 1: 事前確認

1.1 認証確認

# gh CLI 認証状態
gh auth status

# project スコープがない場合
gh auth refresh --scopes "project,repo,read:org"

1.2 リポジトリ・プロジェクト情報取得

# ユーザーに OWNER/REPO と PROJECT_NUMBER を確認
OWNER="<owner>"
REPO="<owner/repo>"
NUMBER=<project_number>

# プロジェクト一覧
gh project list --owner "$OWNER"

# プロジェクト詳細
gh project view "$NUMBER" --owner "$OWNER"

1.3 プロジェクトID取得（GraphQL）

Classic PAT を使って直接 curl で実行（gh CLI はプロキシ経由で別トークンになるため）:

PAT="ghp_XXXXX"

PROJECT_ID=$(curl -s -H "Authorization: bearer $PAT" https://api.github.com/graphql \
  -d "{\"query\":\"query { user(login: \\\"$OWNER\\\") { projectV2(number: $NUMBER) { id } } }\"}" \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['data']['user']['projectV2']['id'])")

echo "Project ID: $PROJECT_ID"

---

Phase 2: カスタムフィールド作成

# Priority (Single Select)
gh project field-create "$NUMBER" --owner "$OWNER" \
  --name "Priority" --data-type "SINGLE_SELECT" \
  --single-select-options "P0 - 即日着手,P1 - 高 (1〜3営業日),P2 - 中 (スプリント内),P3 - 低 (時間あれば),P4 - 未定 (保留中)" \
  2>/dev/null || echo "Priority: 既に存在（スキップ）"

# Estimate (Number)
gh project field-create "$NUMBER" --owner "$OWNER" \
  --name "Estimate" --data-type "NUMBER" \
  2>/dev/null || echo "Estimate: 既に存在（スキップ）"

# Target (Text)
gh project field-create "$NUMBER" --owner "$OWNER" \
  --name "Target" --data-type "TEXT" \
  2>/dev/null || echo "Target: 既に存在（スキップ）"

Sprint (Iteration) フィールド

gh CLI では直接作成不可。GraphQL API で作成:

curl -s -H "Authorization: bearer $PAT" https://api.github.com/graphql \
  -d "{\"query\":\"mutation { createProjectV2IterationField(input: { projectId: \\\"$PROJECT_ID\\\", title: \\\"Sprint\\\", settings: { duration: 7 } }) { field { id name } } }\"}"