用途:把当前项目里的 ibl.ai 工具链升级到最新版本,包含两部分——package.json 中的 @iblai/iblai-js SDK,以及来自同一仓库的全部 ibl.ai 技能(iblai-vibe-* 与 iblai-api-* 两个系列)。已安装的技能只是副本,不会自动更新,因此当本地副本落后于最新发布时应运行本技能。
主要能力与流程:
- 判断本地副本是否过期:定位 .claude/skills、.agents/skills 或 .cursor/rules 下的 SKILL.md,比较修改时间与 GitHub 最新 release;若 release 更新或副本超过 14 天则继续,否则提示已是最新并停止。
- 检测当前 SDK 版本:node -p "require('./package.json').dependencies['@iblai/iblai-js'] || ''"。
- 升级 SDK:无 package.json 或未依赖该包时跳过;先移除旧脚手架遗留的 @iblai/web-containers 1.16.0 override(位于 pnpm-workspace.yaml 的 overrides: 或 package.json 的 pnpm.overrides),否则组件会停留在旧 UI;随后执行 pnpm update @iblai/iblai-js@latest 或 npm install @iblai/iblai-js@latest。若 pnpm-lock.yaml 仍解析到 1.16.0,则报错退出。之后可运行 pnpm typecheck 或 npx tsc --noEmit 做检查,出现新错误需反馈给用户,可能为破坏性变更。
- 刷新技能:npx skills add iblai/vibe --all,非交互式拉取两个系列、Cursor/Codex 适配器及新增技能。
- 展示更新:从 vibe CHANGELOG 取最近条目,按主题归纳 3-7 条面向用户的变更,并输出升级报告(SDK 版本变化、技能来源与最新 tag、更新要点);被跳过的步骤需在总结中注明。
适用场景:新版本发布后、长时间未动的项目开工前、技能疑似上游已修复的问题、以及每月定期跟进安全补丁。
限制:仅适用于使用 pnpm 或 npm 的 JavaScript 项目;无 package.json 或未依赖 @iblai/iblai-js 时 SDK 步骤跳过;技能更新依赖网络访问 GitHub 与 npx;具体版本号、变更内容与兼容性以实际发布为准,资料未提供更多细节。