> ## 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/agent-skills — Laravel 官方 AI 智能体技能集

> 介绍 Laravel 官方维护的 AI 智能体技能仓库 laravel/agent-skills。以 Claude Code、Cursor 插件形式提供的技能概览、安装方法以及各技能的详细说明。

<Info>
  `laravel/agent-skills` 是一个正在积极开发中的仓库(截至 2026 年 4 月)。当前插件版本为 `1.0.0`,后续内容可能会发生变化和增加。
</Info>

## 什么是 laravel/agent-skills

[laravel/agent-skills](https://github.com/laravel/agent-skills) 是 Laravel 官方维护的、面向 AI 智能体的技能/插件集合仓库。作者一栏登记的是 Taylor Otwell 本人,今后将作为 Laravel 官方的 marketplace 逐步完善。

它最初是作为存放 Claude Code 技能的仓库开始的,后来将仓库名重命名为 `agent-skills`,现在已经能提供同时支持 **Claude Code** 和 **Cursor** 的插件。

在使用 AI 开发 Laravel 应用的场景中,这套技能集能让智能体理解 Laravel 的最佳实践,并可以自主操作 Laravel Cloud、Nightwatch 等官方服务。

```mermaid theme={null}
graph TD
    A["laravel/agent-skills<br>(官方技能仓库)"] --> B["laravel-simplifier<br>Laravel 代码改进智能体"]
    A --> C["laravel-cloud<br>Laravel Cloud 部署技能"]
    A --> D["laravel-nightwatch<br>Nightwatch 配置技能"]
    B --> E["Claude Code<br>.claude-plugin"]
    B --> F["Cursor<br>.cursor-plugin"]
    C --> E
    C --> F
    D --> E
    D --> F
    D --> G["Nightwatch<br>MCP 服务器"]
```

## 仓库结构

仓库按技能(插件)划分目录,每个目录中都包含 Claude Code 用和 Cursor 用的配置文件。

```
laravel/agent-skills/
├── laravel/                      # Laravel 代码改进智能体
│   ├── .claude-plugin/
│   │   └── plugin.json           # Claude Code 插件定义
│   ├── .cursor-plugin/
│   │   └── plugin.json           # Cursor 插件定义
│   └── agents/
│       └── laravel-simplifier.md # 智能体的系统提示词
├── laravel-cloud/                # Laravel Cloud 部署技能
│   ├── .claude-plugin/
│   │   └── plugin.json
│   ├── .cursor-plugin/
│   │   └── plugin.json
│   └── skills/
│       └── deploying-laravel-cloud/
└── laravel-nightwatch/           # Laravel Nightwatch 配置技能
    ├── .claude-plugin/
    │   └── plugin.json
    ├── .cursor-plugin/
    │   └── plugin.json
    ├── .mcp.json                 # Nightwatch MCP 服务器配置
    └── skills/
        └── configure-nightwatch/
```

## 提供的插件

### laravel — 代码质量改进智能体

**laravel-simplifier** 是一个用于审查最近修改过的 PHP/Laravel 代码,并在不改变功能的前提下提升代码清晰度、一致性和可维护性的智能体。它在仓库中位于 `laravel/` 目录下,安装时使用 `laravel-simplifier@laravel` 指定。

主要功能:

* 应用 Laravel 约定和 PSR-12 规范
* 减少不必要的复杂度和嵌套
* 提升变量名、函数名的可读性
* 相关逻辑的整理与合并
* 通过 `match` 表达式让条件分支更清晰

智能体默认只处理"最近修改过的代码"。在编码会话结束后调用它,它会自动识别改动位置并给出重构建议。

```
> Review recent changes using the laravel-simplifier agent
```

### laravel-cloud — 部署与基础设施管理技能

**laravel-cloud** 是一个用于协助将应用部署到 [Laravel Cloud](https://cloud.laravel.com) 并管理资源的技能。它熟知 `cloud` CLI 的命令模式,可以一步步引导你完成部署流程。

主要功能:

* 首次部署、已有应用部署流程的引导
* 数据库、缓存、域名、存储桶等基础设施资源的管理
* 多步骤作业的操作检查清单
* 遵循 Cloud CLI CRUD 命令模式的操作

```
> Deploy my app to Laravel Cloud
> Set up a database and cache for the staging environment
```

### laravel-nightwatch — 监控配置技能

**laravel-nightwatch** 是一个用于协助配置 [Laravel Nightwatch](https://nightwatch.laravel.com) 的数据采集、采样率、过滤规则和脱敏策略的技能。

它还捆绑了 **Nightwatch MCP 服务器**,让 AI 智能体可以直接查阅和操作 Nightwatch 的问题。

| 功能     | 说明                  |
| ------ | ------------------- |
| 安装与配置  | 引导在应用中安装 Nightwatch |
| 采样与过滤  | 通过规则配置控制数据量         |
| PII 脱敏 | 保护敏感数据的脱敏策略         |
| 事件优化   | 面向生产环境的事件采集优化       |
| MCP 集成 | 查看问题、检查堆栈、更新状态、添加评论 |

```
> Configure Nightwatch sampling rates for production
> Set up PII redaction for Nightwatch
```

## 安装方法

### Claude Code

通过 Claude Code 的 marketplace 功能进行安装。

```bash theme={null}
# 添加 marketplace
/plugin marketplace add laravel/agent-skills

# 安装各个插件
/plugin install laravel-simplifier@laravel
/plugin install laravel-cloud@laravel
/plugin install laravel-nightwatch@laravel
```

<Tip>
  你可以只安装所需的插件,并不需要全部装上。
</Tip>

### Cursor

Cursor 的情况下,在插件 marketplace 面板中搜索 **Laravel** 并安装。

<Steps>
  <Step title="打开 Cursor">
    通过 Cursor 的侧边栏或设置打开 “Plugins” 面板。
  </Step>

  <Step title="搜索 Laravel">
    在搜索栏中输入 “**Laravel**”。
  </Step>

  <Step title="安装需要的插件">
    从 `laravel`、`laravel-cloud`、`laravel-nightwatch` 中选择需要的进行安装。
  </Step>
</Steps>

## 使用示例

### 用 laravel-simplifier 自动化代码审查

在编码会话结束时调用它,可以让你写的代码自动按照 Laravel 最佳实践进行打磨。

```
> Review recent changes using the laravel-simplifier agent
```

智能体会自主运行,识别出修改过的文件并提出改进建议。除非你明确指示,否则它只会针对最近修改的代码进行处理。

### 部署到 Laravel Cloud

你可以用自然语言指示部署工作,智能体会将 `cloud` CLI 的命令合理组合起来执行。

```
> Deploy my app to Laravel Cloud
> Set up a database and cache for the staging environment
> Add a custom domain to my production environment
```

### 用 Nightwatch 排查问题

由于集成了 Nightwatch 的 MCP 服务器,你可以直接让 AI 帮忙排查问题。

```
> Show me the latest errors in Nightwatch
> What's the stack trace for issue #42?
> Mark issue #42 as resolved
```

## 插件的工作机制

每个插件通过 `.claude-plugin/plugin.json` 或 `.cursor-plugin/plugin.json` 定义。智能体定义(`.md` 文件)中写有系统提示词,详细规定了 AI 应如何行动。

laravel-simplifier 的提示词片段:

```
You are an expert PHP/Laravel code simplification specialist focused on 
enhancing code clarity, consistency, and maintainability while preserving 
exact functionality...
```

技能通过上下文文件(Markdown 文档)的形式,为 AI 提供额外知识。例如 laravel-cloud 的技能中详细写有 Cloud CLI 的操作步骤和注意事项,引导 AI 不至于在部署时误操作。

## 未来展望

`laravel/agent-skills` 仓库将逐步完善为 **覆盖整个 Laravel 生态的官方 AI 技能 marketplace**。

目前提供了 Laravel、Laravel Cloud、Laravel Nightwatch 这 3 个插件,未来预计会有以下扩展:

* 支持其他 Laravel 官方包(Forge、Vapour、Cashier、Sanctum 等)
* 支持 Claude Code、Cursor 之外的 AI 工具(如 GitHub Copilot)
* 由社区贡献第三方技能(marketplace 化)

在 AI 开发正逐渐成为标准工作流的当下,Laravel 团队官方提供并维护 AI 技能,将为整个生态的质量提升做出重大贡献。

<Card title="laravel/agent-skills 仓库" icon="github" href="https://github.com/laravel/agent-skills">
  技能的详情和安装步骤请参考官方仓库的 README。
</Card>

<Card title="Laravel Cloud" icon="cloud" href="https://cloud.laravel.com">
  与 laravel-cloud 技能联动的 Laravel 官方托管服务。
</Card>

<Card title="Laravel Nightwatch" icon="eye" href="https://nightwatch.laravel.com">
  与 laravel-nightwatch 技能联动的 Laravel 官方错误监控服务。
</Card>


## Related topics

- [Laravel Agent Detector — AI 智能体检测包](/zh/blog/agent-detector-introduction.md)
- [Laravel Package Skeleton — 官方包开发用启动模板](/zh/blog/package-skeleton-introduction.md)
- [Laravel PAO — 面向 AI 智能体的输出优化工具](/zh/blog/pao-introduction.md)
- [Laravel AI SDK](/zh/ai-sdk.md)
- [Skills](/zh/packages/laravel-copilot-sdk/skills.md)