gitlab-label

标签技能

使用 glab CLI 管理 GitLab 标签。

快速参考

操作	命令	风险
列出标签	glab label list	-
创建标签	glab label create <name>	⚠️

风险说明：- 安全 | ⚠️ 注意 | ⚠️⚠️ 警告 | ⚠️⚠️⚠️ 危险

何时使用此技能

始终在以下情况使用：

• 用户想要管理项目标签
• 用户提到“标签”“标记”（用于分类）或“类别”
• 用户想要整理议题或 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>	标签颜色（十六进制格式，例如 #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：设置新项目标签

# 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"

颜色参考

常用标签颜色：

颜色	十六进制	用途
红色	#dc3545	Bug、严重问题、受阻
橙色	#fd7e14	高优先级、警告
黄色	#ffc107	中优先级、进行中
绿色	#28a745	已完成、低优先级、适合新手处理的议题
蓝色	#007bff	功能、信息、评审
紫色	#6f42c1	重构、增强
灰色	#6c757d	待办、不予修复

故障排除

问题	原因	解决方案
身份验证失败	令牌无效或已过期	运行 glab auth login
标签已存在	名称重复	使用其他名称或更新现有标签
颜色无效	格式错误	使用十六进制格式：#RRGGBB
权限被拒绝	不是维护者	需要维护者或更高角色

相关文档

• 安全措施
• 快速参考