update-packages 是用于依赖升级与包版本更新的技能,适用于升级依赖、处理过期依赖或执行依赖更新。运行前先确定模式:咨询模式只分析、报告和提出变更,不创建分支;执行模式应用版本变更,并在首次编辑包前创建新的更新分支。
执行时可使用 references 下的参考资料:package-groups.md(需一起更新的包组)、feature-adoption-tiers.md(T0-T3 采用标准)、report-formats.md(发布报告与“What's New”输出格式)、testing-matrix.md(按更新类型要求的测试)、runtime-checklists.md(Bun 与 Playwright 更新检查清单)。执行模式先更新技能再建分支,更新分支不复用,所有更新提交放在该分支上。常用命令包括 bun run .agents/skills/update-packages/references/skills-update-local.ts(可加 --dry-run)、check-outdated.ts(可加 --changelog)、report.ts --json,以及 git checkout -b chore/update-packages-$(date +%y%m%d-%H%M)。生成的 JSON 报告为本地临时产物,不应提交。
按包组依次执行:识别版本与发布说明、并行进行“应用更新”和“采用新特性”、检查并修复、提交该组。提交分开进行版本升级与特性采用。最后按 report-formats.md 生成发布报告与“What's New”摘要。限制方面:不要更新带 workspace:* 的包;不要跳过 @typescript/native-preview 更新;不要使用 bun outdated,应使用 check-outdated.ts;不要绕过 Bun 的 minimumReleaseAge 策略,除非用户明确要求。若安装因该策略失败,应选择符合策略的最新版本后重试 plain bun install;仍失败可运行 bun clean:packages 后再 install。完成标准为 check-outdated.ts 显示无剩余直接依赖更新、bun run check 通过、testing-matrix.md 要求的测试全部通过。