GitLab CLI Skills

核心用法

glab 是 GitLab 官方推出的命令行工具，提供与 Web UI 等效的全功能 GitLab 操作能力。通过 glab auth login 完成认证后，可执行从日常开发到 CI/CD 自动化的完整工作流。

核心命令分类：

• 代码协作：glab mr（合并请求创建、审查、批准）、glab issue（Issue 全生命周期管理）
• CI/CD：glab ci（流水线状态查看、重试、日志追踪）、glab job（单任务操作）、glab schedule（定时任务）
• 仓库管理：glab repo（克隆、分叉、浏览）、glab release（版本发布）
• 项目管理：glab milestone、glab iteration、glab label（支持项目级/组级标签）
• 认证配置：glab auth（支持 --web 浏览器登录、容器仓库认证）、glab config

v1.90.0 重要更新：glab mr create --auto-merge 自动合并、glab runner 新增作业/管理器查看、glab runner-controller 实验性支持。

显著优点

1. 官方维护：GitLab 官方出品，与平台特性同步更新，API 兼容性最佳
2. 结构化输出：v1.89.0+ 起 18 个命令支持 --output json，便于脚本/Agent 解析
3. 工作流覆盖全面：从 Issue 创建 → MR 关联 → CI 触发 → 发布上线完整闭环
4. 终端效率：批量操作、无需浏览器切换、与 Git 命令无缝衔接
5. 自动化友好：支持通过 GITLAB_TOKEN 环境变量或配置文件认证，适合 CI/CD 场景

潜在缺点与局限性

• 复杂 UI 场景受限：内联评论 diff 审查、可视化冲突解决仍需 Web UI
• 配置门槛：自托管实例需额外配置 SSH hostname 与 API endpoint
• 权限敏感：脚本可操作 MR 批准、评论发布等，需审查 scripts/ 目录内容
• 实验性功能风险：glab-runner-controller、glab-mcp 等标记为 EXPERIMENTAL

适合人群

• 终端优先的开发者，寻求 GitLab 操作效率最大化
• DevOps 工程师编写 GitLab 自动化脚本
• 需要批量处理 MR/Issue 的维护者
• CI/CD 流水线中需要程序化 GitLab 交互的场景

常规风险

• Token 安全：认证信息存储于 ~/.config/glab-cli/config.yml，需妥善保管
• 敏感文件访问：部分功能可能读取 SSH 密钥 (~/.ssh/id_rsa)、Docker 配置
• 写操作权限：自动化脚本具备发布评论、批准 MR、解决线程的能力，生产环境使用前建议审查脚本内容

核心用法

本 Skill 是 GitLab CLI (glab) 的综合封装层，提供从认证到高级自动化的完整工作流。核心能力覆盖：

MR 与代码审查：glab mr create --fill 一键创建 MR，glab mr checkout 快速切换分支，glab mr diff + glab mr approve 完成审查闭环。支持 --auto-merge 自动合并、--when-pipeline-succeeds 流水线成功后合并等高级策略。

CI/CD 调试：glab ci view 可视化流水线状态，glab ci trace <job> 获取实时日志，glab ci retry 重试失败任务。v1.90+ 支持 glab-runner 管理 Runner 生命周期。

批量自动化：37+ 子命令覆盖 Issue、Milestone、Release、Variable 等全功能域，18 个命令支持 --output json 结构化输出，便于脚本解析。

显著优点

1. 零供应链风险：无第三方依赖，纯包装层设计，所有敏感操作（token 获取）均委托给官方 glab 命令
2. 安全设计优异：命令白名单机制（ALLOWED_COMMANDS）防止任意代码执行；外部内容明确标记风险边界（--- BEGIN/END EXTERNAL CONTENT ---）；输入验证完善（项目路径、MR IID 均校验）
3. 自动化友好：JSON 输出、批量评论限制（100条/1MB）、subprocess 超时保护（10秒），适合 CI/agentic 场景
4. 架构清晰：按域路由到子 Skill（glab-mr、glab-ci 等），决策树辅助用户选择正确命令

潜在局限

• 功能边界：复杂 diff 内联评论、可视化冲突解决仍需 Web UI
• 网络依赖：必须 HTTPS 访问 GitLab 实例，离线场景不可用
• 权限要求：完整功能需 api scope token，部分企业策略可能受限
• 实验性功能：glab-runner-controller、glab-mcp 标记为 EXPERIMENTAL，API 可能变动

适合人群

• 终端优先的开发者，追求「不离开终端」的高效工作流
• DevOps/SRE 需要脚本化 GitLab 操作（批量 MR、流水线诊断）
• 自动化 Agent 需要结构化 GitLab 数据交互
• 开源贡献者快速 fork/clone/MR 流程

常规风险

| 风险项 | 说明 | 缓解措施 |

|--------|------|----------|

| Token 泄露 | `~/.config/glab-cli/config.yml` 存储凭证 | 依赖 glab 官方加密存储，脚本不硬编码 token |

| 文件访问 | 可能读取 SSH key (`~/.ssh/id_rsa`)、Docker config | 明确标注敏感文件路径，需用户授权 |

| API 调用 | POST 评论、MR 状态变更 | HTTPS 强制、输入验证、速率限制 |

| 子进程注入 | `subprocess.run` 调用 glab | 仅限白名单命令，无用户输入拼接 |

安全审计评分 78/A 级，无恶意代码、无数据外泄、GDPR/CCPA 合规。