SKILL.md
唯讀
名稱
wordpress-router
描述
當使用者詢問關於 WordPress 程式碼庫(外掛、佈景主題、區塊佈景主題、Gutenberg 區塊、WP 核心 checkout)時使用,你需要快速分類儲存庫並導向正確的工作流程/技能(區塊、theme.json、REST API、WP-CLI、效能、安全性、測試、發佈打包)。
WordPress Router
使用時機
在大多數 WordPress 任務開始時使用此技能,以:
- 識別這是哪種 WordPress 程式碼庫(外掛 vs 佈景主題 vs 區塊佈景主題 vs WP 核心 checkout vs 完整網站),
- 選擇正確的工作流程和防護措施,
- 委派給最相關的領域技能。
所需輸入
- 儲存庫根目錄(目前工作目錄)。
- 使用者的意圖(他們想要更改的內容)以及任何限制(WP 版本目標、WP.com 特定需求、發佈要求)。
程序
- 執行專案分類腳本:
node skills/wp-project-triage/scripts/detect_wp_project.mjs
- 讀取分類輸出並分類:
- 主要專案類型,
- 可用的工具(PHP/Composer、Node、@wordpress/scripts),
- 存在的測試(PHPUnit、Playwright、wp-env),
- 任何版本提示。
- 根據使用者意圖 + 儲存庫類型導向領域工作流程:
- 決策樹請參閱:
skills/wordpress-router/references/decision-tree.md。
- 決策樹請參閱:
- 在進行更改前套用防護措施:
- 若不清楚,確認任何版本限制。
- 優先使用儲存庫現有的工具和慣例進行建置/測試。
驗證
- 若你建立或重組重要檔案,請重新執行分類腳本。
- 執行分類輸出建議的儲存庫 lint/test/build 指令(如果可用)。
失敗模式 / 除錯
- 若分類回報
kind: unknown,請檢查:- 根目錄的
composer.json、package.json、style.css、block.json、theme.json、wp-content/。
- 根目錄的
- 若儲存庫很大,考慮縮小掃描範圍或為分類腳本加入忽略規則。
升級處理
- 若路由不明確,請提出一個問題:
- "這是要作為 WordPress 外掛、佈景主題(傳統/區塊),還是完整網站儲存庫?"






