update-packages 是一个依赖更新技能，适用于升级依赖、提升包版本、处理过时依赖或执行依赖更新。运行前需先确定操作模式：Advisory 模式仅分析、报告并提出变更，不创建分支；Execution 模式实际应用版本变更，并在首次编辑包前创建新的更新分支。
执行过程引用多份参考文档：package-groups.md（必须一起更新的包分组）、feature-adoption-tiers.md（T0-T3 采用评级）、report-formats.md（发布报告与 What's New 输出格式）、testing-matrix.md（按更新类型要求的测试）、runtime-checklists.md（Bun 与 Playwright 更新清单）。
Execution 模式先更新技能并建分支，例如执行 bun run .agents/skills/update-packages/references/skills-update-local.ts，可用 --dry-run 预览，然后用 git checkout -b chore/update-packages-$(date +%y%m%d-%H%M) 创建分支。规则是：先更新技能；为执行工作创建新更新分支；不复用旧更新分支；所有更新提交放在执行分支上。
按包分组流程依次执行四个步骤：第一步运行 check-outdated.ts、check-outdated.ts --changelog 和 report.ts --json 生成报告，JSON 分别保存到 outdated.json、outdated-changelog.json、runtime-report.json，这些文件为一次性本地产物，不提交；会话开始时重新生成全部三份报告，必要时先删除旧报告；catalog 包在根 package.json 的 catalog 与 catalogs 下手动更新，需要时用 npm view <package> version 查最新版，然后 bun install。第二步并行推进版本升级与特性采用，按 T0-T3 评级处理配置级变更或生成具体差异，并搜索已改动/弃用/新增 API 的使用位置。第三步运行 testing-matrix.md 要求的测试与 bun run check，并修复失败。第四步分组提交，版本升级与特性采用分开提交。
限制与护栏：不更新 workspace:* 包；不跳过 @typescript/native-preview 更新；不使用 bun outdated，改用 check-outdated.ts；安装失败时先 bun clean:packages 再 bun install。完成标准为 check-outdated.ts 显示无剩余直接依赖更新、bun run check 通过、testing-matrix.md 要求的测试全部通过。