用途:审查 Renovate 机器人提交的 NPM 依赖升级 PR,判断升级是否安全、合并需要多少改动。
主要能力:通过 gh pr view 获取 PR 标题、正文与文件,提取被升级的包名、旧版本与新版本,并按语义化版本判断升级类型(patch、minor、major)。对 major 升级,会查阅 GitHub releases 页面、CHANGELOG.md 或迁移指南,识别可能影响当前代码库的破坏性变更;同时搜索代码库中对被升级包的 import/require,统计受影响文件与功能,检查是否使用了已废弃或移除的 API。最终生成 Markdown 评估,包含风险等级(Low/Medium/High)、影响文件数、建议(Safe to merge / Review recommended / Changes required)及受影响文件、破坏性变更、所需代码改动等细节。
使用方式:参数 pr-number 必填,--comment 可选。命令示例:gh pr view $ARGUMENTS --json title,body,files;若带 --comment,则用 gh pr comment <pr-number> --body "<assessment>" 发布评论,否则仅在本地显示评估。
适用场景:维护使用 NPM 依赖且由 Renovate 自动提 PR 的仓库,在合并前快速评估升级风险。
限制:假定包遵循语义化版本;评估依赖 CI 状态与公开的发布说明、变更日志,若资料缺失则难以准确判断破坏性变更;仅针对 NPM 依赖升级 PR。