⌨️ クイックスタート（コマンド版）

gh CLI を使ったセットアップ手順です。PAT 作成を除き、すべての操作をターミナルから実行できます。

Tip: Claude Code などの 生成 AI へのプロンプト として、「GitHub Projects Ops Kitのクイックスタート（コマンド版）を参照しながら自分のアカウント上でセットアップして」と命じることで、セットアップ作業の自動化を支援できます。

（ここをクリック）目次
flowchart LR
    A["1. Fork"] --> B["2. PAT 作成"]
    B --> C["3. Secrets 設定"]
    C --> D["4. Actions 有効化"]
    D --> E["5. Workflow 実行"]

✅ 前提条件

1. 🍴 Repository を Fork する

gh repo fork lurest-inc/github-projects-ops-kit --clone
cd github-projects-ops-kit

2. 🔑 PAT を作成する

Note: PAT の作成は GitHub API / CLI では実行できないため、 Web UI から作成してください。

GitHub の Settings > Developer settings > Personal access tokens から PAT を作成します。

必要な権限の詳細は 認証・トークンガイド を参照してください。Fine-grained token の制約事項については Fine-grained token の制約事項 も合わせてご確認ください。

3. 🔒 Secrets を設定する

gh secret set PROJECT_PAT --repo <owner>/github-projects-ops-kit

実行するとプロンプトが表示されるので、作成した PAT を入力してください。

4. ⚡ GitHub Actions を有効化する

Fork した Repository では GitHub Actions がデフォルトで無効になっています。

gh api repos/<owner>/github-projects-ops-kit/actions/permissions \
  --method PUT \
  --field enabled=true \
  --field allowed_actions="all"

Note: 詳しくは トラブルシューティング > Fork 後に GitHub Actions が動かない を参照してください。

5. ▶️ Workflow を実行する

① GitHub Project 新規作成

gh workflow run 01-create-project.yml \
  --field project_title="My Project" \
  --field visibility="PRIVATE"

② GitHub Project 拡張

gh workflow run 02-extend-project.yml \
  --field project_number="<PROJECT_NUMBER>"

④ Issue Label 一括追加

gh workflow run 04-setup-repository-labels.yml \
  --field target_repo="<owner/repo>"

⑤ Issue/PR 一括紐付け

gh workflow run 05-add-items-to-project.yml \
  --field project_number="<PROJECT_NUMBER>" \
  --field target_repo="<owner/repo>" \
  --field item_type="all" \
  --field item_state="open"

👀 Workflow 実行状況の確認

# 実行一覧を表示
gh run list

# 最新の実行をリアルタイムで監視
gh run watch

各 Workflow の詳細は個別ページをご参照ください。