> ## 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 Agent 技能集

> 介紹 Laravel 官方維護的 AI Agent 技能儲存庫「laravel/agent-skills」。解說作為 Claude Code、Cursor 外掛提供的技能概觀、安裝方式與各技能細節。

<Info>
  `laravel/agent-skills` 是持續開發中的儲存庫（2026 年 4 月時點）。目前 plugin 版本為 `1.0.0`，預期後續會有內容變更與新增。
</Info>

## 什麼是 laravel/agent-skills

[laravel/agent-skills](https://github.com/laravel/agent-skills) 是 Laravel 官方維護的 AI Agent 技能／外掛集合儲存庫。Taylor Otwell 本人以作者身分登記，並預計整備為 Laravel 官方的 marketplace。

原本是作為 Claude Code 用技能儲存庫起步，後來更名為 `agent-skills`，並提供同時支援 **Claude Code** 與 **Cursor** 的外掛。

在利用 AI 開發 Laravel 應用的場景，這是讓 Agent 理解 Laravel 最佳實踐，並能自主操作 Laravel Cloud、Nightwatch 等官方服務的技能集。

```mermaid theme={null}
graph TD
    A["laravel/agent-skills<br>（官方技能儲存庫）"] --> B["laravel-simplifier<br>Laravel 程式碼改善 Agent"]
    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 程式碼改善 Agent
│   ├── .claude-plugin/
│   │   └── plugin.json           # Claude Code plugin 定義
│   ├── .cursor-plugin/
│   │   └── plugin.json           # Cursor plugin 定義
│   └── agents/
│       └── laravel-simplifier.md # Agent 的系統提示
├── 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 — 程式碼品質改善 Agent

**laravel-simplifier** 會審視最近變更的 PHP/Laravel 程式碼，在不改變功能的前提下提升程式碼的明確度、一致性與可維護性。它位於儲存庫的 `laravel/` 目錄內，安裝時使用 `laravel-simplifier@laravel` 指定。

主要功能：

* 套用 Laravel 慣例與 PSR-12 標準
* 減少不必要的複雜度與巢狀
* 提升變數與函式命名的可讀性
* 整理與整合相關邏輯
* 透過 `match` 運算式使條件判斷更清晰

Agent 預設只針對「最近變更的程式碼」。程式撰寫工作結束後呼叫它，它會自動找出變更處並提出重構建議。

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

### laravel-cloud — 部署與基礎設施管理技能

**laravel-cloud** 是支援部署至 [Laravel Cloud](https://cloud.laravel.com) 與資源管理的技能。它熟悉 `cloud` CLI 的指令模式，會逐步引導完成部署。

主要功能：

* 引導初次部署與現有應用的部署工作流程
* 管理資料庫、快取、網域、bucket 等基礎資源
* 為多步驟作業提供操作檢查清單
* 依 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 Agent 可直接參照與操作 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，可在 plugin 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
```

Agent 會自主運作，鎖定變更檔案並提出改善建議。除非明確指示，否則只以最近變更的程式碼為對象。

### 部署到 Laravel Cloud

可用自然語言下達部署指令。Agent 會適當地組合 `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` 中定義。Agent 定義（`.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...
```

技能會以 context 檔案（Markdown 文件）的形式提供 AI 額外知識。例如 laravel-cloud 的技能包含 Cloud CLI 的操作步驟與注意事項，避免 AI 誤執行部署。

## 未來展望

`laravel/agent-skills` 儲存庫預計成為**涵蓋整個 Laravel 生態系的 AI 技能官方 Marketplace**。

目前提供 Laravel、Laravel Cloud、Laravel Nightwatch 三個外掛，未來可期待以下擴充：

* 支援其他 Laravel 官方套件（Forge、Vapor、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 Agent 偵測套件](/zh-TW/blog/agent-detector-introduction.md)
- [Laravel AI Agent 支援 MCP 伺服器](/zh-TW/blog/ai-sdk-mcp-client.md)
- [Laravel PAO — 針對 AI Agent 的輸出最佳化工具](/zh-TW/blog/pao-introduction.md)
- [AI Agent 從「正確」的程式碼邁向「有 Laravel 風格」的程式碼 - Boost Benchmarks 的下一步](/zh-TW/blog/boost-benchmarks-idiomatic-laravel.md)
- [部落格](/zh-TW/blog/index.md)