project-update-items

前提条件

• 対象の GitHub Project にアイテムが存在すること

• gh

  CLI がインストールされ、認証済みであること（

  project

  スコープ付き）

フロー

Step 1: 更新対象と更新内容を確認する

• 対象の指定方法:
  • クエリフィルタ（例:

    status:Todo

    ,

    label:bug

    ,

    assignee:@me

    ）
  • アイテム番号の直接指定
  • 全件
• 更新するフィールド: Status, Priority, Size, またはカスタムフィールド
• 新しい値: 例: Status → "In Progress", Priority → "High"

Step 2: フィールドメタデータを取得する

# プロジェクト ID を取得
gh project view <number> --owner <owner> --format json -q '.id'

# フィールド ID とオプション ID を取得
gh project field-list <number> --owner <owner> --format json

jq

Step 3: 対象アイテムを検索する

gh project item-list <number> \
  --owner <owner> \
  --format json \
  --limit 999

--query

gh project item-list <number> \
  --owner <owner> \
  --query "status:Todo" \
  --format json

Step 4: ユーザーに更新内容を確認する

以下の N 件のアイテムを更新します:
- #1: ソーシャルログイン — Status: Todo → In Progress
- #2: パスワードリセット — Status: Todo → In Progress

実行しますか？

Step 5: フィールド値を一括更新する

gh project item-edit \
  --id <item-id> \
  --field-id <field-id> \
  --project-id <project-id> \
  --single-select-option-id <option-id>

• SINGLE_SELECT:

  --single-select-option-id

• TEXT:

  --text

• NUMBER:

  --number

• DATE:

  --date

  （YYYY-MM-DD 形式）

Step 6: 更新結果を報告する

注意事項

• バッチ更新前に必ずユーザーの確認を得る
• オプション値がプロジェクトのフィールド定義に存在しない場合はエラーを報告する
• 複数フィールドを同時に更新する場合は、フィールドごとに

  item-edit

  を実行する
• GitHub API レート制限に注意し、大量更新時はバッチサイズを調整する
• sandbox 環境では実行できない（後述の「sandbox 環境での実行」節を参照）

検証

gh project item-list <number> --owner <owner> --format json --limit 999

sandbox 環境での実行