近日，Laravel Boost 发布了 v2.2.0 版本。除了常规的性能优化，本次更新重点解决了长期困扰社区的“指南维护滞后”问题。通过支持从扩展包中直接加载 skills 技能与 guidelines 指南，Boost 正式开启了插件化 AI 支持的新篇章。
🔍 为什么要改？揭秘背后的“三大痛点”
在 v2.2.0 之前，Boost 所有的 AI 指南（如 Livewire, Inertia, Pennant 等）都集中维护在 Boost 自身的 .ai/ 目录中。这种“中心化”模式带来了显而易见的弊端：
- Boost 成为更新瓶颈： 当 Inertia 等框架发布新功能时，必须等待 Boost 团队手动更新对应的指南，原框架团队无法直接介入。
- 指南陈旧过时： 往往扩展包已经迭代到了 v3，但 Boost 里的指南还停留在 v2，导致 AI 生成的代码不兼容。
- 维护难以扩展： 随着 Laravel 生态包的增多，Boost 团队需要维护的文件呈指数级增长，难以为继。
v2.2.0 的核心逻辑转变： 将指南的“维护权”交还给各个扩展包的开发者。
🌟 核心更新：从 Vendor 直接加载
通过引入对扩展包路径的识别，Boost 实现了真正的解耦：
- 规范化路径： 扩展包维护者只需在其包内的 resources/boost/guidelines/ 路径下放置指南，即可被 Boost 实时检测并应用。
- 生态同步： 框架作者在更新代码的同时，就能同步更新 AI 指南，确保 AI 永远懂最新的 API。
🔍 解析加载优先级（Priority Order）
为了平衡“官方默认”与“用户自定义”，Boost 设定了严谨的解析顺序：
| 优先级 | 来源路径 (Source) | 作用 |
|---|---|---|
| 1st | 项目根目录 /.ai/guidelines/ | 最高优先级，用于用户根据项目特定需求覆盖所有默认逻辑。 |
| 2nd | vendor/{pkg}/resources/boost/ | 扩展包原生支持，由包作者维护的最专业、最及时的指南。 |
| 2nd | node_modules/{pkg}/resources/boost | 前端生态支持，适用于通过 NPM 安装的相关资源。 |
| 3rd | Boost 内置的 .ai/ 目录 | 兜底配置，提供基础的系统级 AI 增强。 |
⚠️ 小破坏性变更：Inertia 用户注意
受结构调整影响，Inertia 相关指南已按版本号进行了重新组织：
- 新路径：
.ai/inertia-laravel/{version}/core.blade.php。 - 影响： 如果你之前手动覆盖过 Inertia 的 core.blade.php，请将其移动到对应的版本文件夹（1 或 2）下。
🛠️ 升级三步曲
只需简单的指令，即可完成这一重大机制的切换：
-
更新核心包：
composer update laravel/boost -w -
执行机制更新：
php artisan boost:update -
确认同步：
运行后，Boost 将开始优先从你的 vendor 路径中检索那些已适配的最新指南。
💡 结语
Laravel Boost v2.2.0 不仅仅是一个版本的更迭，它通过路径规范化解决了 Laravel AI 指南维护的生态难题。这对于想要让自己的包更好地支持 AI 编程的开发者来说，是一个重大利好。
快去检查你常用的扩展包是否已经开始支持 resources/boost/ 吧！