上一篇我們把環境備好了，這一篇開始 Everything-WP 設計好的指令來開始設計區塊主題，我們的目標是產生一個能立刻啟用、而且從第一天就有測試和品質工具的區塊主題骨架。這件事如果手動做，得建二三十個檔案、配好 composer.json、寫 GitHub Actions、設定 PHPCS 規則等繁瑣流程，我們用 /init-theme 讓 AI 一次做完。
你可能會問區塊主題架構不是很簡單嗎？一個 style.css、一個 theme.json、一個 templates/index.html 就能跑了，何必用指令？
能跑不代表能維護。一個「認真」的主題專案除了那三個檔案外，還要有：PHPCS 幫你檢查格式、PHPStan 做靜態分析、PHPUnit 跑測試、i18n 的 .pot 讓它可翻譯、GitHub Actions 在推版時自動部署、一個 build 腳本產出乾淨的 zip。
這些是「開發工具鏈」不是主題本身，但少了它們專案很容易就會失控。/init-theme 把主題檔案和這整套工具鏈一起生出來。
WordPress 官方有一套做 Create Block Theme 外掛。裝了它你能直接在網站編輯器裡開一個空白主題、複製現有主題、建立子主題，還能把你在編輯器裡改好的樣式和模板「存回」主題檔案（theme.json、templates/*.html），甚至管理字型、把用到的圖片收進主題、讓字串可翻譯。
這是一套很好用的工具，我自己也常用它做「把編輯器裡的視覺調整匯出成檔案」這件事。那為什麼不直接用它來開場？因為它跟 /init-theme 解決的是不同的一半。Create Block Theme 專精在「主題檔案的產生與匯出」這個設計端的循環，把你在站台編輯器的成果變成乾淨的檔案。
而我們做的剛好是反過來，先從底層開發區塊主題的角度出發，然後並把相關的開發環境與工具都一次到位，另外還有一個更貼近本系列的理由：Create Block Theme 是「在網站編輯器裡用滑鼠操作」的工具，而我們整套流程是「用 AI 在終端機裡開發」。
/init-theme 是專門設計給 Claude Code 的開發流程，建立出來的骨架 AI 全部都能接手，所以實務上我的分工是：用 /init-theme 開一個帶完整工具鏈的骨架，之後在網站編輯器裡調版面、改配色時，再用 Create Block Theme 把調整匯出回檔案。兩者不打架，各做各擅長的那一半。
在 VScode 的 Claude 輸入 /everything-wp:init-theme：
如果開啟的是 WordPress 的根目錄的話，它會詢問是否要建立新的區塊主題資料夾，建立好後它會先做一件重要的事：偵測模式。看目前資料夾有沒有 style.css 且帶著 Theme Name: 註解。
沒有的話就是全新專案（Greenfield）；有的話就是要幫既有主題補工具（Augment），這時它不會去動你現成的範本檔。這個保護很關鍵，免得你在錯的資料夾（例如整個 themes/）誤觸，把檔案建立在錯誤的層級。
確認是全新專案後，它用 AskUserQuestion 問幾題並附上都推薦選項，多半直接按 Enter 即可：
1.0.0。當跑完所以初始化流程後，會產生以下三類的檔案：
主題本體：style.css（只放必要資訊和少量 CSS）、theme.json（全站設計元素的單一來源）、一個極簡的 functions.php、templates/ 裡的 index.html／single.html／page.html／archive.html／404.html，以及 parts/ 裡的 header.html、footer.html。
品質工具：.phpcs.xml.dist（排版規則）、phpstan.neon（靜態分析，Block 主題只掃 functions.php）、phpunit.xml.dist 與 tests/（測試骨架）。
發佈工具：readme.txt、.github/workflows/release.yml（推 tag 自動發版）、scripts/build.php（打包 zip）。
同時它會配好 composer.json，把 PHPCS、WPCS、PHPStan、PHPUnit 這些開發相依套件都掛上去，然後跑 composer install，並用 WP-CLI 產生 languages/ 裡的 .pot。
這樣之後就可以用以下指令來讓 Claude Code 自行做程式碼品質的檢查：
composer phpcs # 排版符不符合標準
composer phpstan # 有沒有型別/邏輯問題
composer build # 能不能打包成 zip
回到 WordPress 後台的「外觀 → 佈景主題」，這個剛生出來的主題已經在清單裡，你可以請 Claude Code 幫你啟用，通常要啟用佈景主題需要 WP-CLI，而本機工具 Local 已經內建了，所以 Claude Code 能夠直接操作整個本機環境。
下一篇我們把這些檔案打開逐一檢視，看懂之前提到的 templates、parts、theme.json 在真實的區塊主題中會有哪些內容以及如何設計
文章目錄：https://oberonlai.blog/category/2026-ithome/
Hi, 我是 Oberon Lai，十多年前我從一個不懂程式的平面設計師，一頭栽進 WordPress 的世界。從佈景主題到外掛開發，從接案到自研產品，這段旅程讓我深刻理解：好的技術不只是寫出能跑的程式碼，而是真正解決人的問題。
我積極投入參與社群，公開演講紀錄如下：
我專精 WordPress 開發，從企業形象網站的設計與開發、佈景主題客製化，到既有網站的改版升級，提供完整的 WordPress 建置服務。開發面涵蓋外掛開發與維護、區塊編輯器（Gutenberg）客製區塊、ACF 與 Custom Post Type 的資料架構設計，以及 REST API 整合與 Multisite 多站架構建置。同時也協助網站效能改善與 SEO 調校、安全性檢測與強化，並導入自動化部署與版本控制流程，搭配長期的技術顧問與維運支援，讓網站上線後也能穩定運作。
亦提供 WooCommerce 商店的建置與設定，並串接綠界、LINE Pay、藍新等台灣主流金流。可依需求進行結帳頁面客製化、訂單狀態自動化流程設計，以及商品管理與庫存系統的客製開發；也支援 WooCommerce Subscription 定期定額、REST API 應用開發、報表與數據匯出等進階需求。此外，透過購物流程 UX 改善、電商網站效能調校與 HPOS 高效能訂單儲存相容開發，全面提升營運效率，並提供電商營運技術顧問服務。
AI 浪潮席捲而來，我選擇擁抱而非恐懼，我把 AI 融入開發工作流以及客戶的產品中，也持續累積「AI 看不見的部分」：真實踩坑經驗、最新漏洞情報那些只有第一線工程師才看得見的細節，如果你有任何 WordPress 的客製化需求或是 AI 開發相關的問題非常歡迎加入 LINE 官方帳號與我聯繫：
https://page.line.me/vrf7844t?oat_content=url&openQrModal=true
如果想要獲取 AI 開發實戰經驗也能訂閱我的電子報，每週五上午準時出刊：
https://oberonlai.blog/wordpress-newsletter/
iThome鐵人賽
看影片追技術