SuperAPI AI 工具集

nx-ci-monitor

部署与运维

查看项目

更新于 10-15 12:40

技能介绍

用途

nx-ci-monitor 是一个编排器,用于监控 Nx Cloud CI 流水线的执行状态,并自动处理自愈修复。当用户说“watch CI”、“monitor pipeline”、“check CI status”、“fix CI”等时使用。

主要能力

  • 启动 ci-watcher 子代理轮询 CI 状态。
  • 根据子代理返回的状态(如 ci_success、fix_auto_applying、fix_available、fix_failed、environment_issue、no_fix、no_new_cipe、polling_timeout、cipe_canceled、cipe_timed_out、error)执行默认行为。
  • 支持通过 MCP 应用修复、本地应用并增强修复、拒绝修复后从头修复、请求环境重跑等。
  • 支持本地验证流程:对未验证且非 e2e 的任务在本地并行运行,根据结果决定是否应用修复。
  • 支持自动修复工作流失败(如更新 lockfile)。
  • 提供进度跟踪、状态报告和退出条件。

使用方式

该技能通过命令调用,可接受用户指令覆盖默认行为。配置默认值包括:--max-cycles(默认10)、--timeout(默认120分钟)、--verbosity(默认medium)、--branch(自动检测)、--subagent-timeout(默认60分钟)、--fresh(默认false)、--auto-fix-workflow(默认false)、--new-cipe-timeout(默认10分钟)、--local-verify-attempts(默认3)。

使用前需验证工作区已连接 Nx Cloud:检查 nx.json 中是否存在 nxCloudId 或 nxCloudAccessToken。若未连接,则退出并提示。

在 Claude Code 会话中,上下文会保留。重新运行 /ci-monitor 可继续监控;使用 /ci-monitor --fresh 可忽略之前上下文重新开始;退出并重启 Claude Code 可获得全新状态。

适用场景

  • 需要持续监控 Nx Cloud CI 流水线状态。
  • CI 失败时希望自动尝试修复并重新验证。
  • 需要根据任务验证状态决定应用修复、本地增强或拒绝修复。
  • 处理环境问题导致的重跑。
  • 处理 CI 工作流在 Nx 任务前失败的情况(如 lockfile 更新)。

限制

  • 依赖 Nx Cloud 连接,未连接时无法使用。
  • 需要 Nx 工作区环境。
  • 部分操作需要 MCP 工具支持。
  • 自动修复工作流需要显式配置 --auto-fix-workflow。
  • 本地验证仅针对非 e2e 任务,e2e 任务视为已验证足够。
  • 存在最大循环次数、超时和电路熔断机制。
  • 具体修复效果取决于自愈代理生成的内容,技能本身不保证修复成功。
  • 未提供关于收费、价格、平台支持等额外信息。