核心用法
GitLab API 技能提供通过 REST API 与 GitLab 仓库交互的能力，支持 GitLab.com 及私有化部署实例。核心功能包括：
认证配置：通过 ~/.config/gitlab/api_token 存储个人访问令牌，支持 api 或 read_api+write_repository 权限范围；私有化部署可通过 ~/.config/gitlab/instance_url 配置自定义地址。
仓库操作：
- 项目管理：列出项目、获取项目ID（支持
namespace/project路径编码） - 文件操作：读取（自动 base64 解码）、创建/更新（POST/PUT）、删除文件
- 目录浏览：递归列出目录树结构
- 分支管理：列出分支、创建新分支
- 归档下载：获取仓库压缩包
辅助工具：提供 gitlab_api.sh 脚本封装常用命令，简化交互流程。
显著优点
1. 完整覆盖：涵盖 GitLab API v4 核心端点，满足日常仓库管理需求
2. 灵活部署：同时支持 SaaS 和私有化 GitLab 实例
3. 标准化流程：采用标准 curl + JSON 交互模式，易于理解和扩展
4. 脚本化支持：内置 helper 脚本降低重复命令编写成本
潜在缺点与局限性
1. 手动配置依赖：Token 和实例地址需手动文件配置，无交互式引导
2. 速率限制敏感：GitLab.com 限制 300请求/分钟，批量操作需自行控制频率
3. 无高级功能：不包含 CI/CD 触发、Issue 管理、Merge Request 操作等扩展能力
4. base64 编解码：文件内容需手动 base64 处理，增加使用复杂度
5. 路径编码要求：项目路径中的 / 需手动编码为 %2F
适合人群
- 需要自动化 GitLab 仓库操作的开发者和 DevOps 工程师
- 在 CI/CD 流水线外需要快速脚本化仓库管理的场景
- 使用私有化 GitLab 实例的团队运维人员
常规风险
- 令牌泄露风险：Token 以明文存储于本地文件，需确保
~/.config/gitlab/目录权限正确（建议chmod 700） - 误操作不可逆：文件删除、分支覆盖等操作直接生效，无二次确认机制
- 权限放大：
apiscope 权限过大，建议按最小权限原则配置read_api+write_repository - 网络暴露：curl 命令可能通过进程列表暴露 Token，建议在受控环境执行