SuperAPI AI 工具集

nemoclaw-maintainer-analyze-pr-value-stream

编程与开发

查看项目

更新于 10-16 07:24

技能介绍

用途:对单个 NemoClaw Pull Request 的完整可观测生命周期做一次确定性、只读分析,用于定位贡献者、评审和自动化环节的延迟,或与延迟目标(默认 10 分钟)对比。

主要能力:每次调用收集完整保留的生命周期,生成 Perfetto 兼容 trace、summary 和 manifest,写入 .nemoclaw-maintainer/pr-value-stream/pr-<number>/,并把 summary 以有界 JSON 输出到 stdout。trace 包含生命周期事件、所有保留的 PR 修订、工作流、作业队列、作业执行、步骤、外部检查、评审、评论、行内反馈、提交发布跨度以及反馈到下一次变更的时间跨度。

使用方式:需在已认证 gh 的 NemoClaw 检出目录中运行,使用 Node.js 22.19 或更高版本并启用 type stripping。命令: node --no-warnings
.agents/skills/nemoclaw-maintainer-analyze-pr-value-stream/scripts/analyze-pr-value-stream.mts
--workdir "$PWD"
--number <pull-request-number> 默认仓库为 NVIDIA/NemoClaw,仅在用户要求时用 --repository OWNER/REPO;目标默认 10 分钟,仅在用户要求时用 --target-minutes。保留的 Vitest 产物计时为条件性:需安装依赖使 node_modules/vitest/vitest.mjs 可用,并安装 zipinfo 与 unzip。

结果解读:优先报告 target.status 与 target.theoreticalFastestSeconds、bottlenecks 中最大项、elapsed.approvalDelaySeconds 与 elapsed.mergeLagAfterReadySeconds、产物路径与计数以及所有 caveats。不要把回退分支时间戳当作精确值,不要从时间跨度推断因果,null 计时字段视为排队或未观测。

限制:脚本不写 GitHub;对输出、分页、修订、工作流运行、作业、trace 事件、产物与文件大小设界,拒绝不完整历史。GitHub 不暴露规范的分支创建时间或 PR 描述编辑历史,trace 以首个保留的精确提交工作流作为可观测推送信号。产物发布使用每 PR 锁,活跃发布最多等待 30 秒,锁超过五分钟未动且所有者身份不匹配或元数据不可读时回收。