用途:在 /renovate-review 已识别出需要修改代码的破坏性变更后,对指定 Renovate PR 执行依赖升级迁移。
参数:pr-number(必填)为要迁移的 PR 编号;--comment(可选)将迁移摘要作为 PR 评论发布,省略则仅在本地输出;--push(可选)迁移完成后推送提交到远端,省略则仅本地提交。
前置条件:应先运行 /renovate-review 并确认存在需要代码修改的破坏性变更。
流程:先加载审查上下文,若同一对话中已运行过 /renovate-review 可直接使用上下文,否则从 PR 评论获取,命令为 gh pr view <pr-number> --json comments --jq '.comments[] | select(.body | contains("## Dependency Upgrade Review")) | .body';再用 gh pr view <pr-number> --json title,body,files 补充 PR 上下文;随后按审查中的“Required Code Changes”逐项迁移,查找旧 API 用法并按新 API 修改,每个逻辑变更单独提交,提交信息格式为 refactor: migrate <package-name> to v<version> - <specific change>,提交命令为 git add <specific-files> 与 git commit -m "refactor: migrate <package> to v<version> - <change>"。
验证:迁移后确保代码可编译(pnpm run build 或 pnpm run build:ts),用 Prettier 和 pnpm run format 格式化,并运行相关测试;提供 --push 时推送远端,否则保留本地。
摘要与推送:生成迁移摘要,包含包名版本变化、提交数、修改文件数、状态及提交与变更明细;仅在提供 --push 时执行 git push,仅在提供 --comment 时执行 gh pr comment <pr-number> --body "<migration-summary>"。
限制与注意:仅当提供 --push 才推送远端,否则只本地提交;提交应小而聚焦,每个提交对应一项具体变更;尽量在每次重要变更后运行类型检查;迁移不应改变应用行为,只更新 API 用法。其他未在资料中说明的细节暂未提供。