核心定位
gitlab-cli-skills 是 GitLab 官方 CLI 工具 glab 的系统性技能封装，提供从认证、代码仓库管理到 CI/CD 流水线、MR/Issue 协作的全终端操作能力。该技能由 GitLab 官方维护，命令语义与 REST API 原生对齐，是 Web UI 的高效率替代方案。
显著优点
1. 官方权威性：glab 为 GitLab 官方出品，命令设计直接映射 API 语义，无第三方抽象层带来的理解成本。
2. 工作流深度集成：支持 --fill 自动填充 MR 描述、--auto-merge 流水线通过后自动合并、glab stack 管理依赖式 MR 等高级场景。
3. 结构化输出：v1.89.0+ 起 18 个命令支持 -F json 输出，便于 agent/automation 解析，避免屏幕抓取。
4. 多身份管理：内置详细指引，通过 env 文件隔离不同 actor（如 reviewer、release bot），支持 glab auth status 预检防止误操作。
5. CI/CD 原生：glab ci view 可视化流水线、glab ci trace 实时拉取日志、glab job retry 快速重试，调试效率远高于浏览器切换。
潜在局限
1. 学习曲线：30+ 子技能、大量 flag 组合，初学者易与 git 命令混淆，需参考决策树选择正确子命令。
2. 复杂交互受限：多行 MR 描述编辑、冲突可视化解算仍需 Web UI；glab mr note 虽支持评论，但无法替代 Code Review 的逐行 diff 批注体验。
3. 身份切换心智负担：多 actor 场景要求严格的环境变量管理（set -a + unset 旧变量），配置失误易导致「错误身份评论/审批」事故。
4. 自托管实例配置：SSH 与 API hostname 分离、OAuth/token 切换等场景需额外配置，文档分散于各子技能。
适合人群
- 终端优先开发者：习惯 tmux/vim 工作流，追求「不离开终端」完成 GitLab 全操作。
- 自动化/平台工程师：需将 GitLab 操作脚本化（如批量创建 MR、流水线故障自动重试）。
- 多角色协作者：同一人需区分「个人开发」「Code Review」「发布审批」等多身份，需严格隔离 token。
- CI/CD 调试高频用户：频繁排查失败 job、下载 artifacts，依赖
glab ci trace和glab ci artifact。
常规风险
1. 认证泄露：GITLAB_TOKEN 需 export 才能被子进程读取，误存 shell history 或日志风险；建议配合 chmod 600 的 env 文件。
2. 误操作不可逆：glab mr merge --remove-source-branch 等命令无二次确认，脚本中需显式校验。
3. 身份混淆：未执行预检（glab auth status + glab api user）直接写入，可能导致 bot 账号以个人身份评论，影响审计合规。
4. 权限扩散：scripts/post-inline-comment.py 等自动化脚本具备 comment/resolve/approve 权限，agentic 使用前需人工审查脚本内容。