用途:审查 Renovate 机器人提交的 NPM 依赖升级 PR,判断升级是否安全、合并前需要多少改动。
主要能力:接收必填参数 pr-number(要审查的 PR 编号)和可选参数 --comment(将评估结果作为 PR 评论发布,省略则仅在本地输出)。流程包括:用 gh pr view $ARGUMENTS --json title,body,files 获取 PR 信息,提取被升级的包名、旧版本与新版本,并判断升级类型为 patch、minor 或 major;按语义化版本假设,patch 与 minor 不应含破坏性变更,重点验证是否引入回归并检查 CI 是否通过;对 major 升级,通过 GitHub releases 页面、仓库中的 CHANGELOG.md 及迁移指南研究破坏性变更,并识别可能影响当前代码库的部分;搜索代码库中对被升级包的 import/require,找出依赖它的文件与功能,对 major 升级检查是否使用了已弃用或移除的 API。
输出:生成 Markdown 评估,包含包名、版本变化与升级类型、风险等级(Low/Medium/High)、影响文件数、建议(Safe to merge / Review recommended / Changes required)、一行说明,以及受影响文件、破坏性变更和所需代码改动等折叠详情。风险评级依据:patch/minor 或无相关破坏性变更的 major 为 Low;有破坏性变更但不影响当前用法为 Medium;破坏性变更影响当前用法为 High。影响评级依据文件数量与复杂度。仅当提供 --comment 时,才用 gh pr comment <pr-number> --body "<assessment>" 发布评论。
适用场景:审查 Renovate 机器人发起的 NPM 依赖升级 PR。
限制:资料未提供安装方式、运行环境要求、支持的包管理器范围及收费信息;评估依赖 gh 命令与网络访问 GitHub 仓库。