核心用法
CICD AIops 是一款面向自托管 GitLab 和 Gitea 实例的智能化运维工具套件，通过 28 个 MCP 工具覆盖 CI/CD 全生命周期管理。用户可通过统一的 CLI 界面执行服务器状态巡检、项目与流水线监控、Runner fleet 管理、制品存储治理等操作。
安装后运行 cicd-aiops init 完成平台选择（GitLab/Gitea）、基地址配置及加密令牌存储，即可使用。核心工作流围绕四大旗舰 RCA（根因分析）场景展开：pipeline 故障诊断（pipeline_failure_rca 自动分类失败原因）、Runner 健康与队列分析（识别离线/饱和 Runner）、存储膨胀治理（制品与仓库容量排名及回收估算）、闲置工作审计（MR/分支/保护规则缺口）。所有读操作直接返回结构化数据，写操作（重试/取消流水线、暂停/恢复 Runner、删除制品、更新分支保护）均通过 @governed_tool 治理框架执行，强制审计、风险分级和撤销支持。
显著优点
安全架构领先：凭证采用 Fernet/AES-128 + scrypt 派生密钥加密存储，内存中短时持有，全程不落盘明文；支持 CICD_MASTER_PASSWORD 非交互式解锁，兼顾自动化场景与安全性。
治理框架内置：独立的审计日志（SQLite）、策略引擎、令牌预算防护、运行逃逸预算、分级风险管控（low/med/high）均打包在技能内部，零外部依赖；高危险操作（如 delete_artifacts）强制 dry-run + 审批人环境变量双确认。
双平台统一抽象：同一套工具通过 per-target platform 字段自适应 GitLab REST v4 与 Gitea API v1，单配置即可管理混合资产；缺失功能（如 Gitea 的 Runner 管理）主动返回教学性错误而非静默失败。
可撤销设计：可逆写操作（暂停/恢复 Runner、分支保护更新）自动捕获真实前置状态并生成反向撤销描述符，误操作可通过 undo_apply 精确回滚。
潜在缺点与局限性
平台功能不对等：GitLab 的 Runner 管理、流水线重试/取消在 Gitea 无 API 对应实现，使用时会触发 teaching error，需用户切换至 Gitea Web UI 手动操作，体验割裂。
验证债务：当前为 mock-validated 状态，尚无针对真实服务器的端到端运行记录，REST 路径建模为最大验证缺口，生产环境首次部署建议先通过 home lab 验证。
云托管排除：明确不支持 GitLab.com / Gitea Cloud 等 SaaS 账户，仅面向自托管实例，公有云用户无法使用。
无 Webhook 实时性：纯轮询式 REST 交互，无入站 Webhook 支持，事件感知延迟取决于轮询频率。
适合的目标群体
- 平台工程/SRE 团队：管理多租户自托管 GitLab/Gitea 实例，需统一运维入口与审计合规。
- DevOps 工程师：日常处理 CI 失败排查、Runner 容量规划、存储成本治理。
- 中小型企业技术负责人：缺乏专职运维，需开箱即用的安全加固 CI/CD 治理方案。
- 合规敏感行业（金融、医疗、政务）：强制要求操作审计、加密凭证、分级审批的组织。
使用风险
操作不可逆风险：delete_artifacts 为高危操作，无撤销机制，dry-run 是唯一安全网；若误配 --older-than-days 0 将清除全部制品，可能破坏发布依赖。
凭证泄露风险：虽主存储已加密，遗留环境变量 CICD_<TARGET>_SECRET 仍被支持，迁移期可能存在明文暴露窗口。
SSL 验证绕过：init 向导允许为自签名证书禁用 verify_ssl，生产环境误用将导致中间人攻击风险。
性能与依赖：依赖 httpx 与 MCP SDK，无后台服务；但大规模实例（千级项目/万级流水线）的列表操作可能触发 API 限流或本地审计数据库膨胀，需关注 CICD_AIOPS_HOME 磁盘容量。
模型幻觉风险：RCA 分类基于启发式规则（失败原因 + trace 标记），非 AI 黑箱但仍需人工 job_trace_tail 复核，避免误分类导致错误重试（如将代码错误误判为网络瞬态）。