gitlab-label

ラベルスキル

glab CLI を使った GitLab のラベル管理操作です。

クイックリファレンス

操作	コマンド	リスク
ラベルを一覧表示	glab label list	-
ラベルを作成	glab label create <name>	⚠️

リスクの凡例：- 安全 | ⚠️ 注意 | ⚠️⚠️ 警告 | ⚠️⚠️⚠️ 危険

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

必ず使用する場面：

• ユーザーがプロジェクトのラベルを管理したい場合
• ユーザーが「label」、「tag」（分類用）、「category」に言及した場合
• ユーザーがイシューや MR を整理したい場合

使用しない場面：

• ユーザーがイシューや MR にラベルを適用したい場合（gitlab-issue または gitlab-mr を使用）
• ユーザーが Git タグを管理したい場合（Git コマンドまたは gitlab-release を使用）

使用可能なコマンド

ラベルの一覧表示

glab label list [options]

オプション：

フラグ	説明
-P, --per-page=<n>	ページあたりの結果数
--all	すべてのラベルを取得

例：

# List all project labels
glab label list

# List with more results
glab label list --per-page=100

ラベルの作成

glab label create <name> [options]

オプション：

フラグ	説明
-c, --color=<color>	ラベルの色（16 進数形式、例：#ff0000）
-d, --description=<desc>	ラベルの説明

例：

# Create label with default color
glab label create "needs-review"

# Create label with color
glab label create "bug" -c "#ff0000"

# Create label with color and description
glab label create "priority::high" \
  -c "#dc3545" \
  -d "High priority items requiring immediate attention"

# Create scoped label
glab label create "status::in-progress" \
  -c "#ffc107" \
  -d "Work in progress"

よく使われるラベルのパターン

優先度ラベル

glab label create "priority::critical" -c "#dc3545" -d "Must fix immediately"
glab label create "priority::high" -c "#fd7e14" -d "Fix in current sprint"
glab label create "priority::medium" -c "#ffc107" -d "Fix soon"
glab label create "priority::low" -c "#28a745" -d "Nice to have"

種類ラベル

glab label create "type::bug" -c "#d73a4a" -d "Something isn't working"
glab label create "type::feature" -c "#0366d6" -d "New feature request"
glab label create "type::docs" -c "#0075ca" -d "Documentation"
glab label create "type::refactor" -c "#6f42c1" -d "Code refactoring"

ステータスラベル

glab label create "status::backlog" -c "#6c757d" -d "In backlog"
glab label create "status::ready" -c "#17a2b8" -d "Ready to start"
glab label create "status::in-progress" -c "#ffc107" -d "Work in progress"
glab label create "status::review" -c "#007bff" -d "In review"
glab label create "status::done" -c "#28a745" -d "Completed"

ワークフローラベル

glab label create "needs-review" -c "#d876e3" -d "Needs code review"
glab label create "needs-design" -c "#fbca04" -d "Needs design input"
glab label create "blocked" -c "#b60205" -d "Blocked by external dependency"
glab label create "help-wanted" -c "#008672" -d "Looking for contributors"

GitLab のスコープ付きラベル

GitLab は :: 区切り文字を使ったスコープ付きラベルに対応しています。

priority::high
status::in-progress
type::bug

イシューや MR に適用できるラベルはスコープごとに 1 つだけで、相互に排他的です。

よくあるワークフロー

ワークフロー 1：新規プロジェクトのラベルを設定する

# Create priority labels
glab label create "priority::critical" -c "#dc3545"
glab label create "priority::high" -c "#fd7e14"
glab label create "priority::medium" -c "#ffc107"
glab label create "priority::low" -c "#28a745"

# Create type labels
glab label create "type::bug" -c "#d73a4a"
glab label create "type::feature" -c "#0366d6"
glab label create "type::docs" -c "#0075ca"

ワークフロー 2：イシューにラベルを適用する

# List available labels
glab label list

# Create issue with labels
glab issue create -t "Fix login bug" -l "type::bug,priority::high"

# Update issue labels
glab issue update 42 -l "status::in-progress"

色のリファレンス

ラベルによく使われる色：

色	16 進数	用途
赤	#dc3545	バグ、重大、ブロック中
オレンジ	#fd7e14	高優先度、警告
黄色	#ffc107	中優先度、進行中
緑	#28a745	完了、低優先度、初めてのイシューに適している
青	#007bff	機能、情報、レビュー
紫	#6f42c1	リファクタリング、機能強化
グレー	#6c757d	バックログ、対応しない

トラブルシューティング

問題	原因	解決策
認証に失敗した	トークンが無効または期限切れ	glab auth login を実行する
ラベルがすでに存在する	名前が重複している	別の名前を使うか、既存のラベルを更新する
色が無効	形式が正しくない	16 進数形式を使う：#RRGGBB
権限が拒否された	メンテナーではない	メンテナー以上のロールが必要

関連ドキュメント

• 安全対策
• クイックリファレンス