Laravel Boost 是什麼？如何客製 AI 指引、Skills 與 MCP 開發流程

Laravel Boost 是 Laravel 官方提供、用來改善 AI 輔助開發品質的開發期工具。它把專案與 Laravel 生態系的脈絡提供給 AI 程式代理，包含 MCP 工具、AI Guidelines、Agent Skills 與文件搜尋。它不是讓 AI 自動接管正式環境的工具；價值在於讓代理在清楚的規範、可檢查的權限與可驗證的測試下，產生更貼近專案慣例的程式碼。

Laravel Boost 提供哪幾種能力？

Boost 會在開發環境中協助 AI 程式代理理解目前的 Laravel 專案。官方文件將主要能力分為三部分：

• MCP Server：代理可取得應用程式資訊、路由、文件、錯誤與日誌等脈絡；部分工具也能查詢資料庫或在應用程式環境執行程式。
• AI Guidelines：在代理工作階段一開始載入的可組合指引，用於提供 Laravel 慣例、套件版本與跨任務都適用的規則。
• Agent Skills：在特定任務才載入的知識模組，例如 Livewire、Inertia、Pest 或 Tailwind CSS；它比把所有細節塞進前置提示更能減少無關脈絡。

這些能力的共同目標是降低 AI 猜測專案結構或使用過時 API 的機率，而不是取代程式碼審查、測試或開發者責任。

什麼該寫成 Guidelines，什麼該做成 Skills？

一個簡單判斷是：如果規則對大多數任務都成立，而且代理每次開始工作都需要知道，就放在 Guidelines；如果規則只在特定領域或流程才有用，就做成 Skills。

• 適合 Guidelines：命名規範、授權邊界、不可直接修改的核心模組、測試與格式化要求、專案共用的架構決策。
• 適合 Skills：開立發票、匯入資料、處理特定整合、建立 Livewire 元件，或需要按步驟執行的領域流程。

Laravel Boost 支援在 .ai/guidelines 放入自訂的 Markdown 或 Blade 指引檔；自訂 Skill 則以 .ai/skills/{skill-name}/SKILL.md 的形式加入。兩者都應短、具體、可驗證，優先寫下代理無法只靠閱讀既有程式碼得知的決策。

客製化前先做三個安全檢查

1. 確認代理可用的 MCP 工具：官方列出的工具可讀取應用程式資訊、日誌、資料庫 schema，部分情況可執行資料庫查詢或程式。安裝後應檢查實際代理設定與權限，不要把不受信任的代理直接連到含有敏感資料的環境。
2. 區分本機、測試與正式環境：除錯與資料查詢應以隔離的開發或測試資料為預設。若真的需要存取較敏感的環境，應採最小權限、去識別化資料、明確審核與可追蹤紀錄。
3. 保留人類驗收：即使代理能讀取文件、跑 Tinker 或協助生成測試，合併前仍要檢查 diff、跑相關測試、審核資料庫操作與部署影響。

如何避免自訂規則反而讓代理變差？

先以小範圍補上真實痛點，例如「付款狀態只能由既定服務更新」或「每個後台資料修改都要寫 Pest 測試」。如果把所有團隊知識都寫成很長的前置規則，代理反而可能忽略關鍵資訊。對於重複出現、範圍明確的任務，將細節移到按需載入的 Skill 通常更合適。

Boost 允許以相同檔案路徑覆寫內建 Guidelines，也允許以相同名稱覆寫內建 Skills。這表示覆寫是明確的維護責任：每次 Boost 更新後，應重新檢查自訂版本是否仍符合目前框架與套件版本，而不是假設舊規則永遠正確。

一個可維護的導入流程

1. 先以開發依賴安裝 Boost，並用官方安裝流程選擇真正會使用的代理整合。
2. 審閱產生的 MCP 與指引設定，確認哪些檔案由團隊共用、哪些只屬於個人本機環境。
3. 先採用官方提供的 Guidelines 與 Skills，再根據實際錯誤新增少量自訂規則。
4. 為高風險操作建立測試、權限與人工審核門檻；不要把資料庫寫入或部署交給未受控的自動流程。
5. 升級 Boost、Laravel 或核心套件後，重新執行相關測試並檢視自訂指引與 Skills。

常見問題

Laravel Boost 是網站的 AI 功能嗎？

不是。它主要服務開發者與 AI 程式代理，目的是讓代理在寫 Laravel 程式碼時取得正確的專案與文件脈絡；它不會自動替你的網站新增面向訪客的 AI 功能。

可否只使用自訂規則，不使用官方內容？

可以覆寫，但通常應先保留官方且與版本相符的基礎規範，再針對確有需要的部分做最小客製化。完全覆寫前應清楚知道自己要承擔哪些更新與相容性維護工作。

啟用 MCP 後，代理就能安全地做所有操作嗎？

不能。MCP 只提供能力介面；安全仍取決於代理設定、憑證、環境隔離、工具權限與人工審核。能執行的操作越多，越需要清楚的範圍與日誌。

結論：把 Boost 當成可治理的開發脈絡層

Laravel Boost 最適合用來讓 AI 程式代理更了解你的專案，而不是取代工程治理。用 Guidelines 固定跨任務規則、用 Skills 承載專門流程、用 MCP 取得必要而受控的脈絡，並持續以測試與人工審查驗收，才能讓客製化真正提升開發品質。

參考資料與延伸閱讀

• Laravel：Laravel Boost 官方文件
• Laravel：AI Assisted Development
• Laravel：Announcing Laravel Boost
• Laravel Boost 官方 GitHub 專案
• 站內延伸閱讀：AI 與 LLM 分類文章