wordpress-router

wordpress-router 技能概覽

wordpress-router 是一個 WordPress 分流技能，幫助代理在動手修改前快速判斷 repo 類型，並選對後續工作流程。當使用者需求很寬泛，或程式碼庫可能是 plugin、classic theme、block theme、Gutenberg package、WordPress core checkout，或完整 site repo 時，它特別有用。

這個 wordpress-router 技能的用途

wordpress-router 技能是用來分流，不是直接編輯。它的任務是先降低前期猜測成本，辨識 repo 類型、可用工具鏈、可能的測試方式，以及下一步最相關的 domain skill。

哪些情況應該安裝它

如果你經常處理 WordPress codebase，並且需要代理判斷一個 repo 應該視為 blocks、theme.json、REST、WP-CLI、安全性、測試，還是發佈封裝工作，就應該安裝 wordpress-router。它特別適合用在跨多種 WordPress repositories 的 agent orchestration。

為什麼這很重要

如果沒有 router，代理常常會套錯心智模型：把 block theme 當成 classic theme 來想，或把 site repo 當成 plugin 來處理，甚至只是做一般性修改，而不是走正確的 WordPress workflow。這個技能多加了一個實用的分類步驟，能提升後續提示詞品質，也降低不必要變更的風險。

如何使用 wordpress-router 技能

安裝並找到決策路徑

先依照 wordpress-router 技能的文件化安裝路徑完成安裝，然後從 SKILL.md 開始讀。這個 repository 也會指向 references/decision-tree.md，那是做 routing 決策時最值得優先閱讀的後續文件。

提供正確的輸入給這個技能

wordpress-router 技能在以下資訊齊全時表現最好：

• repo root 或目前工作目錄，
• 使用者真正的意圖，
• 版本限制，例如 WordPress 目標版本或 WP.com 要求，
• 工具、發版流程或測試上的硬性限制。

像「修好這個 WordPress repo」這種模糊需求，很難被正確分流。更好的寫法會像這樣：「這是一個 wp-content repo；請判斷應該把它當成 block theme 還是 plugin workflow，然後為一個既有測試的 template 變更規劃最安全的路徑。」

首次使用的建議工作流程

1. 執行 SKILL.md 說明的 project triage 步驟。
2. 閱讀 triage 輸出，判斷專案類型、工具鏈與測試覆蓋情況。
3. 開啟 references/decision-tree.md，把意圖對應到下一個 workflow。
4. 在編輯前先套用 repository conventions，特別是既有的 build 與 test commands。

先查看 repo 的哪些內容

對 wordpress-router 指南來說，請優先看：

• SKILL.md：routing 流程與 guardrails，
• references/decision-tree.md：以意圖為基礎的分流，
• 其他 repo 專屬文件則放在確認 project kind 之後再看。

這個順序很重要，因為這個技能的設計目的，就是先縮小路徑，再去看其他內容。

wordpress-router 技能 FAQ

wordpress-router 能取代 domain skills 嗎？

不能。它是 Agent Orchestration 的前端決策技能。它能幫你選對 WordPress workflow，但一旦 repo 類型確定後，並不能取代 block、theme、plugin 或 testing skill。

什麼情況下不該用 wordpress-router？

如果任務已經很窄而且很明確，例如在一個清楚已知的 workflow 中修改單一檔案，就可以略過。當 routing 沒有任何歧義時，它的價值就比較低。

初學者安裝 wordpress-router 划算嗎？

划算，前提是初學者很可能會接觸多種 WordPress repo 類型。它提供的起點比一般提示詞更安全，但仍然要求使用者清楚提供意圖與限制條件。

這和直接下提示詞有什麼不同？

一般提示詞可能只會要求做出變更；wordpress-router 會先問這是什麼類型的 WordPress system，以及這次變更應該遵循哪一種 workflow。多出的這個分類步驟，就是 wordpress-router 技能的主要優勢。

如何改進 wordpress-router 技能

提供更清楚的意圖，不只是任務

最好的輸入會同時點出想要的結果和 repo 情境。舉例來說，不要只說「讓它更快」，而是說：「這是一個 WordPress plugin repo；請判斷效能工作應該遵循 plugin、REST 還是 block workflow，然後建議最安全的起始路徑。」

加上會影響分流的限制條件

如果你提供 WordPress 版本目標、發版要求和工具限制，這個技能的表現會更好。這些細節能幫助它判斷 repo 應該被視為 core、site、theme、plugin，還是以 Gutenberg 為主的工作。

留意常見的失敗模式

最常見的問題是情境描述不足。如果代理無法判斷自己面對的是 block theme、classic theme、plugin，還是 site repo，後續 workflow 就可能走錯。另一個失敗模式是跳過 decision tree，直接進入編輯。

第一次分類後再迭代

第一次跑完後，可以要求代理重新說明：

• repo 類型，
• 可能適用的後續 skill，
• 它用來判斷的檔案，
• 目前仍未釐清的主要不確定性。

這會讓 wordpress-router 更適合用在 Agent Orchestration，因為你能在開始修改程式碼之前先修正路徑。