SuperAPI AI 工具集

dependency-upgrade

通用与其它

查看项目

更新于 10-16 05:07

技能介绍

用途:在依赖已进入清单、需要变更版本时,按顺序安全地完成升级,避免盲目锁定或批量升级带来的回归。

主要能力与顺序:安全公告优先,CVE 修复可插队;开发依赖先于运行时依赖;次要/补丁版本按生态批量提交;主要版本一次只升一个,各自独立提交并跑完整门禁。

每次升级的协议:先读目标版本的变更日志与破坏性说明;验证目标版本或标签在上游真实存在(Git 引用用 git ls-remote --tags <repo-url>,注册表包用 npm view <pkg> versions、pip index versions <pkg> 等);GitHub Actions 建议把已验证标签解析为 40 位提交 SHA 并固定,版本号写在尾部注释;复合/元包需检查其内部固定项。锁文件必须用生态自带管理器重生成,如 pnpm install、uv lock、go mod tidy、cargo update,不得手改。随后运行完整质量门禁:测试、linter、类型检查、构建。失败须先定位根因,不得叠加第二次升级。

回归与回滚:为升级改变的行为补回归测试;回滚单位是一次升级提交(git revert <sha>),这也是主要版本必须隔离的原因。升级后还需在代码库中搜索破坏性说明中移除、改名或弃用的 API,不能只依赖构建或类型检查。

审查 Dependabot/Renovate PR:按升级决策对待,读变更日志、验证目标引用存在、检查内部固定项,并按手动升级同样方式分批。

限制:资料未提供具体支持的生态范围、自动化程度、收费或平台信息;该协议从依赖已在清单中开始,不负责新依赖的注册表存在性检查。