Gitlab Cli Skills

GitLab CLI (glab) 综合技能评估

核心用途

本技能提供 GitLab CLI (glab) 的完整命令参考与工作流指南，覆盖 40+ 子命令，包括 glab mr、glab ci、glab issue、glab release、glab variable 等核心领域。专为需要在终端环境高效操作 GitLab 的开发者和自动化代理设计。

显著优点

• 命令覆盖全面：从基础认证 (glab auth) 到高级功能如堆叠式 MR (glab stack)、OpenTofu 状态管理 (glab opentofu)、软件供应链安全证明 (glab attestation)、容器仓库管理 (glab container-registry) 等
• 多代理身份管理：详细的安全最佳实践，支持不同代理使用独立 GitLab 服务账号，通过环境文件隔离身份，避免误操作
• 自动化友好：大量命令支持 --output json 和 --jq 过滤器，便于脚本解析
• 工作流决策树：提供清晰的决策逻辑（何时用 glab vs Web UI、Pipeline vs Job 命令选择、项目/组标签决策等）
• 安全前置检查：所有写入操作前强制要求执行身份验证预检 (glab auth status + glab api user)
• 快速修复指南：包含误用身份后的完整补救流程

潜在局限与风险

• 大量实验性功能：glab runner-controller、glab skills、glab mcp、glab security、glab stack、glab orbit 等标记为 EXPERIMENTAL，可能随时变更或移除
• 身份管理复杂度高：多代理场景下环境变量管理不当极易导致"错误身份写入"，需要严格的预检流程
• 命令碎片化：部分功能分散在多个子命令中（如 CI 相关操作分布在 glab ci、glab job、glab schedule、glab variable 等）
• 安全警告依赖人工：SSH 密钥添加等敏感操作虽有警告，但仍需用户主动确认
• 内联注释技术复杂：MR 差异内联注释需要处理 GitLab API 的诸多边界情况（新文件、编码路径、line_code 验证等）

适合人群

• DevOps/平台工程师：需要批量管理 CI/CD、Runner、变量、安全扫描配置
• 开发团队 Lead：需要自动化 MR 审查、Issue 分类、里程碑规划
• AI 代理/自动化系统：需要结构化 JSON 输出、明确的决策树、可脚本化的工作流
• GitLab 高级用户：已熟悉 Web UI，希望迁移到更高效终端工作流

安全等级与可信度

• 安全等级：S — 身份管理设计严谨，但实验性功能存在不稳定风险；关键操作（SSH 密钥上传、Token 管理）有明确安全警告
• 来源可信度：T1 — GitLab 官方 CLI 工具，由 GitLab 团队维护，文档结构专业，命令参考完整

关键安全提示

> 多代理身份管理：glab 会静默回退到 ~/.config/glab-cli/config.yml 中的存储凭证，若环境变量未正确导出，可能导致错误身份执行写入操作。每次写入前必须执行：
> ```bash
> glab auth status --hostname "$GITLAB_HOST"
> glab api --hostname "$GITLAB_HOST" user
> ```

概述

本Skill为GitLab CLI (glab)的综合性命令参考与工作流指南，涵盖40+子命令，包括merge requests、CI/CD pipelines、issues、releases、repositories、authentication、variables、labels、milestones等完整操作场景。

核心用法

快速入门

# 首次认证
glab auth login

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

身份管理关键实践

• Actor Identity vs Agent Identity: 评论、回复、审批等用户可见操作应使用Actor身份；仅当操作为Agent自身工作产物时才使用Agent身份
• 环境隔离: 每个Actor使用独立env文件（如~/.config/openclaw/env/gitlab-actor.env）
• 写操作前验证: 必须执行glab auth status和glab api user确认身份

主要命令域

| 领域 | 关键命令 | 用途 |

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

| **MR工作流** | `glab mr create`, `glab mr approve`, `glab mr merge` | 创建、审批、合并请求 |

| **CI/CD** | `glab ci status`, `glab ci view`, `glab ci trace` | 流水线状态、可视化、日志追踪 |

| **Issues** | `glab issue create`, `glab issue list`, `glab issue note` | Issue全生命周期管理 |

| **Releases** | `glab release create`, `glab release upload` | 版本发布与资产管理 |

| **Repository** | `glab repo clone`, `glab repo fork`, `glab repo prune` | 仓库操作与分支清理 |

显著优点

1. 全面覆盖: 40+子命令，涵盖GitLab核心操作场景
2. 安全实践丰富: 详细的身份验证、Token管理、权限控制指南
3. 自动化友好: 支持--output json和--jq过滤，便于脚本集成
4. 决策树指导: 提供"何时使用glab vs Web UI"、"Project vs Group Labels"等决策框架
5. 多Agent支持: 专门的多身份管理方案，适合自动化场景

潜在局限

1. 实验性功能: glab stack、glab orbit、glab runner-controller等标记为EXPERIMENTAL
2. 版本敏感: 部分功能（如glab work-items）需要较新的glab版本
3. 权限依赖: 许多操作需要Maintainer或Admin权限
4. 学习曲线: 40+子命令需要一定时间熟悉

适合人群

• DevOps工程师构建CI/CD自动化
• 需要批量操作GitLab资源的开发者
• 终端优先工作流的团队
• 需要多身份管理的自动化Agent场景

常规风险

1. 身份混淆风险: 多环境切换时可能以错误身份执行写操作（Skill提供详细缓解方案）
2. Token泄露: 需遵循chmod 600等权限管理实践
3. 破坏性操作: delete、prune等命令需谨慎使用--yes标志
4. 实验性功能不稳定: 标记EXPERIMENTAL的功能可能变更或移除