| name | github-project |
| description | GitHub Projects (Projects V2) の情報取得・操作を行う。Use when Claude needs to: (1) List/view GitHub Projects, (2) Get items/fields from a project, (3) Add/edit/delete project items, (4) Create/manage project fields |
GitHub Project
gh project コマンドを使用して GitHub Projects (Projects V2) を操作するための Skill。
認証要件
project scope が必要:
gh auth refresh -s project
プロジェクトURLと引数の関係
GitHub Projects の URL と gh project コマンドの引数の対応:
| URL形式 | owner | project number |
|---|
https://github.com/users/monalisa/projects/1 | monalisa | 1 |
https://github.com/orgs/github/projects/5 | github | 5 |
https://github.com/users/me/projects/3 | @me | 3 |
gh project view 1 --owner monalisa
gh project item-list 5 --owner github
gh project field-list 3 --owner @me
共通オプション
詳細は common-options.md を参照。
| オプション | 説明 |
|---|
--format json | JSON形式で出力 |
--jq <expr> | jq式でフィルタリング |
--owner <login> | オーナー指定（@meで現在のユーザー） |
--limit <n> | 取得件数（デフォルト30） |
-t, --template | Go テンプレートでフォーマット |
-w, --web | ブラウザで開く |
Helper Scripts
このスキルの配置場所 (SKILL.md があるディレクトリ) からの相対パスでアクセス:
$SKILL_DIR/scripts/gh-project-items <project-number> --owner <owner> [--column <name>]
| スクリプト | 用途 |
|---|
scripts/gh-project-items | カラム名でアイテムをフィルタして取得 |
詳細は gh-project-items.md を参照。
Quick Commands
プロジェクト情報
gh project list --owner @me
gh project list --owner github --closed
gh project view 1 --owner @me
gh project view 1 --owner github --web
アイテム操作
gh project item-list 1 --owner @me
gh project item-list 1 --owner @me --query "status:Todo"
gh project item-add 1 --owner @me --url https://github.com/owner/repo/issues/123
gh project item-create 1 --owner @me --title "Draft Issue" --body "Description"
gh project item-edit --id <item-id> --project-id <project-id> --field-id <field-id> --text "value"
gh project item-delete --id <item-id> --project-id <project-id>
フィールド操作
gh project field-list 1 --owner @me
gh project field-create 1 --owner @me --name "Priority" --single-select-option "High,Medium,Low"
プロジェクト管理
gh project create --owner @me --title "New Project"
gh project copy 1 --owner @me --new-title "Copied Project"
gh project edit 1 --owner @me --title "Updated Title"
gh project close 1 --owner @me
Common Workflows
1. プロジェクトのアイテムを確認
gh project item-list 1 --owner @me --format json --jq '.[] | {title: .title, status: .status}'
2. Issue をプロジェクトに追加
gh project item-add 1 --owner github --url https://github.com/github/repo/issues/456
3. アイテムのフィールド値を更新
まずフィールドIDを取得:
gh project field-list 1 --owner @me --format json --jq '.[] | select(.name=="Status") | .id'
次にアイテムIDを取得:
gh project item-list 1 --owner @me --format json --jq '.[] | select(.title=="My Issue") | .id'
最後に更新:
gh project item-edit --id <item-id> --project-id <project-id> --field-id <field-id> --single-select-option-id <option-id>
4. フィルタを使ってアイテム検索
gh project item-list 1 --owner @me --query "label:bug status:In\\ Progress"
全コマンド詳細
各コマンドの詳細は commands.md を参照。
