SuperAPI AI 工具集

nemoclaw-maintainer-fix-e2e-failures

通用与其它

查看项目

更新于 10-16 02:34

技能介绍

该技能用于持续维护 NemoClaw main 分支上的自动 E2E 结果,通过协调修复来保持 main 稳定,适用于长期维护而非一次性派发或诊断。

用途:持续检查 main 的自动 E2E 运行结果,按根因归并失败,协调 GitHub 上的归属与合并决策。

主要能力:

  • 设置运行规则:循环无固定结束时间,不因队列为空或最新运行通过而结束;发布相关操作不在范围内,须交由既有发布工作流;仅在请求授权时合并 PR。
  • 维护队列:按根因分组,记录根因、运行与 job、状态、负责人与 PR、下一步动作;状态限定为 unclaimed、active、waiting-ci、waiting-review、approval-ready、merged、obsolete、blocked。
  • 运行循环:刷新 origin/main,仅检查新增或变化的运行;加载 nemoclaw-maintainer-classify-ci-failure 读取失败 job 的有界日志与保留产物,识别最早可操作失败;将同一因果特征的失败分组,不把 job 名等同于根因。
  • 认领根因:在修改产品代码前搜索匹配的开放 PR,从刷新后的 origin/main 建分支,为根因添加一个诊断或回归测试;无法仅证明该根因时标记为 blocked。按 nemoclaw-contributor-create-pr 打开 draft PR,PR 正文包含根因键、源工作流 URL、源 run ID、失败 job 名称与 ID、失败特征。同一 agent 一次只进行一个有效修复。
  • 审查与合并同行 PR:不得批准自己的 PR;需至少一个非作者账号对最新提交的批准,并通过维护者门禁检查、GitHub 必需检查及适用的安全审查;合并前重新阅读 PR 与规则,不得使用管理员绕过。
  • 避免重复 E2E:不得使用 gh run rerun、gh workflow run .github/workflows/e2e.yaml 或本地实时 E2E 来重复自动运行;不得削弱、跳过、删除或缩小语义覆盖来消除失败。
  • 关闭过时工作:每次推送与合并前检查 main 或其他 PR 是否已移除根因,若已移除则停止编辑并关闭过时 PR,标记为 obsolete。
  • 控制合并失败:若自动 main 运行保留根因特征或显示回归,确认失败的 agent 成为控制负责人,标记根因 blocked,暂停相关合并写入;不得直接还原 main,仅在明确授权下创建回滚 PR(draft revert PR),并同样经过审查、检查与合并授权门禁。
  • 转移但不结束循环:循环无固定结束时间,仅在操作者取消或另一活跃 agent 确认接管监控与所有开放项后方可离开;离开前完成进行中的只读操作、保留源编辑、删除自有临时证据目录并验证其不存在、产出一致性交接。

适用场景:NemoClaw main 分支 E2E 失败的持续维护,包括失败分类、根因认领、PR 创建与审查、过时工作关闭及合并失败控制。

限制:该技能不覆盖发布操作;不得重复自动 E2E 运行或削弱覆盖;合并需明确授权;回滚需显式授权,且不能绕过审查与检查;无授权或归属不明时不得进行回滚写入。

必要命令保持原样:gh run rerun、gh workflow run .github/workflows/e2e.yaml。

关于收费、价格、支持平台等细节,资料暂未提供。