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 處理任務。