用途
gitlab-cli-skills 是一套关于 GitLab CLI(glab)的命令参考与工作流指南。它帮助用户了解 glab 的各个命令域,并在合并请求、议题、CI/CD、仓库等场景下选择合适的命令与流程。
主要能力
资料显示该技能按 GitLab 领域路由到多个子技能,包括:
- 核心工作流:glab-mr(合并请求:创建、评审、批准、合并)、glab-issue(议题:创建、列出、更新、关闭、评论)、glab-ci(CI/CD:流水线、作业、日志、制品)、glab-repo(仓库:克隆、创建、复刻、管理)。
- 项目管理:glab-milestone(发布规划与里程碑跟踪)、glab-iteration(冲刺/迭代管理)、glab-label(标签管理)、glab-release(软件发布与版本管理)。
- 认证与配置:glab-auth(登录、登出、Docker 仓库认证)、glab-config(CLI 配置与默认值)、glab-ssh-key(SSH 密钥管理)、glab-gpg-key(提交签名用的 GPG 密钥)、glab-token(个人与项目访问令牌)。
- CI/CD 管理:glab-job(单个作业操作)、glab-schedule(计划流水线与定时任务)、glab-variable(CI/CD 变量与密钥)、glab-securefile(流水线安全文件)、glab-runner(Runner 管理:列出、暂停、删除,v1.87.0 新增)、glab-runner-controller(Runner 控制器与令牌管理,实验性,仅管理员)。
- 协作:glab-user(用户资料与信息)、glab-snippet(代码片段)、glab-incident(事件管理)、glab-workitems(工作项:任务、OKR、关键结果、新一代史诗,v1.87.0 新增)。
- 高级功能:glab-api(直接 REST API 调用)、glab-cluster(Kubernetes 集群集成)、glab-deploy-key(自动化部署密钥)、glab-stack(堆叠/依赖式合并请求)、glab-opentofu(Terraform/OpenTofu 状态管理)。
- 实用工具:glab-alias(自定义命令别名)、glab-completion(Shell 自动补全)、glab-help(命令帮助与文档)、glab-version(版本信息)、glab-check-update(更新检查)、glab-changelog(变更日志生成)、glab-attestation(软件供应链安全)、glab-duo(GitLab Duo AI 助手)、glab-mcp(供 AI 助手集成的 Model Context Protocol 服务器,实验性)。
使用方式
资料给出的快速开始示例:
# First time setup
glab auth login
# Common operations
glab mr create --fill # Create MR from current branch
glab issue create # Create issue
glab ci view # View pipeline status
glab repo view --web # Open repo in browser
常见工作流示例:
- 日常开发:用 glab issue view 查看议题,创建分支,用 glab mr create --fill --draft 创建草稿 MR,用 glab mr update --ready 标记就绪,用 glab mr merge --when-pipeline-succeeds --remove-source-branch 合并。
- 代码评审:用 glab mr list --reviewer=@me --state=opened 列出评审队列,用 glab mr checkout 检出,用 glab mr diff 查看差异,运行测试,用 glab mr approve 批准,用 glab mr note 添加评论。
- CI/CD 调试:用 glab ci status 查看流水线状态,用 glab ci view 查看失败的作业,用 glab ci trace <job-id> 获取作业日志,用 glab ci retry <job-id> 重试失败作业。
资料还提供了命令选择决策树,例如按需要选择流水线级(glab ci status、glab ci view、glab ci run)或作业级(glab ci trace、glab job retry、glab job view)命令,以及克隆与复刻的选择依据。
适用场景
资料建议在以下情况使用 glab:在脚本中自动化 GitLab 操作、以终端为中心的工作流、批量操作(多个 MR/议题)、与其他 CLI 工具集成、CI/CD 流水线工作流、无需切换浏览器上下文的快速导航。资料建议在以下情况使用网页界面:带内联评论的复杂差异评审、可视化合并冲突解决、配置仓库设置与权限、跨项目的高级搜索/筛选、查看安全扫描结果、管理群组/实例级设置。
限制
资料标注 glab-runner-controller 与 glab-mcp 为实验性功能,其中 glab-runner-controller 仅限管理员使用。其他具体限制暂未提供。