> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Laravel 與 AI 開發

> Laravel 是最適合 AI 輔助開發的框架。透過 Laravel Boost 的 MCP 伺服器整合、AI 指引、文件搜尋 API，發揮 AI 編碼 Agent 的最大能力。

## 為什麼 Laravel 適合 AI 開發

[Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Cursor](https://cursor.com)、[GitHub Copilot](https://github.com/features/copilot) 等 AI 編碼 Agent 能戲劇性地加速程式碼生成、除錯、重構。但要讓 Agent 發揮最大能力，需要 Agent 能精確理解程式碼庫。

Laravel 在這方面優於其他框架。因為基於慣例的設計，當請求「加入 Controller」時，Agent 已知放置位置；當請求「建立 Migration」時，也能預測命名慣例與檔案位置。這種一致性消除了會讓 AI 工具困惑的「模糊性」。

Eloquent 的關聯、Form Request、Middleware 等功能遵循 Agent 能確實理解並重現的模式。因此生成的程式碼不是通用 PHP 片段的拼湊，而是像熟練 Laravel 開發者所寫的慣用程式碼。

## Laravel Boost

[Laravel Boost](https://github.com/laravel/boost) 是連接 AI 編碼 Agent 與 Laravel 應用程式的套件。Boost 作為 **MCP（Model Context Protocol）伺服器**運作，透過 15 個以上的專用工具讓 Agent 深入理解應用程式的結構、資料庫、路由等。

Boost 提供的主要功能有 3 項。

<Columns>
  <Card title="MCP 工具群" icon="wrench">
    可用於檢查、操作應用程式的 15 個以上工具。從資料庫 schema 確認到 Artisan 指令執行皆對應。
  </Card>

  <Card title="AI 指引" icon="book-open">
    專為 Laravel 生態系設計的 AI 指引。將寫出慣用程式碼的最佳實踐傳達給 Agent。
  </Card>

  <Card title="文件搜尋 API" icon="magnifying-glass">
    搜尋 17,000 件以上的 Laravel 專屬文件。提供符合已安裝套件版本的精確資訊。
  </Card>
</Columns>

### 安裝

Boost 於 Laravel 10、11、12、13、PHP 8.1 以上運作。先作為開發相依加入。

<Steps>
  <Step title="安裝套件">
    ```shell theme={null}
    composer require laravel/boost --dev
    ```
  </Step>

  <Step title="執行互動式安裝器">
    ```shell theme={null}
    php artisan boost:install
    ```

    安裝器會自動偵測 IDE 與 AI Agent。選擇要使用的整合後，會產生 MCP 伺服器用的 `.mcp.json` 或指引檔等所需的設定檔。
  </Step>
</Steps>

<Info>
  `.mcp.json`、`CLAUDE.md`、`boost.json` 等產生的檔案，若希望依開發者個別設定環境，加入 `.gitignore` 也無妨。
</Info>

### 可用的 MCP 工具

Boost 對 Agent 公開的工具包含下列。

| 工具         | 說明                                        |
| ---------- | ----------------------------------------- |
| 應用程式檢查     | 確認 PHP 與 Laravel 版本、已安裝套件、設定、環境變數         |
| 資料庫工具      | 確認 schema、執行唯讀查詢、掌握資料結構                   |
| 路由檢查       | 列示包含中介層、Controller、參數的所有已註冊路由             |
| Artisan 指令 | 探索可用的 Artisan 指令與引數。Agent 提出建議並執行合適的指令    |
| 日誌解析       | 讀取並解析應用程式日誌檔以協助除錯                         |
| 瀏覽器日誌      | 於使用 Laravel 前端工具時存取瀏覽器 Console 日誌與錯誤      |
| Tinker 整合  | 透過 Laravel Tinker 於應用程式情境內執行 PHP 程式碼以驗證行為 |
| 文件搜尋       | 搜尋對應已安裝套件版本的 Laravel 生態系文件                |

### AI 指引

Boost 的 AI 指引是為 Laravel 生態系設計的編碼慣例集。將撰寫慣用 Laravel 程式碼的方式、框架慣例、避免常見陷阱的方法傳達給 Agent。指引會依已安裝套件版本自動組合。

對應套件範例：

* Livewire（2.x、3.x、4.x）
* Inertia.js（React、Svelte、Vue 版本）
* Tailwind CSS（3.x、4.x）
* Filament（3.x、4.x）
* PHPUnit、Pest PHP、Laravel Pint 等

執行 `boost:install` 後會依 `composer.json` 自動偵測使用中的套件，並將相關指引納入 AI 情境檔。

### Agent Skills

[Agent Skills](https://agentskills.io/home) 是 Agent 於必要時按需載入的輕量知識模組。與 Guideline 不同，並非從頭載入全部，而是僅於在特定領域作業時啟用相關 Skill。可避免情境肥大化，提升生成程式碼的精度。

已備有 Livewire、Inertia、Tailwind CSS、Pest 等熱門套件用的 Skill。於 `boost:install` 選擇 Skill 功能後，會依 `composer.json` 內容自動安裝。

### 文件搜尋 API

Boost 的文件 API 讓 Agent 可搜尋 17,000 件以上的 Laravel 生態系文件。與一般網頁搜尋不同，會依已安裝套件版本進行索引化及向量化。

當 Agent 想調查某功能的行為時，可透過此 API 取得版本專屬的精確資訊。可解決 Agent 建議舊框架版本 deprecated 方法或語法的問題。

### 對應 Agent

Boost 對應支援 Model Context Protocol 的主要 IDE 與 AI 工具。

<Columns>
  <Card title="Cursor" icon="arrow-pointer" href="https://cursor.com" />

  <Card title="Claude Code" icon="terminal" href="https://docs.anthropic.com/en/docs/claude-code" />

  <Card title="GitHub Copilot" icon="github" href="https://github.com/features/copilot" />

  <Card title="Gemini CLI" icon="arrow-right" href="https://github.com/google-gemini/gemini-cli" />

  <Card title="Codex" icon="arrow-right" href="https://openai.com/codex" />

  <Card title="Junie" icon="arrow-right" href="https://www.jetbrains.com/junie/" />
</Columns>

各 Agent 的詳細設定步驟請參考 [Boost 文件的「Set Up Your Agents」段落](https://laravel.com/docs/boost#set-up-your-agents)。

## 下一步

<Card title="Laravel Boost 官方文件" icon="book-open-cover" href="https://laravel.com/docs/boost">
  各 Agent 的詳細整合方式、MCP 工具參考、指引的自訂請參考官方文件。
</Card>


## Related topics

- [Laravel AI SDK](/zh-TW/ai-sdk.md)
- [Laravel MCP](/zh-TW/mcp.md)
- [Laravel Boost](/zh-TW/boost.md)
- [Laravel 套件開發](/zh-TW/advanced/package-development.md)
- [Queue 與 Job](/zh-TW/queues.md)