NemoClaw 维护者晨间巡检实战基于版本目标脚本、triage 打分队列与 gh 标签的每日发布计划【免费下载链接】NemoClawRun agents like Hermes, LangChain Deep Agents, and OpenClaw more securely inside NVIDIA OpenShell with managed inference项目地址: https://gitcode.com/gh_mirrors/ne/NemoClaw导读本文讲解 NemoClaw 开源仓库中维护者自动化技能体系.agents/skills/下的 Agent Skills的晨间入口——nemoclaw-maintainer-morning它在每个工作日的开始通过版本目标脚本确定当天要发布的补丁版本、找出仍然挂着旧版本标签的掉队项stragglers用 triage 脚本对整个 PR 积压进行确定性打分排序最终把确认的目标项打上版本标签、写入本地状态文件并输出一份可执行的每日计划。读完本文你将掌握这套晨间流程的完整命令序列、底层脚本的评分模型与状态机设计以及如何把 NemoClaw 的晨间 triage → 日间执行 → 傍晚发布节奏应用到自己的维护工作中。一、技能定位每日发布节奏的起点1.1 技能元信息nemoclaw-maintainer-morning是一个user_invocable: true的 Agent Skill其 frontmatter 定义如下name: nemoclaw-maintainer-morning description: Prepare the NemoClaw morning maintainer plan: triage the backlog, select a target version, and identify release candidates and stragglers. user_invocable: true它位于 .agents/skills/nemoclaw-maintainer-morning/SKILL.md核心目标是Start the day: triage, pick a version target, label items, share the plan——即启动一天的维护工作分级处理积压、选定版本目标、给条目打标签、共享计划。1.2 在日循环中的位置该技能属于 NemoClaw 维护者日循环的四个阶段之一。据 .agents/skills/nemoclaw-maintainer-day/PR-REVIEW-PRIORITIES.md 中的 Daily cadence 定义Morning/nemoclaw-maintainer-morningtriage 积压为当天挑选条目并打上目标版本标签如v0.0.8During the day/nemoclaw-maintainer-day使用维护者循环合入 PR版本标签让进度在 dashboard 上可见Evening/nemoclaw-maintainer-evening检查已发布工作与累计文档 PR确认覆盖发布所选的全部合并变更并包含docs/changelog/YYYY-MM-DD.mdx然后准备发布简报、在确认后打 tagOvernight隔夜其他时区的 QA 团队验证 tag新 issue 进入第二天早晨的 triage。技能本身的 Notes 也明确了运行时机该技能每天只在一天开始时运行一次日间使用/nemoclaw-maintainer-day执行具体动作。二、Step 1确定目标版本与掉队项2.1 运行版本目标脚本node --no-warnings .agents/skills/nemoclaw-maintainer-day/scripts/version-target.ts脚本的源码位于 .agents/skills/nemoclaw-maintainer-day/scripts/version-target.ts其执行逻辑可以拆解为三步同步 tag首先执行git fetch origin --tags --prune确保本地 tag 与远端一致计算下一个补丁版本通过git tag --sort-v:refname按版本倒序读取最新 semver tag正则/^v\d\.\d\.\d$/过滤找不到则回退到v0.0.0然后对 patch 位 1。例如最新 tag 是v0.0.7则当天目标为v0.0.8若最新 tag 是v0.0.0即首次运行目标回退为v0.0.1查找掉队项stragglers通过gh pr list --state open与gh issue list --state open各限 200 条拉取所有带版本标签的开放 PR 和 issue凡标签匹配vX.Y.Z且compareSemver(label, targetVersion) 0严格早于当天目标版本的条目都归入 stragglers。脚本输出为 JSON{ latestTag: v0.0.7, targetVersion: v0.0.8, stragglers: [ { number: 1230, title: fix: onboarding retry backoff, url: https://github.com/NVIDIA/NemoClaw/pull/1230, type: pr, versionLabel: v0.0.7 } ] }值得注意的两个边界行为源码注释明确说明只标记早于目标版本的标签目标版本本身和未来版本如v0.0.11都不会被视为掉队项脚本支持--repo OWNER/REPO参数默认值是NVIDIA/NemoClawgit tag 始终来自本地 checkout只有gh查询针对指定 repo。2.2 掉队项的处置决策技能明确要求先把掉队项摆在最前面处理——它们表明打 tag 后的收尾工作被打断或者某个条目跨了多个周期仍未解决。维护者需要在以下两者间决策重新打标签到当天目标说明该条目确实应当进入当天的发布流将其移出每日发布流即推迟避免它继续滞留、掩盖真实状态。这条规则的底层逻辑是版本标签激活发布工作详见第四节一个条目若连续多个版本周期挂着旧标签说明它从未真正进入过合入流程属于最需要人工判断的悬置状态。三、Step 2Triage——对完整积压进行打分排序3.1 运行 triage 脚本node --no-warnings .agents/skills/nemoclaw-maintainer-day/scripts/triage.ts --approved-only如果结果太少可以去掉--approved-only重新运行。源码位于 .agents/skills/nemoclaw-maintainer-day/scripts/triage.ts其职责在文件头注释中写得很清楚Deterministic NemoClaw maintainer triage queue builder. Lists open PRs via gh, classifies them as merge-ready / near-miss / blocked, enriches top candidates with file-level risky-area detection, applies scoring weights, filters exclusions from the state file, and outputs a ranked JSON queue.3.2 数据获取与富化链路整个管线分四个阶段REST 拉取全部开放 PRgh api --paginate repos/{repo}/pulls?stateopenper_page100用--jq输出 NDJSON每行一个 JSON 对象避开 GraphQL 分页超时问题读取 Project 199 优先级对NVIDIA/NemoClaw使用 GraphQL 查询projectV2(number: 199)的Priority字段得到Urgent / High等优先级映射仅当 repo 为NVIDIA/NemoClaw时执行富化头部候选按 Project Priority 排序后对前limit * 3个非 draft PR 逐个调用gh pr view --json reviewDecision,statusCheckRollup,additions,deletions,changedFiles补充评审与 CI 数据。注释明确这是有意设计的 API 调用上限——每个enrichPr()都是一次 GitHub API 请求因此限制爆炸半径未富化的 PR 会按blocked空 checks处理这是安全默认值不是 bug排除清单过滤读取本地状态文件.nemoclaw-maintainer/state.json中excluded.prs记录的 PR 号从队列中剔除。3.3 分类与打分模型classifyPr()依据 CI 状态、合并状态、评审决定把每个 PR 归入四类桶merge-now非 draft CI 全绿 无冲突 已 APPROVEDreview-ready非 draft CI 全绿 无冲突但尚未批准near-misssalvage-now非 draft存在可修复阻塞CI 失败或小冲突阻塞原因不超过 2 条且无真实冲突blocked其余情况。其中 CI 判定需要同时兼容 GitHub 的两种 check 形态CheckRun字段name/status/conclusion与StatusContext字段context/state且要求 .agents/skills/nemoclaw-maintainer-day/scripts/shared.ts 中REQUIRED_CHECK_NAMES列出的 5 项检查全部出现才算绿checkslint/typecheck/test、check-hash、changes、commit-lint、dco-check。首次贡献者 fork PR 在Approve and run之前pull_request工作流不会执行此时缺少必需 check 一律视为非绿。打分权重全部集中在shared.ts中与check-gates.ts、hotspots.ts共享保证口径一致信号权重含义SCORE_MERGE_NOW40已批准、CI 全绿只差最终 gateSCORE_REVIEW_READY35可进入维护者评审SCORE_NEAR_MISS30有明确的小修复路径SCORE_SECURITY_ACTIONABLE20触碰安全敏感代码且可行动SCORE_LABEL_SECURITY15携带securityGitHub 标签SCORE_PROJECT_PRIORITY_URGENT15Project Priority 为 UrgentSCORE_PROJECT_PRIORITY_HIGH10Project Priority 为 HighSCORE_STALE_AGE5超过 7 天未更新防止腐烂PENALTY_DRAFT_OR_CONFLICT−100draft 或有实质冲突PENALTY_CODERABBIT_MAJOR−80未解决的 major/critical CodeRabbit 发现PENALTY_BROAD_CI_RED−60大面积 CI 失败且无本地修复路径PENALTY_MERGE_BLOCKED−20等待外部管理员动作scoreItem()还基于isRiskyFile()见shared.ts的RISKY_PATTERNSinstall.sh、setup.sh、src/lib/onboard/、nemoclaw/src/blueprint/、.github/workflows/、policy/ssrf/credential/inference 等路径做文件级风险检测命中风险文件且条目可行动时追加SCORE_SECURITY_ACTIONABLE并把 nextAction 升级为security-sweep → merge-gate或security-sweep → review。最终排序后输出{ queue, nearMisses, hotClusters }三段主队列merge-now review-ready、可抢救项salvage-now、热区簇detectHotClusters()统计前 30 个 PR 的文件交集出现 ≥3 次的路径即热点最多报 15 个。3.4 合并安全候选技能还要求使用find-review-pr见 .agents/skills/nemoclaw-maintainer-find-review-pr/SKILL.md找出 Project Priority 为Urgent或High的security标签 PR合入候选池。该技能通过gh project item-list 199 --owner NVIDIA --limit 1000 --format json拉取项目条目再对每个候选做 issue 关联、竞争/取代检测调用nemoclaw-maintainer-pr-comparator的parse-supersession.sh最终按Urgent 优先 → 最老优先 → 检查通过的优先 → diff 小的优先给出评审建议。四、Step 3为确认的目标打版本标签在把排序后的队列呈现给用户、并得到用户对目标条目的确认之后执行打标签gh label create version --repo NVIDIA/NemoClaw --description Release target --color 1d76db 2/dev/null || true gh pr edit number --repo NVIDIA/NemoClaw --add-label version gh issue edit number --repo NVIDIA/NemoClaw --add-label version第一行是幂等创建标签若标签已存在则静默失败2/dev/null || true颜色1d76db为 GitHub 的蓝色系后两行分别给 PR 和 issue 添加版本标签。标签的语义技能 Notes 与 PR-REVIEW-PRIORITIES.md 双重强调对 PR版本标签激活每日发布工作真正进入发布的前提是该 PR 在 cutoff 时带着标签被合入对 issue版本标签只是追踪或needs PR协调标记不代表就绪版本标签只表示发布工作被激活不代表就绪程度若某开放条目错过 tag应把其标签移到下一个补丁版本当没有开放条目再携带某已发布标签时删除该标签不要重命名或复用。五、Step 4保存状态并输出每日计划5.1 把 triage 输出写入状态node --no-warnings .agents/skills/nemoclaw-maintainer-day/scripts/triage.ts \ | node --no-warnings .agents/skills/nemoclaw-maintainer-day/scripts/state.ts set-queueset-queue从 stdin 读取 triage JSON解析失败会以非零码退出把queue、nearMisses、topAction写入状态文件。状态管理器的完整实现位于 .agents/skills/nemoclaw-maintainer-day/scripts/state.ts支持这些子命令node .../state.ts init|show|exclude|unexclude|history|set-queue|set-hotspots [args]子命令作用init创建.nemoclaw-maintainer/state.json并把.nemoclaw-maintainer/追加进.git/info/exclude本地忽略不入库show打印当前完整状态exclude number reason将 PR 加入永久排除清单triage 只处理 PRunexclude number移除排除记录history action item note追加一条历史记录最多保留最近 50 条set-queue从 stdin 管道更新队列set-hotspots从 stdin 管道更新热区数据状态文件的结构StateFile接口包含version、repo、updatedAt、priorities默认四项reduce_pr_backlog、reduce_security_risk、increase_test_coverage、cool_hot_files、gates默认greenCi/noConflicts/noMajorCodeRabbit/testsForTouchedRiskyCode/autoApprove/autoPushSmallFixes为 trueautoMerge为 false、excluded、queue、hotspots、activeWork、history。日间的/nemoclaw-maintainer-day技能会读取这份状态以避免重复上下文。5.2 输出每日计划表技能要求按以下表格格式输出每日计划并统计目标条目总数、其中 PR 与 issue 各多少、已有多少条目达到可合入状态。TargetItemTypeOwnerNext actionv0.0.8#1234PRauthorRun merge gatev0.0.8#1235IssueunassignedNeeds PRNext action 一列应直接继承 triage 输出的nextAction语义merge-gate、review → merge-gate、security-sweep → merge-gate、salvage-pr等让维护者一眼知道每个条目当天的下一步动作。六、晨间输出如何衔接日间与傍晚流程晨间计划的产物——版本标签与状态队列——是后续流程的输入日间/nemoclaw-maintainer-day.agents/skills/nemoclaw-maintainer-day/SKILL.md优先处理带目标版本标签的工作执行批准 → 小修复 → 安全清扫 → 补测试 → 化解冲突 → 拆分排序的动作选择顺序每次 pass 只完成一个结果approve / push fix / add test / reduce conflicts / report blocker。注意该技能明确绝不自行 merge合入决定必须询问用户傍晚/nemoclaw-maintainer-evening.agents/skills/nemoclaw-maintainer-evening/SKILL.md检查vX.Y.Z的已合入/未合入条目、累计文档 PR、最新 E2E 状态在用户给出精确确认短语后才打 tag。晨间技能产出的掉队项处置结论relabel 或 defer也会直接影响傍晚的标签清理规则已发布的标签在无开放条目持有时应被删除。七、常见问题与实操提示--approved-only结果太少怎么办该参数在富化之后、此时reviewDecision已知才生效只保留 APPROVED 条目去掉它即可看到包括未批准但 review-ready 在内的完整队列。必须运行 gate 检查吗triage 的classifyPr()出于性能考虑不逐 PR 拉取 CodeRabbit 评论线程coderabbitMajor被保守置为false——一个 PR 在 triage 中显示 merge-now仍可能在check-gates.ts.agents/skills/nemoclaw-maintainer-day/scripts/check-gates.ts的硬门禁上失败。因此批准前必须运行 check-gates。PR-REVIEW-PRIORITIES.md 的 7 条硬门禁产品范围批准、DCO 合规、安全正确性、CI 全绿、无合并冲突、无未解决 major/critical CodeRabbit 发现、风险代码必须有测试是批准的前置条件。掉队项必须最先处理它们已经错过一次如果再次放任会无限期滞留并干扰后续版本周期的标签统计。环境要求全部脚本依赖ghGitHub CLI已安装并认证find-review-pr还要求 token 具备read:projectscope、本地为 git 仓库tag 读取来自本地 checkout以及 Node.js 可直接执行.ts脚本脚本通过node --no-warnings直接运行。结语nemoclaw-maintainer-morning把每天开始时的积压清理从人工记忆变成了一条确定性的流水线version-target.ts定版本、triage.ts打分排序、find-review-pr补安全候选、gh命令打标签、state.ts持久化、最后输出带 next-action 的计划表。理解它的评分权重shared.ts与状态机state.ts你不仅能直接运行这套晨间流程也能复用它设计属于自己的开源维护节奏——把今天该合什么变成可审计、可回放、可交接的工程产物。【免费下载链接】NemoClawRun agents like Hermes, LangChain Deep Agents, and OpenClaw more securely inside NVIDIA OpenShell with managed inference项目地址: https://gitcode.com/gh_mirrors/ne/NemoClaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考