GitLab CLI Skills

核心用法

glab 是 GitLab 官方维护的命令行工具，提供覆盖 GitLab 全功能的终端操作能力。核心工作流包括：glab auth login 完成认证后，通过 glab mr create --fill 快速创建合并请求，glab ci view 可视化流水线状态，glab issue create 管理问题跟踪。工具采用子命令模块化设计，按领域划分为 30+ 个子技能，如 glab-mr、glab-ci、glab-repo 等，每个子命令支持 --output json 结构化输出，便于自动化解析。

显著优点

• 官方权威：GitLab 官方出品，API 同步更新，功能覆盖度最全
• 终端原生：无需切换浏览器，适合键盘驱动的开发工作流
• 脚本友好：支持 JSON 输出、环境变量注入（GITLAB_TOKEN），易于 CI/CD 集成
• 身份管理：支持多账户/多 agent 身份隔离，通过独立 env 文件实现精细权限控制
• 持续迭代：v1.89+ 版本新增 18 个命令的 JSON 输出支持，v1.92 新增 todo 管理功能

潜在局限

• 功能边界：复杂 diff 审查、可视化冲突解决仍需 web UI
• 学习成本：30+ 子命令体系对新手有一定记忆负担
• 认证敏感：依赖 ~/.config/glab-cli/config.yml 存储 token，需严格权限控制（建议 chmod 600）
• 身份粘滞风险：shell 环境变量未正确清理时可能导致误用身份执行写操作

适合人群

• 终端优先的开发者与 DevOps 工程师
• 需要批量操作 MR/Issue 的维护者
• 构建 GitLab 自动化脚本的 CI/CD 工程师
• 多账户/多团队协作场景下的权限管理员

常规风险

• 认证泄露：config.yml 或 env 文件备份时可能意外暴露 token
• 越权操作：未执行 glab auth status 预检时，可能以错误身份批准 MR 或发表评论
• 脚本注入：使用 glab api 直接调用 REST API 时需注意参数转义
• 凭证残留：共享 shell 会话中未 unset 变量可能导致后续命令继承错误身份

核心用途

该 Skill 提供 GitLab CLI (glab) 的综合性命令参考与实战工作流，涵盖从认证配置到高级自动化的完整链路。作为纯文档型 Skill（T-MD 类型），包含 74 个 Markdown 文件，所有代码示例均为教育性展示，无可执行代码。

核心功能模块

| 模块 | 覆盖场景 |

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

| **glab-auth** | 多身份认证、Token 管理、Docker 仓库登录 |

| **glab-mr** | MR 创建、审查、批准、合并、堆叠 MR |

| **glab-issue** | Issue 生命周期管理、自动化关联 |

| **glab-ci** | 流水线状态、日志追踪、作业重试、产物下载 |

| **glab-repo** | 仓库克隆、Fork 管理、同步 |

| **glab-runner** | Runner 注册、管理、作业调度（v1.87+） |

| **glab-api** | 直接 REST API 调用，支持 JSON 输出（v1.89+） |

| **glab-duo** | GitLab Duo AI 助手集成 |

显著优点

1. 终端原生效率：批量操作、脚本集成、CI/CD 流水线内嵌无需切换浏览器
2. 结构化输出：v1.89+ 支持 -F json，便于自动化解析
3. 多身份管理：详尽的"多代理身份"章节，支持 bot/服务账户隔离
4. 版本追踪：持续更新至 glab v1.92.0，包含 glab-todo 等新功能
5. 安全透明：明确 Token 存储位置 (~/.config/glab-cli/config.yml)，含预飞检查清单

局限性与注意事项

• 复杂 CR 场景受限：内联评论、可视化冲突解决仍需 Web UI
• 身份粘性问题：Shell 环境变量 sticky，需严格遵循 unset + source + auth status 预飞流程
• 权限范围：脚本可代表用户执行写操作（评论、批准、MR 合并），需审查 post-inline-comment.py 等脚本
• 实验性功能：glab-runner-controller、glab-mcp 标记为 EXPERIMENTAL

适合人群

• DevOps 工程师：CI/CD 流水线自动化、Runner 管理
• 平台开发者：构建 GitLab 集成工具、自定义工作流
• 终端优先开发者：日常开发、代码审查、批量操作
• 多账户协作者：需区分个人/机器人/审核者身份的复杂组织场景

常规风险与缓解

| 风险 | 缓解措施 |

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

| 身份混淆导致误操作 | 强制预飞：`glab auth status && glab api user` |

| Token 泄露 | 使用专用 bot 账户、环境文件权限 `chmod 600`、排除版本控制 |

| 自动化脚本越权 | 审查 `write_access` 声明、显式校验目标身份后再执行写操作 |

| 配置残留 | 切换身份时 `unset` 全部相关变量或启动新 Shell |

该 Skill 经安全认证（CLS-2026-0604-GCS-8A3F），评分 78/A 级，无已知恶意模式，建议遵循文档中的身份管理最佳实践后放心使用。