前言¶
自建 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