gitlab-cli-guide 是 GitLab 命令行工具 glab 的完整命令参考与工作流指南,以技能形式组织,按 GitLab 功能域路由到专项子技能。
用途与组织方式:技能根入口负责总览与路由,具体能力拆分为多个子技能,包括核心工作流(glab-mr 合并请求的创建、审查、批准、合并;glab-issue 的创建、列表、更新、关闭、评论;glab-ci 的流水线、任务、日志、产物;glab-repo 的克隆、创建、Fork、管理)、项目管理(glab-milestone 里程碑、glab-iteration 迭代、glab-label 标签、glab-release 发布)、认证与配置(glab-auth 登录登出与 Docker Registry 认证、glab-config 默认设置、glab-ssh-key、glab-gpg-key、glab-token)、CI/CD 管理(glab-job、glab-schedule 定时流水线、glab-variable 变量与密钥、glab-securefile、glab-runner、glab-runner-controller)、协作(glab-user、glab-snippet、glab-incident、glab-workitems)以及进阶与工具类(glab-api 直接调用 REST API、glab-cluster、glab-deploy-key、glab-stack、glab-opentofu、glab-alias、glab-completion、glab-help、glab-version、glab-check-update、glab-changelog、glab-attestation、glab-duo、glab-mcp 等)。
使用方式:首次需执行 glab auth login 完成认证,随后在终端使用各子命令,例如 glab mr create --fill 从当前分支创建合并请求、glab issue create 创建 Issue、glab ci view 查看流水线状态、glab repo view --web 在浏览器打开仓库。资料还给出日常工作流示例:查看 Issue 后新建分支、以草稿创建 MR、标记可审查、在流水线成功后合并并删除源分支;代码审查时列出待审查 MR、检出并查看 diff、本地测试后批准并留言;CI/CD 调试时查看流水线状态、定位失败任务、获取任务日志、重试失败任务。文档另提供决策树,帮助判断先创建 Issue 还是直接创建 MR、选用哪个 CI 命令、克隆还是 Fork、使用项目标签还是群组标签,并附有脚本提示(如 create-mr-from-issue.sh、ci-debug.sh、sync-fork.sh)用于自动化相关流程。
适用场景:在脚本中自动化 GitLab 操作、终端中心工作流、批量处理多个 MR/Issue、与其他 CLI 工具集成、CI/CD 流水线工作流以及免浏览器快速导航;复杂 diff 行内审查、可视化合并冲突、仓库权限配置、跨项目高级搜索、安全扫描结果查看和群组/实例级设置管理则更适合 Web 界面。
限制:子命令的版本差异与实验性能力(如 runner-controller、glab-mcp)已在资料中标注,但具体参数细节、安装方式、权限要求与完整脚本内容暂未提供,需查阅各子技能或官方文档确认;部分能力仅限管理员使用。