How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/fandhe-ai/agent-cli-skills --skill project-update-itemsBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
project-update-items
プロジェクトアイテムのフィールド値を一括で更新します。ステータス変更、優先度変更、サイズ設定などに対応します。
前提条件
- 対象の GitHub Project にアイテムが存在すること
ghCLI がインストールされ、認証済みであること(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 jsonjq で対象フィールドの ID と、更新先の値に対応するオプション ID を解決する。
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 jsonStep 4: ユーザーに更新内容を確認する
更新対象と変更内容を一覧表示:
以下の N 件のアイテムを更新します:
- #1: ソーシャルログイン — Status: Todo → In Progress
- #2: パスワードリセット — Status: Todo → In Progress
実行しますか?一括更新の前に確認し、明示的な返答を待つ。「Todo を全部 In Progress に変更して」等、このスキルを起動する依頼そのものは、この確認の承認にならない。起動時の指示にこの確認を省くことの明示(例: 「確認なしで進めてよい」)が含まれている場合に限り、確認を省いて続行してよい。承認が無く対話もできない環境(非対話実行)では、実行せずに対象(件数・タイトル等)と確認事項を報告して止める。
Step 5: フィールド値を一括更新する
Step 4 で承認を得たら、更新を実行する。
各アイテムに対してフィールド値を更新:
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: 更新結果を報告する
更新されたアイテムの一覧を表示:
| # | タイトル | フィールド | 旧値 | 新値 |
|---|---|---|---|---|
| 1 | ソーシャルログイン | Status | Todo | In Progress |
| 2 | パスワードリセット | Status | Todo | In Progress |
注意事項
- バッチ更新前にユーザーの確認を得る(Step 4 の確認を参照)
- オプション値がプロジェクトのフィールド定義に存在しない場合はエラーを報告する
- 複数フィールドを同時に更新する場合は、フィールドごとに
item-editを実行する - GitHub API レート制限に注意し、大量更新時はバッチサイズを調整する
- ネットワークを要する(主に API 経由。後述の「sandbox 環境での実行」節を参照)
検証
Step 6 完了後、以下で更新内容を確認する:
gh project item-list <number> --owner <owner> --format json --limit 999対象アイテムのフィールド値が新しい値に変わっていれば完了。
sandbox 環境での実行
このスキルはネットワーク越しの GitHub 操作(gh project item-edit)を必須とする。該当コマンドはコマンド単位で sandbox 無効にして実行する。ネットワーク遮断を解除できない環境では実行できない。.git・.agents・.codex へ書く手順は無い。codex exec では昇格要求が出ないため、ネットワークを使えずコマンドを実行できなかったときは、書き込みをせず、できなかった旨を報告して止める。
