GitLab DevOps 命令行
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3a0f7c7a/restartx-gitlab-devops。
技能介绍
要解决什么问题
人在对话里问「我有哪些项目」「这个 group 下的应用详情」「main 上跑一下流水线」「MR 能合并了吗」,如果每次都要切到 GitLab Web 或手写 curl,上下文很容易断。本技能把 GitLab REST API v4 收成一支可复用的 Python CLI(scripts/gitlab_cli.py),让助手在对话中直接查项目、管 Issue/MR、看或触发流水线,输出统一为 JSON,便于脚本或后续推理衔接。
技能如何工作
- 连接与鉴权:从环境变量或
~/.devops-skills/gitlab.json读取实例地址与 Token(需在 User Settings → Access Tokens 创建,apiscope);兼容 GitLab.com 与 自托管 9.0+(启动前会请求/api/v4/version,低版本会明确退出,必要时可用GITLAB_SKIP_VERSION_CHECK=1等变量跳过)。 - 项目:支持数值 ID 或
group/subgroup/project路径(自动编码),用于查找与查看详情。 - Issue:列出、创建 Issue。
- 合并请求:列出、创建、merge-mr 合并(须 MR 处于可合并状态,审批与流水线规则仍由 GitLab 侧生效)。
- CI/CD:列出流水线、触发执行(项目需存在
.gitlab-ci.yml)。 - 失败语义:命令失败时 非零退出码,标准输出仍为结构化 JSON,便于区分「接口错误」与「业务不可合并」等情形。
适用边界与注意点
这是 API 封装层,不替代 GitLab 的权限模型、MR 审批策略或 Runner 可用性。合并 MR 前仍需满足项目里的 approvals / pipeline 规则;空仓库或未配置 CI 时无法「凭空」触发有效流水线。更完整的参数与故障排查见技能包内 使用手册.md;平台与 DevOps 咨询可联系 RestartX。
使用场景
- 在代码评审前用路径 `group/app` 拉取项目详情,确认默认分支与最近流水线状态
- 值班时需要为某服务仓库新建 Bug Issue,并附上复现步骤与标签
- 发布窗口向助手说明「在 main 上触发 pipeline」,由 CLI 调用 API 启动 CI 而非手动点 Run pipeline
- MR 已通过审查且流水线绿灯,在对话里执行合并请求,同时用 JSON 输出核对 merge 结果
适合人员
- 负责多 GitLab 群组运维的 SRE,需要在告警上下文里快速查项目并触发流水线
- 使用自托管 GitLab 9.0+ 的平台工程师,希望通过统一 CLI 而非零散脚本调用 API v4
- 带 student/开源贡献者的维护者,常在 IM 里处理 Issue 创建与 MR 合并状态查询
- DevOps 顾问(如对接 RestartX 场景)在客户环境排障时需要可脚本化的 GitLab 只读/写操作