Monitor CI 命令是一个用于监控 Nx Cloud CI 流水线执行并处理自愈修复的编排器。它通过派生 ci-monitor-subagent 子代理来轮询 CI 状态,并根据结果做出决策。
用途
该技能主要用于自动化监控 Nx Cloud CI 流水线的执行状态,并在出现失败时尝试自愈修复。它适用于需要持续跟踪 CI 结果并自动处理常见问题的开发工作流。
主要能力
- 监控 Nx Cloud CI 流水线状态,通过子代理轮询。
- 根据子代理返回的状态(如 ci_success、fix_auto_applying、fix_available、fix_failed 等)执行相应的默认行为。
- 支持配置项:--max-cycles(默认 10)、--timeout(默认 120 分钟)、--verbosity(默认 medium)、--branch(自动检测)、--subagent-timeout(默认 30 分钟)、--fresh(默认 false)、--auto-fix-workflow(默认 false)、--new-cipe-timeout(默认 10 分钟)、--local-verify-attempts(默认 3)。
- 提供本地验证流程,包括检测包管理器、并行运行可验证任务、评估结果并决定是否应用修复。
- 支持通过 MCP 调用应用、拒绝或请求重跑修复。
- 处理环境问题、自愈节流、无新 CI 尝试、CI 尝试无任务等特殊情况。
使用方式
用户可以通过命令 /monitor-ci 触发该技能,并可附加参数覆盖默认配置。技能会首先检查工作区是否连接到 Nx Cloud(通过 nx.json 中的 nxCloudId 或 nxCloudAccessToken),如果未连接则退出并提示。然后进入主循环,派生 ci-monitor-subagent 子代理进行轮询,并根据返回状态执行相应操作。用户可以通过 --fresh 参数忽略之前的上下文,或直接重新运行以继续监控。
适用场景
适用于使用 Nx Cloud 并希望自动化监控 CI 流水线、自动处理失败修复的开发团队。特别适合需要减少人工干预、提高 CI 效率的场景。
限制
- 需要工作区已连接到 Nx Cloud,否则无法使用。
- 禁止使用 CI 提供商 CLI 的 --watch 标志、编写自定义轮询脚本、取消 CI 工作流、在主代理上运行 CI 检查等反模式。
- 自愈修复可能受节流限制,需要手动拒绝未应用的修复。
- 本地验证有尝试次数限制,超过后会将代码推送到 CI 进行最终验证。
- 某些状态(如 no_new_cipe、cipe_no_tasks)可能需要用户手动调查。
- 具体功能、收费、价格、平台、效果或使用步骤等细节暂未提供。