关于 glab-label
用于通过 glab 管理 GitLab 标签的技能,涵盖项目级和群组级标签的创建、列表、编辑、删除及 JSON 查询。
主要功能
- 01创建项目级和群组级标签
- 02分页列出标签
- 03编辑和删除标签
- 04以 JSON 获取标签详情
适用场景
- 01为群组建立共享标签体系
- 02管理项目专属工作流标签
- 03查看分页返回的标签
- 04为 Agent 自动化获取标签数据
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ vince-winkintel/ gitlab-cli-skills --skill glab-label安装后在 Claude Code 中输入/glab-label确认已加载。
附带文件references/commands.mdscripts/batch-label-issues.sh
详细介绍
glab label
在项目和群组级别管理标签。
快速开始
# Create project label
glab label create --name bug --color "#FF0000"
# Create group label
glab label create --group my-group --name priority::high --color "#FF6B00"
# List labels
glab label list
# Update label
glab label edit bug --color "#CC0000" --description "Software defects"
# Delete label
glab label delete bug
决策:项目级标签还是群组级标签?
Where should this label live?
├─ Used across multiple projects in a group
│ └─ Group-level: glab label create --group <group> --name <label>
└─ Specific to one project
└─ Project-level: glab label create --name <label>
适用群组级标签的场景:
- 希望群组中的所有项目使用一致的标签
- 管理组织范围内的工作流
- 示例:
priority::high、type::bug、status::blocked - 减少重复,确保一致性
适用项目级标签的场景:
- 标签仅适用于项目特定的工作流
- 团队希望自行管理标签
- 示例:
needs-ux-review、deploy-to-staging、legacy-code
常见工作流
创建标签分类体系
设置优先级标签(群组级):
glab label create --group engineering --name "priority::critical" --color "#FF0000"
glab label create --group engineering --name "priority::high" --color "#FF6B00"
glab label create --group engineering --name "priority::medium" --color "#FFA500"
glab label create --group engineering --name "priority::low" --color "#FFFF00"
设置类型标签(群组级):
glab label create --group engineering --name "type::bug" --color "#FF0000"
glab label create --group engineering --name "type::feature" --color "#00FF00"
glab label create --group engineering --name "type::maintenance" --color "#0000FF"
管理项目专用标签
创建工作流标签:
glab label create --name "needs-review" --color "#428BCA"
glab label create --name "ready-to-merge" --color "#5CB85C"
glab label create --name "blocked" --color "#D9534F"
批量操作
列出所有标签以供检查:
glab label list --per-page 100 > labels.txt
当 GitLab 在分页响应中提供总数时,文本标题会报告实际的标签总数,而不只是当前页面返回的数量。使用 --page 和 --per-page 获取后续页面;如果显示的总数大于列出的行数,不要据此推断所有标签都已列出。
删除已弃用的标签:
glab label delete old-label-1
glab label delete old-label-2
相关技能
使用标签:
- 查看
glab-issue,了解如何为议题应用标签 - 查看
glab-mr,了解如何为合并请求应用标签 - 脚本:
scripts/batch-label-issues.sh,用于批量应用标签
结构化输出
glab label get 支持 --output json / -F json 结构化输出,便于 Agent 自动化。
# Get a label with JSON output
glab label get <label-id> --output json
glab label get <label-id> -F json
命令参考
完整的命令文档和所有标志,请参阅 references/commands.md。
可用命令:
create- 创建标签(项目级或群组级)list- 列出标签edit- 更新标签属性delete- 删除标签get- 查看单个标签的详细信息
评论
支持 Markdown