SuperAPI AI 工具集

dependency-upgrade-pr

编程与开发

查看项目

更新于 10-16 06:15

技能介绍

用途:面向依赖升级场景,当“构建通过”不足以证明升级安全时使用。智能体负责分支,直到合并,或证明该依赖变更确实引发 bug 或不兼容。

主要能力与流程:采用 proof-of-work 管理 PR 生命周期,包括当前 origin/main、codex/ 分支与工作树、worklog、PR、精确提交头检查、自动合并与合并验证。编辑前检查 package.json、锁文件、包管理器配置、工作区文件、必要的发布说明、npm dist-tags,以及 pnpm outdated 或仓库对应的等价命令。

预发布处理:有意保留预发布通道。对 Svelte/SvelteKit/适配器、编译器与框架包,不因 latest 指向较旧稳定线而降级。用仓库的包管理器更新版本与锁文件,除机械性冲突解决外不手工编辑锁文件。

本地验证:依赖变更至少运行冻结安装、类型检查、单元测试与构建,并补充目标仓库文档化的专属验证。对框架、编译器、适配器、构建工具、原生或平台敏感包,还需验证部署后的预览/运行时路径。

提交与合并:提交、推送、在 PR 正文更新决策与证据;本地验证通过且所需精确提交头检查处于待定或绿色时启用自动合并。持续监控直至合并;检查失败则查看日志并修复、变基、重跑或回退,不留下模糊的合并路径。

运行时验证:构建/部署就绪不等于运行时证据。对图像处理、加密、数据库驱动或可选原生二进制等包,需在目标运行时实际执行导入或使用该包的已部署路由、函数、worker 或浏览器流程。Vercel 类预览需核对 PR 头 SHA,确认实际浏览器/运行时测试步骤已运行;跳过、过期或无关的预览检查不算证据。临时探针路由、脚本或诊断须在合并前移除,除非作为有用的永久回归测试。

失败分诊:从当前 origin/main 变基或重启过期分支;本地验证通过后保持自动合并,除非依赖变更导致真实 bug 或不兼容破坏。区分无关的 CI 抖动、脏分支状态与预览环境失败同依赖导致的失败。若依赖本身有问题,记录确切包/版本、复现、日志与回滚或固定决策。

收尾报告:变更的包及原因、预发布/dist-tag 决策、本地验证命令、预览/运行时验证路径与精确 PR 头 SHA、自动合并或合并状态、未解决的依赖导致 bug 或外部阻塞。