Gitlab Cli Skills

核心用法

gitlab-cli-skills 提供 glab 命令行工具的完整操作指南，涵盖 40+ 子命令的快速参考与典型工作流。核心场景包括：

• 认证管理：glab auth login/status/logout，支持多账号/多实例隔离，提供 Agent 环境下的身份预检流程
• 合并请求 (MR)：glab mr create/view/approve/merge，支持 draft/ready 状态切换、自动合并、行级评论
• CI/CD 流水线：glab ci status/view/trace/retry，提供实时日志追踪、失败诊断、产物下载
• Issue 与项目管理：glab issue/milestone/label/iteration 完整生命周期管理
• 代码仓库：glab repo clone/fork/remote，含 fork 同步脚本
• 高级功能：glab api 直接调用 REST/GraphQL，glab stack 堆叠 MR 工作流，glab orbit Knowledge Graph 查询

显著优点

• 终端原生：无需切换浏览器即可完成 90%+ 日常 GitLab 操作
• 脚本友好：--output json 结构化输出、--jq 内置过滤，适合 CI/CD 集成
• 身份安全：详细的多 Agent 身份隔离方案，避免跨账号误操作
• 工作流丰富：内置 MR 评审、Issue 分类、流水线调试等决策树与自动化脚本模板

潜在局限

• 实验性功能：glab stack / glab orbit / glab runner-controller 标记为 EXPERIMENTAL，API 可能变更
• 复杂 UI 场景：复杂 diff 评审、可视化合并冲突解决仍需 Web UI
• 权限敏感：部分命令（如 runner-controller）需 GitLab Admin 权限
• 身份粘性风险：shell 环境变量残留可能导致非预期账号执行写操作

适合人群

• 偏好终端工作流的开发者/DevOps 工程师
• 需要批量操作 MR/Issue 的代码审查者
• 构建 CI/CD 自动化脚本的平台工程师
• 管理多 GitLab 实例的运维团队

常规风险

• 身份混淆：多账号环境下未执行预检 (glab auth status + glab api user) 可能导致评论/审批归属错误账号
• 令牌泄露：GITLAB_TOKEN 等环境变量若未妥善管理（如提交至日志）存在暴露风险
• 破坏性操作：delete/revoke/merge --remove-source-branch 等命令不可逆，建议配合 --dry-run 或备份
• 实验性功能不稳定：生产环境避免依赖 EXPERIMENTAL 命令

核心功能

gitlab-cli-skills 是 GitLab 官方 CLI 工具 glab 的综合性参考文档，涵盖从基础操作到高级工作流的完整指南。

主要命令域

• 代码协作：glab mr（合并请求）、glab issue（议题）、glab stack（堆叠 MR）
• CI/CD：glab ci（流水线）、glab job（作业）、glab schedule（定时任务）、glab variable（变量管理）
• 项目管理：glab milestone（里程碑）、glab label（标签）、glab iteration（迭代）
• 认证配置：glab auth（多身份管理）、glab token（令牌管理）、glab config（配置）
• 运维扩展：glab runner（Runner 管理）、glab release（发布）、glab api（原生 API 调用）

显著优点

1. 多身份安全管理：详细文档记录了多 Agent 环境下的身份隔离方案，包括 env 文件模式、set -a 导出技巧、写操作前强制校验流程
2. 安全警告完善：SSH 公私钥区分、Token 生命周期管理、untrusted content 警告等关键安全提示
3. 工作流自动化：提供 decision trees 帮助用户选择正确命令，附带可复用的 shell 脚本模板
4. 实验性功能覆盖：glab orbit（知识图谱）、glab mcp（MCP 服务）、glab work-items（新工作项模型）等前沿功能

潜在局限

• 纯文档性质：无动态执行能力，需用户手动执行命令
• 版本依赖：glab 版本差异可能导致部分实验性命令不可用
• 自托管差异：部分功能（如 runner-controller）需 GitLab 管理员权限

适用人群

• DevOps/SRE 工程师：CI/CD 流水线管理与 Runner 运维
• 开发团队负责人：MR 工作流标准化与代码审查自动化
• 平台工程师：多租户 GitLab 实例的身份与权限管理
• AI Agent 开发者：通过 glab mcp 实现 GitLab 工具链集成

常规风险

• 身份混淆风险：多 shell 会话中 GITLAB_TOKEN 残留可能导致误操作
• 实验性功能不稳定：EXPERIMENTAL 标记命令可能变更或移除
• 权限升级误操作：glab runner-controller 等 admin-only 功能需格外谨慎