SuperAPI AI 工具集

nx-cloud-ci-failure-review

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:审查 Nx Cloud CI 失败执行,把失败流水线归并为少量基于证据的诊断分组。该工作流为只读,所有 Nx Cloud 读取需依赖 nx-cloud-api 技能。

主要能力:支持聚焦调查模式(用户提供 CIPE 或 run-group 链接时,先取这些记录并沿返回的 run-group、run、task、workflow 链接比较)和审查模式(工作区失败审查,默认最近 24 小时,因 CIPE 与 run-group 列表按 createdAt 过滤,需查询 30 小时创建窗口以覆盖最长六小时 CI)。查询 statuses=FAILED、TIMED_OUT、CANCELED,并说明分支、CI 上下文、状态、端点与记录数。

使用方式:所有读取使用 nx-cloud-api(npx nx-cloud api),用 --describe 查看 cipes、run-groups、runs、runs/{runId}/tasks 等实时 schema,用 --list-operations 确认路由。按顺序收集:失败/超时/取消的 CIPE、关联 run group 及其 critical-error 字段、runs 与终态 task、必要时 workflow 与 instance 状态、代表性日志片段。最多五个窄详情请求,日志仅在分组进入前五后读取,读取前告知用户,只引用脱敏错误行。

分组方法:以 task 标识加规范化错误签名为基础,规范化时间戳、GUID、重试计数、临时路径与随机端口,保留区分性堆栈、命令与错误码。类别包括重复任务错误、任务超时、取消、工作流或智能体失败、未知流水线失败,仅在证据支持时使用。需先核对完整流水线,例如 task 成功或缓存命中但主任务在制品下载/校验/恢复时失败,应将缓存恢复错误列为主因,取消的 run 列为后果。每组记录 CIPE 数、run-group 数、受影响 task 数、首末时间、分支/上下文及一两个代表 ID,按受影响流水线数、复现频率、阻塞时长排序。

下一步规则:重复任务错误可在有工作区检出时检查 CODEOWNERS 与项目归属元数据并建议审查负责人;任务超时比较时长与资源证据;取消需识别取消来源或单列为未知取消;工作流或智能体失败仅在证据支持瞬时事件时重试或监控;未知则请求最小日志或运行详情。未经明确批准不得更改代码、工作流或资源分配。

报告格式:包含范围、失败分组(每组含确认事实、评估为已确认/可能/需诊断运行、影响、最高杠杆下一步)以及未分类或不完整数据,报告最多五组。

限制:公开 API 无独立 workflow 路由,需沿返回链接访问子记录;分页、缺失资产或上下文会影响结论时需说明数据限制。具体收费、平台支持范围等资料暂未提供。