github-labels

GitHub のラベル

GitHub の PR や issue のラベルを確認し、適用するためのリファレンスです。

このスキルを使用する場面

次の場合にこのスキルを使用します…	次の場合は別のものを使用します…
リポジトリで利用可能なラベルを一覧表示する	マイルストーンを作成または管理する
PR／issue のラベルを追加または削除する	GitHub Projects のボードを管理する
色を指定して新しいラベルを作成する	多数の issue を一括編集する
issue のラベルを PR に引き継ぐ	PR のレビュアーや担当者を設定する

利用可能なラベルの確認

# List all labels with details
gh label list --json name,description,color --limit 50

# Search for specific labels
gh label list --search "bug"

# Output as simple list
gh label list --json name -q '.[].name'

PR へのラベルの追加

# Single label
gh pr create --label "bug"

# Multiple labels (repeat flag)
gh pr create --label "bug" --label "priority:high"

# Comma-separated
gh pr create --label "bug,priority:high"

# Add to existing PR
gh pr edit 123 --add-label "ready-for-review"

issue へのラベルの追加

# Create with labels
gh issue create --label "bug,needs-triage"

# Add to existing issue
gh issue edit 123 --add-label "in-progress"

# Remove label
gh issue edit 123 --remove-label "needs-triage"

一般的なラベルのカテゴリ

カテゴリ	例
種類	bug、feature、enhancement、documentation、chore
優先度	priority:critical、priority:high、priority:medium、priority:low
状態	needs-triage、in-progress、blocked、ready-for-review
分野	frontend、backend、infrastructure、testing、ci-cd

ラベルを引き継ぐパターン

issue から PR を作成するとき：

1. gh issue view N --json labels で issue のラベルを確認します
2. 同じラベルを PR に適用します：gh pr create --label "label1,label2"

これにより、追跡可能性と一貫した分類を維持できます。

エージェント向けの最適化

コンテキスト	コマンド
すべてのラベルを一覧表示する（機械可読形式）	gh label list --json name,description,color --limit 50
ラベル名のみを取得する	gh label list --json name -q '.[].name'
PR にラベルを通知なしで追加する	gh pr edit $PR --add-label "label"
現在の issue のラベルを確認する	gh issue view $ISSUE --json labels -q '.labels[].name'
issue のラベルを PR に引き継ぐ	`gh issue view $ISSUE --json labels -q '[.labels[].name]