Communitygithub.com

subhannaeem/wp-build-complete-website

根據簡短描述建立一個完整、響應式、具動畫效果的 WordPress 網站(區塊主題):規劃、頁面、流體設計、動畫、效能與無障礙檢查。當使用者說「幫我建立一個完整的網站」、「為...建立一個 WordPress 網站」或想要一個完整的響應式、互動式 WordPress 網站時使用。可在 Claude Code、OpenAI Codex 和 GitHub Copilot 中使用。

wp-build-complete-website 是什麼?

這個技能可以從單一描述自動生成一個完整的 WordPress 區塊主題網站。它將多個 wp-* 子技能串聯成一個逐步的閘門管線。首先,它會根據使用者輸入撰寫一份 SITE_BRIEF.md 檔案,詳細說明目的、受眾、頁面清單和功能,並要求使用者確認。接著,它會建立一個安全的專案資料夾,創建 block theme 結構(style.css、theme.json、templates/、parts/ 等),並僅使用 WordPress 核心區塊和模式,不依賴頁面建構工具或 CSS 框架。後續階段會從設計系統開始,定義顏色、流體排版和間距標記,然後為所有頁面建立範本和模式(使用語意化 HTML 和適當的替代文字)。它也新增動畫效果(卷軸觸發、懸停效果、頁面轉場),並優先使用 CSS 和 Interactivity API,同時尊重 prefers-reduced-motion。最後,它會執行效能和無障礙稽核,修正高優先級問題,並在不同螢幕寬度下測試以確保沒有橫向捲軸。完成後,它會產生一個 README.md 檔案,說明安裝方式(zip 上傳)以及哪些項目未經驗證(如 Lighthouse、真實裝置、螢幕閱讀器)。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/subhannaeem/universal-agent-skills/tree/HEAD/skills/wp-build-complete-website

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

建立一個完整的 WordPress 網站

一個描述,一個完成的區塊主題。此技能會依序執行其他 wp-* 技能。每個閘門必須完成後,下一個才能開始。

閘門 0:簡報(硬停止)

根據使用者的描述,撰寫 SITE_BRIEF.md,內容包含:

  • 目的與受眾、品牌調性、顏色與字型(若未指定則建議預設值)。
  • 頁面清單(預設:首頁、關於、服務或產品、部落格、聯絡我們)。
  • 功能(聯絡表單、部落格、相簿、商店)。僅包含使用者要求的功能。
  • 假設條件,編號列出,每個都有其預設值。

顯示該檔案,並要求使用者接受、拒絕或提出建議。停止並等待。

閘門 1:專案設定

  1. 在新的資料夾中工作(使用者選擇的名稱)。絕對不要觸碰現有網站的檔案。
  2. 建立一個區塊主題:style.css、theme.json、templates/、parts/(頁首、頁尾)、patterns/、assets/、functions.php。
  3. 使用 WordPress 核心區塊和模式。不使用頁面建構工具或 CSS 框架。
  4. 可選的本地測試: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:檢查

  1. wp-motion-performance-audit:修正高優先級項目(觸發版面配置的動畫、版面配置偏移、沉重腳本)。
  2. wp-accessible-ui-review:修正高優先級項目(焦點、對比度、標籤、標題)。
  3. 在 360、768、1024 和 1440 px 寬度下檢查:無橫向捲軸。
  4. 驗證:對 PHP 檔案執行 php -l,對 theme.json 檢查 JSON 有效性。

閘門 6:交接

在主題資料夾中撰寫一份簡短的 README.md:如何安裝(壓縮並上傳)、如何編輯頁面,以及哪些項目未經驗證(即時 Lighthouse、真實裝置、螢幕閱讀器、主機)。不要宣稱已執行更多項目。除非使用者要求,否則不要部署、推送或提交。

規則

  • 任何檔案中不得包含機密、API 金鑰或絕對本地路徑。
  • 僅新增使用者核准的外掛;最好不新增任何外掛。
  • 使用通用的佔位內容;絕不使用真實的個人或客戶資料。
  • 保持每次更改都可追溯至簡報。

相關技能