⑤ Issue/PR 一括紐付け

Project に Repository の Issue/PR を一括追加します。また、 Repository と Project のリンク（紐付け）を自動的に行い、 Repository の Projects タブから Project へアクセスできるようにします。

（ここをクリック）目次

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

✅ 前提

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

📖 使い方

Actions タブを開く
⑤ Issue/PR 一括紐付け を選択
Run workflow をクリック
パラメータを入力して実行

⚙️ パラメータ

パラメータ	説明	必須	タイプ	例
`project_number`	対象 Project の Number	✅	`number`	`1`
`target_repo`	対象 Repository（`owner/repo` 形式）	✅	`string`	`myorg/myrepo`
`item_type`	対象 Item の種別	✅	`choice`	`all`（デフォルト）
`item_state`	取得する Item の状態	✅	`choice`	`open`（デフォルト）
`item_label`	絞り込み Label（指定 Label のみ追加）	-	`string`	`bug`

Item 種別

選択肢	説明
`all`	`Issue` と `Pull Request` の両方
`issues`	`Issue` のみ
`prs`	`Pull Request` のみ

Item 状態

選択肢	説明
`open`	オープン状態のもの
`closed`	クローズ状態のもの（`CLOSED` + `MERGED` を含む）
`all`	すべての状態

Note: 既に Project に追加済みの Item は自動的にスキップされます。 Note: Repository と Project のリンクは自動的に行われます。既にリンク済みの場合はスキップされます。

📊 処理フロー

flowchart TD
    A["workflow_dispatch\n（project_number・target_repo・フィルタ条件）"] --> B["add-items Job\nRepositoryと Project のリンク確認\n（未リンクならリンク作成）"]
    B --> C["Issue/PR を取得し\nProject に一括追加（追加済みはスキップ）"]
    C --> D{"結果判定"}
    D -- "成功" --> E["workflow-summary-success Job\n成功サマリーを出力"]
    D -- "失敗" --> F["workflow-summary-failure Job\n失敗サマリーを出力"]

🔧 Workflow 仕様

ファイル

.github/workflows/05-add-items-to-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_` で始まるか検証）
`TARGET_REPO`	`inputs.target_repo`	対象 Repository
`ITEM_TYPE`	`inputs.item_type`	Item 種別フィルタ
`ITEM_STATE`	`inputs.item_state`	Item 状態フィルタ
`ITEM_LABEL`	`inputs.item_label`	Label フィルタ

Note: PROJECT_PAT が未設定または無効な形式の場合、 PAT を使用するステップはスキップされます。

Job 構成

.github/workflows/05-add-items-to-project.yml
  ├── add-items Job
  │   └── scripts/add-items-to-project.sh          # Issue/PR 一括追加
  ├── workflow-summary-failure Job（失敗時）
  │   └── .github/actions/workflow-summary         # 失敗サマリー出力
  └── workflow-summary-success Job（成功時）
      └── .github/actions/workflow-summary         # 成功サマリー出力

📜 関連スクリプト

add-items-to-project.sh — Issue/PR 一括追加スクリプト