建立一個完整的 WordPress 網站
一個描述,一個完成的區塊主題。此技能會依序執行其他 wp-* 技能。每個閘門必須完成後,下一個才能開始。
閘門 0:簡報(硬停止)
根據使用者的描述,撰寫 SITE_BRIEF.md,內容包含:
- 目的與受眾、品牌調性、顏色與字型(若未指定則建議預設值)。
- 頁面清單(預設:首頁、關於、服務或產品、部落格、聯絡我們)。
- 功能(聯絡表單、部落格、相簿、商店)。僅包含使用者要求的功能。
- 假設條件,編號列出,每個都有其預設值。
顯示該檔案,並要求使用者接受、拒絕或提出建議。停止並等待。
閘門 1:專案設定
- 在新的資料夾中工作(使用者選擇的名稱)。絕對不要觸碰現有網站的檔案。
- 建立一個區塊主題:
style.css、theme.json、templates/、parts/(頁首、頁尾)、patterns/、assets/、functions.php。 - 使用 WordPress 核心區塊和模式。不使用頁面建構工具或 CSS 框架。
- 可選的本地測試:WordPress Playground 或
wp-env(如果可用)。
閘門 2:設計系統(wp-responsive-fluid-design)
在 theme.json 中定義顏色、流體排版尺度和間距標記。建立頁首、頁尾、導覽列和行動版選單。所有值都來自標記。
閘門 3:頁面與內容
為簡報中的每個頁面建立範本和模式。使用清晰的佔位內容(當目的已知時不要使用 Lorem Ipsum),並為圖片加上 alt 文字。使用語意化的 HTML:每個頁面一個 h1。
閘門 4:動畫(wp-animated-block-theme)
使用 CSS 優先、再使用 Interactivity API,新增卷軸觸發、懸停效果和頁面轉場效果。所有效果都尊重 prefers-reduced-motion;即使沒有 JavaScript,內容仍保持可見。僅在所需效果需要時才使用 wp-gsap-lottie-integration。
閘門 5:檢查
wp-motion-performance-audit:修正高優先級項目(觸發版面配置的動畫、版面配置偏移、沉重腳本)。wp-accessible-ui-review:修正高優先級項目(焦點、對比度、標籤、標題)。- 在 360、768、1024 和 1440 px 寬度下檢查:無橫向捲軸。
- 驗證:對 PHP 檔案執行
php -l,對theme.json檢查 JSON 有效性。
閘門 6:交接
在主題資料夾中撰寫一份簡短的 README.md:如何安裝(壓縮並上傳)、如何編輯頁面,以及哪些項目未經驗證(即時 Lighthouse、真實裝置、螢幕閱讀器、主機)。不要宣稱已執行更多項目。除非使用者要求,否則不要部署、推送或提交。
規則
- 任何檔案中不得包含機密、API 金鑰或絕對本地路徑。
- 僅新增使用者核准的外掛;最好不新增任何外掛。
- 使用通用的佔位內容;絕不使用真實的個人或客戶資料。
- 保持每次更改都可追溯至簡報。