# AI 辅助开发

 - [简介](#introduction)
     - [为什么选择 Laravel 进行 AI 开发？](#why-laravel-for-ai-development)
 - [Laravel Boost](#laravel-boost)
     - [安装](#installation)
     - [可用工具](#available-tools)
     - [AI 开发指南](#ai-guidelines)
     - [Agent 技能](#agent-skills)
     - [文档搜索](#documentation-search)
     - [Agents 集成](#agents-integration)

<a name="introduction"></a>
## 简介

Laravel 以其独特的优势成为 AI 辅助开发和 Agent 驱动开发的最佳框架选择。随着像 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[OpenCode](https://opencode.ai)、[Cursor](https://cursor.com) 和 [GitHub Copilot](https://github.com/features/copilot) 这样的 AI Agent 的崛起，开发者的编码方式正在发生革命性转变。这些工具能以前所未有的速度生成完整功能、调试复杂问题和重构代码——但它们的有效性很大程度上取决于其对代码库的理解程度。

<a name="why-laravel-for-ai-development"></a>

### 为什么选择 Laravel 进行 AI 开发？

Laravel 约定俗成的惯例和定义良好的结构使其成为 AI 辅助开发的理想框架。当你要求 AI Agent 添加控制器时，它能准确知道应该放在哪里；当你需要创建新的迁移文件时，命名约定和文件位置都是可预测的。这种一致性消除了 AI 工具在更灵活的框架中常常遇到的困惑和猜测。

除了文件组织外，Laravel 富有表现力的语法和全面的文档为 AI Agent 提供了所需的上下文，使其能够生成准确、符合语言习惯的代码。Eloquent 关联、表单请求和中间件等特性都遵循着明确的模式，AI Agent 可以可靠地理解和复现这些模式。最终生成的结果代码看起来就像是由经验丰富的 Laravel 开发者编写，而非由通用 PHP 代码片段拼凑而成。



<a name="laravel-boost"></a>
## Laravel Boost

[Laravel Boost](https://github.com/laravel/boost) 是连接 AI Agent 与 Laravel 应用的桥梁。Boost 是一个搭载了 15+ 种专业工具的 MCP（模型上下文协议）服务器，能够帮助 AI Agent 深度理解你的应用结构、数据库、路由等信息。安装 Boost 后，你的 AI Agent 将从通用代码助手蜕变为精通 Laravel 且了解您特定应用的专家。

Boost 提供三大核心能力：一套用于检查并交互应用的 MCP 工具集、专为 Laravel 生态系统打造的可组合 AI 指南、以及包含 17,000+ 条 Laravel 专属知识的强大文档 API。


<a name="installation"></a>
### 安装

Boost 可以安装在运行 PHP 8.1 或更高版本的 Laravel 10、11、12 和 13 应用程序中。请通过以下命令安装开发依赖：

```shell
composer require laravel/boost --dev
```

安装完成后，运行交互式安装程序：

```shell
php artisan boost:install
```

安装程序会自动检测你的 IDE 和 AI Agent，允许选择适合项目的集成方案。Boost 将生成必要的配置文件，如适用于 MCP 兼容编辑器的 `.mcp.json` 以及 AI 上下文指南文件。

> [!NOTE]
> 生成的配置文件（如 `.mcp.json`、`CLAUDE.md` 和 `boost.json`）可安全加入 `.gitignore`，以便每位开发者单独配置自己的环境。

<a name="available-tools"></a>
### 可用工具

Boost 通过模型上下文协议向 AI Agent 提供全面的工具集，这些工具能帮助 Agent 深度理解并交互你的 Laravel 应用：

<div class="content-list" markdown="1">

-   **应用自检** - 查询 PHP 和 Laravel 版本，列出已安装扩展包，检查应用配置和环境变量。
-   **数据库工具** - 查看数据库结构，执行只读查询，无需离开对话即可理解数据结构。
-   **路由检查** - 列出所有注册路由及其中间件、控制器和参数信息。
-   **Artisan 命令** - 发现可用 Artisan 命令及其参数，使 Agent 能针对任务推荐并执行正确命令。
-   **日志分析** - 读取并分析应用日志文件以协助调试问题。
-   **浏览器日志** - 在使用 Laravel 前端工具开发时访问浏览器控制台日志和错误。
-   **Tinker 集成** - 通过 Laravel Tinker 在应用上下文中执行 PHP 代码，允许 Agent 验证假设和测试行为。
-   **文档搜索** - 基于已安装扩展包版本获取定制化的 Laravel 生态文档搜索结果。

</div>



<a name="ai-guidelines"></a>

### AI 开发指南

Boost 提供了一套专为 Laravel 生态精心设计的 AI 开发指南体系。这些指南会教导 AI Agent 如何编写符合 Laravel 风格的代码、遵循框架规范并规避常见陷阱。指南采用可组合设计且具备版本感知能力，确保 Agent 获取的指导完全适配你当前使用的扩展包版本。

指南支持范围包含 Laravel 核心框架及 16+ 个生态扩展包，主要涵盖：

<div class="content-list" markdown="1">

-   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 代码风格工具
-   以及其他主流扩展包

</div>

运行 `boost:install` 时，Boost 会自动检测项目依赖的扩展包，并将相关指南整合到项目的 AI 上下文文件中。

<a name="agent-skills"></a>
### Agent 技能

[Agent 技能](https://agentskills.io/home)是轻量级的专业领域知识模块，Agent 可在处理特定任务时按需激活。与预先加载的指南不同，技能机制允许仅在相关场景下加载详细模式与最佳实践，既能避免上下文冗余，又能提升 AI 生成代码的相关性。

目前提供 Livewire、Inertia、Tailwind CSS、Pest 等主流 Laravel 扩展包的专属技能模块。当你运行 `boost:install` 并选择启用技能功能时，系统会根据 `composer.json` 检测结果自动安装匹配的技能包。

<a name="documentation-search"></a>
### 文档智能检索

Boost 集成强大的文档 API，为 AI Agent 提供 17,000+ 条 Laravel 生态文档的精准访问能力。与常规网络搜索不同，这些文档经过深度索引、向量化处理，并能根据实际使用的扩展包版本进行智能过滤。

当 AI Agen t需要了解特定功能实现时，可通过查询 Boost 文档 API 获取精准的版本适配信息，从而彻底解决推荐废弃方法或旧版框架语法的常见问题。

<a name="agent-integration"></a>

### Agents 集成

Boost 可与支持模型上下文协议的各主流 IDE 和 AI 工具无缝集成。针对 Cursor、Claude Code、Codex、Gemini CLI、GitHub Copilot 和 Junie 的具体配置指南，详见 Boost 文档中的[设置你的 AI Agents](/docs/laravel/13.x/boost#set-up-your-agents) 章节。
<a name="agent-integration"></a>