用途:在当前项目中把 ibl.ai 工具链升级到最新版本,包含两部分:项目 package.json 中的 @iblai/iblai-js SDK,以及 vibe 技能包(重新执行 npx skills add iblai/vibe)。适用于被要求“upgrade iblai”“get the latest SDK”“update ibl.ai”或“refresh the skills”时。
主要能力与用法:
- 检测当前 SDK 版本,读取 package.json 中 dependencies['@iblai/iblai-js']。
- 升级 SDK:若当前目录存在 package.json 且该依赖存在,则优先执行 pnpm update @iblai/iblai-js@latest,否则回退到 npm install @iblai/iblai-js@latest;随后输出旧版本到新版本的变化。
- 升级后做类型检查:pnpm typecheck 或 npx tsc --noEmit;若出现新错误需反馈给用户,可能意味着 SDK 有破坏性变更,可参考 CHANGELOG 的迁移说明。
- 刷新技能:执行 npx skills add iblai/vibe --all,以非交互方式刷新技能包内全部技能。
- 展示更新内容:从 vibe 的 CHANGELOG 拉取最近条目,按主题归纳为 3-7 条要点,聚焦面向用户的变化,跳过内部重构。
建议运行时机:ibl.ai 发布新版本后;开始处理久未接触的项目前;某个技能出现疑似上游已修复的问题时;以及每月定期运行以跟进安全补丁。
限制与注意:若当前目录没有 package.json,或 @iblai/iblai-js 不是依赖项,则跳过 SDK 升级步骤,并在总结中明确说明被跳过的步骤。类型检查失败时不应静默忽略,需向用户提示可能的破坏性变更。
参考:SDK 包 https://www.npmjs.com/package/@iblai/iblai-js ;vibe 技能 https://github.com/iblai/vibe 。