gitlab-cli-guide

name	gitlab-cli-guide
description	提供 GitLab 命令行工具（glab）的完整参考与自动化脚本，涵盖超过30个子命令，包括合并请求创建与审查、CI/CD流水线调试、Issue管理、仓库操作和认证配置等核心工作流。适用于通过终端管理MR/Issue、调试CI失败任务、批量打标签、同步Fork和发布Release等场景。当用户提到glab、GitLab命令行、GitLab CLI、MR管理、流水线调试、glab auth、glab ci或glab mr等关键词时触发。
metadata	{"openclaw":{"requires":{"bins":"[Truncated]","anyBins":"[Truncated]"},"install":["[Truncated]","[Truncated]"]}}
requirements	{"binaries":["glab"],"binaries_optional":["cosign"],"notes":"Requires GitLab authentication via 'glab auth login' (stores token in ~/.config/glab-cli/config.yml).\nSome features may access sensitive files: SSH keys (~/.ssh/id_rsa for DPoP), Docker config (~/.docker/config.json for registry auth).\nReview auth workflows and script contents before autonomous use.\n"}
openclaw	{"requires":{"credentials":["[Truncated]"],"network":["[Truncated]"],"write_access":["[Truncated]"]}}

GitLab CLI 技能集

GitLab CLI（glab）完整命令参考与工作流指南。

快速开始

# 首次配置
glab auth login

# 常用操作
glab mr create --fill              # 从当前分支创建合并请求
glab issue create                  # 创建 Issue
glab ci view                       # 查看流水线状态
glab repo view --web              # 在浏览器中打开仓库

技能组织结构

本技能按 GitLab 功能域路由到专项子技能：

核心工作流：

• glab-mr - 合并请求：创建、审查、批准、合并
• glab-issue - Issue：创建、列表、更新、关闭、评论
• glab-ci - CI/CD：流水线、任务、日志、产物
• glab-repo - 仓库：克隆、创建、Fork、管理

项目管理：

• glab-milestone - 发布计划与里程碑跟踪
• glab-iteration - Sprint/迭代管理
• glab-label - 标签管理与分类
• glab-release - 软件发布与版本管理

认证与配置：

• glab-auth - 登录、登出、Docker Registry 认证
• glab-config - CLI 配置与默认设置
• glab-ssh-key - SSH 密钥管理
• glab-gpg-key - GPG 密钥（用于提交签名）
• glab-token - 个人及项目访问令牌

CI/CD 管理：

• glab-job - 单个任务操作
• glab-schedule - 定时流水线与 Cron 任务
• glab-variable - CI/CD 变量与密钥
• glab-securefile - 流水线安全文件
• glab-runner - Runner 管理：列表、暂停、删除（v1.87.0 新增）
• glab-runner-controller - Runner 控制器与令牌管理（实验性，仅管理员）

协作：

• glab-user - 用户资料与信息
• glab-snippet - 代码片段（类似 GitLab Gist）
• glab-incident - 事件管理
• glab-workitems - 工作项：任务、OKR、关键成果、新一代 Epic（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 - Model Context Protocol 服务器，用于 AI 助手集成（实验性）

何时使用 glab 与 Web 界面

适合使用 glab 的场景：

• 在脚本中自动化 GitLab 操作
• 以终端为中心的工作流
• 批量操作（处理多个 MR/Issue）
• 与其他 CLI 工具集成
• CI/CD 流水线工作流
• 无需切换浏览器即可快速导航

适合使用 Web 界面的场景：

• 带行内评论的复杂 diff 审查
• 可视化合并冲突解决
• 配置仓库设置与权限
• 跨项目的高级搜索/筛选
• 查看安全扫描结果
• 管理群组/实例级别的设置

常用工作流

日常开发

# 开始处理某个 Issue
glab issue view 123
git checkout -b 123-feature-name

# 准备好后创建 MR
glab mr create --fill --draft

# 标记为可审查
glab mr update --ready

# 审批通过后合并
glab mr merge --when-pipeline-succeeds --remove-source-branch

代码审查

# 查看待审查列表
glab mr list --reviewer=@me --state=opened

# 审查某个 MR
glab mr checkout 456
glab mr diff
npm test

# 批准
glab mr approve 456
glab mr note 456 -m "LGTM! Nice work on the error handling."

CI/CD 调试

# 检查流水线状态
glab ci status

# 查看失败的任务
glab ci view

# 获取任务日志
glab ci trace <job-id>

# 重试失败的任务
glab ci retry <job-id>

决策树

"应该先创建 MR 还是先创建 Issue？"

需要跟踪工作进度？
├─ 是 → 先创建 Issue（glab issue create）
│         然后：glab mr for <issue-id>
└─ 否 → 直接创建 MR（glab mr create --fill）

使用 glab issue create + glab mr for 的场景：

• 编码前需要讨论/审批
• 跟踪功能请求或 Bug
• Sprint 规划与分配
• 希望 MR 合并时自动关闭 Issue

直接使用 glab mr create 的场景：

• 快速修复或拼写错误
• 已有现成 Issue 在处理
• 紧急修复或热修复

"应该使用哪个 CI 命令？"

你需要什么？
├─ 查看流水线整体状态 → glab ci status
├─ 可视化流水线视图 → glab ci view
├─ 查看特定任务日志 → glab ci trace <job-id>
├─ 下载构建产物 → glab ci artifact <ref> <job-name>
├─ 验证配置文件 → glab ci lint
├─ 触发新运行 → glab ci run
└─ 列出所有流水线 → glab ci list

速查：

• 流水线级别：glab ci status、glab ci view、glab ci run
• 任务级别：glab ci trace、glab job retry、glab job view
• 产物：glab ci artifact（按流水线）或通过 glab job 获取任务产物

"克隆还是 Fork？"

你与仓库的关系？
├─ 有写入权限 → glab repo clone group/project
├─ 向他人项目贡献代码：
│   ├─ 一次性贡献 → glab repo fork + 工作 + MR
│   └─ 持续贡献 → glab repo fork，然后定期同步
└─ 仅阅读/浏览 → glab repo clone（或 view --web）

适合 Fork 的场景：

• 对原始仓库没有写入权限
• 为开源项目贡献代码
• 在不影响原始仓库的情况下进行实验
• 需要自己的副本用于长期工作

适合 Clone 的场景：

• 你是项目成员且有写入权限
• 在组织/团队仓库上工作
• 不需要个人副本

"项目标签还是群组标签？"

标签应该放在哪？
├─ 跨多个项目使用 → glab label create --group <group>
└─ 仅限某个项目 → glab label create（在项目目录中）

群组级别标签：

• 跨组织统一标签体系
• 示例：priority::high、type::bug、status::blocked
• 集中管理，项目自动继承

项目级别标签：

• 项目特定的工作流
• 示例：needs-ux-review、deploy-to-staging
• 由项目维护者管理

相关技能

MR 与 Issue 工作流：

• 从 glab-issue 开始创建/跟踪工作
• 使用 glab-mr 创建关闭 Issue 的 MR
• 脚本：scripts/create-mr-from-issue.sh 自动化此流程

CI/CD 调试：

• 使用 glab-ci 进行流水线级别操作
• 使用 glab-job 进行单个任务操作
• 脚本：scripts/ci-debug.sh 快速诊断失败原因

仓库操作：

• 使用 glab-repo 进行仓库管理
• 使用 glab-auth 进行认证配置
• 脚本：scripts/sync-fork.sh 同步 Fork

配置：

• 使用 glab-auth 进行初始认证
• 使用 glab-config 设置默认值和首选项
• 使用 glab-alias 创建自定义快捷方式