CICD AIops：自建 GitLab / Gitea 的 CI/CD 運維 Skill

前言¶

自建 GitLab 或 Gitea 跑 CI/CD，排障往往卡在幾個重複動作上：某個 pipeline 紅了，要翻 job 日誌；runner 掉線，要人肉看隊列；製品庫越漲越大，要逐條找哪個 job 留下的；還有一堆擱置的合併請求和分支沒人清理。這些信息分散在 Web 界面、多個頁面和日誌裏，靠手工點效率低，也難留痕。

CICD AIops 就是面向這類自託管 CI/CD 服務器的運維 Skill，把「看狀態」和「做操作」收到同一套受治理的工具裏。

這是什麼¶

CICD AIops 是一個社區來源（source: community）的 Skill，座標 @user_993b98b1/cicd-aiops，當前版本 0.14.0，分類爲 it-ops-security，發佈者 user_993b98b1。

它解決的問題是：讓 Agent 直接對一個自建（self-managed）GitLab 或自託管（self-hosted）Gitea 實例做 CI/CD 運維——既能一次性看清實例、項目、流水線、runner、製品的整體狀態，也能在治理約束下執行修復類寫入操作。

需要強調邊界：它只針對自建實例，GitLab.com / Gitea Cloud 這類 SaaS 賬號不在範圍內；Kubernetes 部署狀態也不歸它管，那部分應使用 k8s-aiops。

核心功能¶

下面介紹的能力都來自該 Skill 的官方說明。

讀側（觀測）：

1、一次性概覽、服務器版本與 token 身份
2、帶存儲統計的項目信息
3、流水線/運行及其 job 與 trace 尾部日誌
4、runner 艦隊（fleet）狀態
5、合併/Pull 請求、分支、保護規則與發佈（release）
6、製品（artifact）清單

寫側（受治理的操作）：

1、重試/取消一個流水線
2、暫停/恢復一個 runner
3、刪除製品
4、更新分支保護規則

RCA（根因分析）：

官方把它稱作四個 flagship RCA 場景：

1、流水線失敗（pipeline failures）
2、runner 健康與隊列（runner health & queue）
3、製品/存儲膨脹（artifact/storage bloat）
4、擱置的工作（stale work）

治理機制：

Skill 內置一個 governance harness，包括審計（audit）、策略（policy）、token 預算（token budget）、撤銷（undo）和風險分級（risk-tiers）。也就是說，寫操作不是直接放行，而是經過審計留痕和策略約束。

安裝與啓用¶

該 Skill 標記爲 requires_api_key=true，即需要一個 API key 才能使用。

可覈實的啓用方式：

座標: @user_993b98b1/cicd-aiops
版本: 0.14.0
來源: community
分類: it-ops-security
標籤: requires_api_key=true

在 SkillHub 上定位到該 Skill 後，按頁面指引綁定 API key 並啓用即可。官方頁面是動態渲染，正文需在瀏覽器中加載；本篇不編造具體的安裝命令或配置文件字段，那些細節請以官方頁面爲準。

不同客戶端（Cursor / Codex CLI / Claude Code）的接入方式若有差異，應以各自文檔爲準；本篇未覈實到官方對這些客戶端的分別說明，故不逐一列出。

典型用法¶

以下觸發場景來自官方說明，可作爲復現示例。當你遇到這些表述，且上下文是自建 GitLab / Gitea 實例時，就應使用本 Skill：

1、”GitLab” / “Gitea”
2、”pipeline failed” / “CI is red”
3、”job trace”
4、”runner offline” / “jobs stuck in queue”
5、”artifact storage full”
6、”stale merge requests” / “stale branches”
7、”protect the default branch”
8、”retry the pipeline” / “cancel the pipeline”
9、”delete old artifacts”

舉兩個具體例子：

用戶說「CI is red，幫我看看 job trace」，Agent 應走讀側能力，定位到對應 pipeline 的 job 並拉取 trace 尾部。
用戶說「retry the pipeline」或「cancel the pipeline」，Agent 走寫側能力，在治理 harness 約束下執行，並留審計記錄。

適用場景與注意¶

適合誰：

1、運維自建 GitLab / Gitea 實例的團隊，想減少 Web 界面手工操作
2、希望 CI/CD 排障和修復操作有審計、可撤銷的場景
3、有 token 預算和策略約束要求的治理型環境

限制與坑：

1、只適用於自建實例，GitLab.com / Gitea Cloud SaaS 不適用
2、不處理 Kubernetes 部署狀態，那部分用 k8s-aiops
3、不要用於超管理器（hypervisor）、存儲設備、備份產品、數據庫、網絡設備或 OT/工業設備——這些應路由到其他對應的 AIops-tools Skill
4、使用前需要配置 API key（requires_api_key=true）
5、寫操作受 governance harness 約束，執行前留意策略和風險分級

小結¶

CICD AIops 的價值在於把自建 GitLab / Gitea 的 CI/CD 運維收進一套受治理的工具：既能讀（概覽、流水線、runner、製品、RCA），也能在審計、策略、token 預算、撤銷、風險分級的約束下做修復寫入。它定位清晰、邊界明確，適合自託管 CI/CD 的排障和日常維護。

官方地址：https://api.skillhub.cn/user_993b98b1/cicd-aiops