WordPress Agent Skills 是 WordPress 官方整理的一套 AI coding assistant 指令包，目標很直接：讓 Codex、Claude Code、Cursor、GitHub Copilot 這類 AI 開發工具，在寫 WordPress 外掛、區塊、REST API、佈景主題或 WP-CLI 自動化時，不要一直犯 WordPress 常見錯誤。
如果你之前已經開始用 Claude Code 管 WordPress 專案，或看過我整理的 WordPress 7.0 AI 重點，這個 repo 會讓你更有感。它不是一個 WordPress 外掛，也不是後台聊天機器人，而是把 WordPress 專家的開發規範、檢查清單與腳本，包成 AI agent 看得懂的 skills。
WordPress Agent Skills 是什麼？
官方 repo 是 WordPress/agent-skills，README 的定位是「Teach AI coding assistants how to build WordPress the right way」。簡單講，就是把 AI 工具最容易忘記的 WordPress 知識補上。
- 寫 block 時要正確處理
block.json、attributes、deprecations。 - 寫外掛時要遵守 hooks、settings API、安全檢查與目錄規範。
- 寫 REST API 時要有 schema、權限檢查與正確 response 結構。
- 做效能優化時要會看 caching、database、Server-Timing。
- 使用 WordPress Playground 時，可以讓 agent 建測試環境並驗證結果。
它最重要的價值不是「讓 AI 變聰明」，而是讓 AI 在進入 WordPress 專案前，先讀一份可重複使用的工作手冊。
它解決 AI 寫 WordPress 的哪些痛點？
| 常見問題 | Agent Skills 的幫助 |
|---|---|
| AI 寫出過時的 pre-Gutenberg 寫法 | 用 block / theme skills 引導現代 WordPress 架構 |
| 外掛少做 nonce、capability、sanitize、escape | 用 plugin development skill 強化安全檢查 |
| 更新 block 後出現 Invalid block | 用 block deprecations 流程處理向後相容 |
| AI 不知道專案怎麼跑測試 | 用 project triage 與 playground skill 偵測環境 |
| 每次都要重新解釋開發規範 | 把規範裝到 repo 或全域設定，讓 agent 自己讀 |
有哪些 Skills 可以用？
截至我查閱時，repo 裡已經有一批很實用的 WordPress skills。比較值得先認識的是這幾個：
wordpress-router：先判斷這是外掛、區塊、theme、REST API 還是 ops 任務，再路由到對的 skill。wp-project-triage：自動偵測專案類型、工具鏈、WordPress / PHP 版本。wp-block-development：Gutenberg block 開發，包含block.json、attributes、render、deprecations。wp-plugin-development：外掛架構、hooks、settings API、安全與封裝。wp-rest-api：REST routes、endpoint schema、authentication、response shaping。wp-playground：用 WordPress Playground 建可重複測試環境。wp-performance：效能 profiling、cache、資料庫、Server-Timing。wp-wpcli-and-ops：WP-CLI、自動化、multisite、search-replace。
我的建議是不要一開始全裝。小型外掛專案可以先裝 wordpress-router、wp-project-triage、wp-plugin-development、wp-rest-api、wp-playground。如果你在做區塊或 block theme，再補 wp-block-development 和 wp-block-themes。
安裝方式一：用 skills.sh 快速加入
WordPress.com 的 Agent Skills 文件提供了比較直覺的安裝方式：用 npx skills add 把技能加到你的 AI agent 環境。你需要先有 Node.js，然後可以先列出可用 skills：
npx skills add https://github.com/WordPress/agent-skills --list如果你使用 Claude Code，可以先裝一組 WordPress 外掛開發常用 skills：
npx skills add https://github.com/WordPress/agent-skills \
--agent claude-code \
--skill wordpress-router \
--skill wp-project-triage \
--skill wp-plugin-development \
--skill wp-rest-api \
--skill wp-playground如果你用 Cursor、Codex 或其他支援 agent skills / project instructions 的工具，概念一樣：把 --agent 換成你使用的 agent，或改用下一段的手動 repo 安裝方式。安裝時你可以選全域或專案層級；團隊專案建議放專案層級，讓每個人使用同一套規範。
安裝方式二：從 GitHub repo 建置到 Codex、Claude、Cursor
如果你想完整控制安裝內容，可以 clone 官方 repo，先 build distribution，再安裝到你的 WordPress 專案。這個方式適合想要同時支援 Codex、VS Code / Copilot、Claude Code、Cursor 的團隊。
git clone https://github.com/WordPress/agent-skills.git
cd agent-skills
node shared/scripts/skillpack-build.mjs --clean
node shared/scripts/skillpack-install.mjs \
--dest=../your-wp-project \
--targets=codex,vscode,claude,cursor依官方 README，安裝後會複製到不同工具的專案目錄，例如 Codex 的 .codex/skills/、VS Code / Copilot 的 .github/skills/、Claude Code 的 .claude/skills/、Cursor 的 .cursor/skills/。
安裝後怎麼用？給 AI 的提示詞範例
Agent Skills 裝好後，不需要每次貼一大段規範。你可以直接要求 AI 先依 repo skills 做 triage，再開始工作。
請先讀取這個專案可用的 WordPress agent skills。
第一步只做 triage：
- 判斷這是 plugin、block、theme 還是 ops 任務
- 找出啟動、測試、build 指令
- 列出你會使用哪些 skills
先不要修改任何檔案。如果要讓 AI 寫外掛功能，可以這樣下：
請使用 wp-plugin-development 與 wp-rest-api skill。
幫我新增一個 REST endpoint：
- 只允許 manage_options 使用者呼叫
- 所有輸入要 sanitize
- 所有輸出要 escape 或用 schema 定義
- 寫完後用 wp-playground 或現有測試流程驗證如果你用的是 Codex on Windows，可以把 skills 放進專案，讓 Codex 在改 WordPress 專案時自動讀到這些指令。這比每次在對話裡重講「請注意 nonce、capability、sanitize」穩很多。
延伸觀看：WordPress Abilities 與 AI Agent
下面這支影片不是 WordPress/agent-skills repo 的官方安裝教學，但它示範了 AI agent 如何在 WordPress 站內建立可重複使用的 abilities。放在這裡是因為它剛好能補上「skills 是給 coding agent 的工作知識，abilities 是讓 WordPress 站點能力可被 agent 發現與呼叫」這個差別。
使用前要注意的事
- 技能不是權限系統：它會引導 agent，但不能取代 Git review、測試與人工審核。
- 不要盲目全域安裝：團隊專案最好先 code review skills 內容，再決定要放全域或 repo。
- 要定期更新：WordPress.com 文件建議把 skills 當成 versioned assets，更新前看 diff。
- 先小任務測試：第一次用時，先讓 AI 做 triage 或修小 bug，不要直接交付大型重構。
- 搭配 Playground 更穩：能讓 agent 實際啟動 WordPress 驗證，比只看程式碼猜結果可靠。
結論：這是 WordPress AI 開發工作流的標準化起點
WordPress Agent Skills 最酷的地方，是它沒有假裝 AI coding agent 自然就懂 WordPress。相反，它承認 WordPress 有自己的歷史、規範、安全細節與相容性包袱，然後把這些知識整理成 AI 可重複讀取的技能包。
如果你現在已經在用 Codex、Claude Code、Cursor 寫 WordPress，這個 repo 很值得裝進常用專案。它不會讓 AI 百分之百不犯錯，但會大幅減少那些「看起來能跑、其實不 WordPress」的產物。對外掛開發、REST API、Gutenberg block、Playground 測試與效能優化來說，這會是接下來 WordPress AI 開發工作流的基本配備。
常見問題 FAQ
WordPress Agent Skills 是 WordPress 外掛嗎？
不是。它是一組給 AI coding assistant 讀取的技能檔與輔助腳本，會放在 Codex、Claude、Cursor、VS Code 等工具可讀取的位置，不是安裝到 WordPress 後台的外掛。
Codex 可以使用 WordPress Agent Skills 嗎？
可以。官方 repo 的 build/install 流程支援把 skills 複製到 .codex/skills/，適合放在 WordPress 專案裡，讓 Codex 修改外掛、區塊或 REST API 前先讀取 WordPress 規範。
我需要一次安裝全部 skills 嗎？
不一定。一般外掛專案可先安裝 wordpress-router、wp-project-triage、wp-plugin-development、wp-rest-api、wp-playground。只有在做區塊、block theme、效能或 WP-CLI 任務時，再加對應 skills。
Agent Skills 會讓 AI 自動變安全嗎？
不會自動保證安全，但會把 nonce、capability、sanitize、escape、REST schema、測試流程等檢查項目放進 agent 的工作流程。實務上仍然需要 Git diff review、測試與人工審核。
WordPress Agent Skills 和 WordPress 7.0 AI 有關嗎？
兩者不是同一個東西，但方向相近。Agent Skills 是給 coding agent 的開發知識包；WordPress 7.0 的 AI Client、Connectors、Abilities API 則是 WordPress 站點與 AI 功能的底層基礎。
