gitlab-api

GitLab API 技能为 GitLab.com 与自托管 GitLab 实例提供了强大的交互接口。此技能专为软件工程师、DevOps 从业者与专注于自动化的代理而设计，通过直接执行 REST API 指令来简化仓库交互。它消除了执行常见 Git 操作时手动操作浏览器的需求，使代理能够在您的开发生命周期中作为自主贡献者执行任务。

• 执行全面的文件操作：使用简单的自然语言请求直接在仓库内读取、创建、更新与删除文件。

• 管理项目结构：列出项目、通过路径获取项目 ID，并浏览仓库树以检查目录内容。

• 处理分支工作流程：列出现有分支、从特定参考点创建新功能分支，并管理分支元数据。

• 获取完整的仓库归档：生成并下载压缩的 tar.gz 归档文件，以供外部分析或备份任务使用。

• 集成就绪：支持 CI/CD 流水线、仓库健康检查与日常文件维护任务的自动化脚本。

• 设置要求：需要具备 'api' 或 'read_api' + 'write_repository' 权限的 GitLab 个人访问令牌 (PAT)。支持自托管企业部署的自定义实例 URL。

• 速率限制：遵循标准 GitLab API 限制（GitLab.com 认证用户每分钟 300 次请求，自托管实例可自定义）。

• 输入与输出：接受用于文件修改的 JSON 编码负载，并返回来自 GitLab API v4 的结构化 JSON 响应，随后解析为人类可读的结果。

• 安全性：通过环境变量或本地配置文件封装验证信息，确保令牌维持在本地端且安全。请确保您的环境根据组织安全策略妥善管理私有令牌。

• 使用限制：确保您的运行环境安装了 'curl' 与 'jq'，以支持所提供的辅助脚本与 JSON 处理任务。