WordPress 網站：從空白資料夾到正式上線
這個套件是一套方法加上一個起始專案。它來自一個真實客戶付費使用的多語言預約網站。請依序完成各階段。每個階段結束時都有一個閘門：只有在閘門條件為真且證據已記錄時，才能離開該階段。
1. 找出專案目前進度
- 在專案根目錄尋找
SITE_STATUS.md。- 找不到：專案尚未開始。請使用 wp-kickoff。
- 找得到：閱讀它。目前的階段就是第一個閘門尚未勾選的階段。
- 閱讀
AGENTS.md（專案規則），然後閱讀SESSION_LOG.md和DECISIONS.md的最新幾行。 - 用兩行文字告訴專案擁有者：目前的階段，以及下一步具體要做什麼。
2. 各階段
| # | 階段 | 技能 | 離開閘門（證據需記錄在 SITE_STATUS.md） |
|---|---|---|---|
| 1 | 啟動 | wp-kickoff | 擁有者核准簡報；已鎖定決策且記錄完畢；私有儲存庫；憑證已列出名稱 |
| 2 | 設計 | wp-design | 靜態原型簽核完成（需附螢幕截圖與日期）；已設定設計權杖；字型自架 |
| 3 | 建置 | wp-build | 本地網站可正常運作；核心外掛與子佈景主題已啟用；真實項目透過核心函式正確渲染；詢問訊息在轉寄前先存檔；結構測試通過 |
| 4 | 內容 | wp-content | 每個公開頁面都有擁有者核准的文案與真實照片；法律條款頁面存在；無未經核准的 AI 產生文字 |
| 5 | SEO 與多語言 | wp-seo | 標題、描述、Canonical URL、結構化資料與 hreflang 測試通過；舊 URL 重新導向對應表；每個額外語言皆通過試行測試 |
| 6 | 品質 | wp-quality | 完整測試套件通過；0 個無障礙違規；在測試環境上滿足效能預算 |
| 7 | 上線 | wp-ship | 測試環境與正式環境同步；已套用安全強化；上線稽核器 PASS；切換完成；監控 7 天 |
| 8 | 維運 | wp-operate | 自動備份含異地副本；完成一次還原演練；更新與警示流程已撰寫完成 |
- 將階段工作交接給建置代理工具（Antigravity、Codex、其他 Claude）：wp-task-file。
- 合併前審查：代理工具 wp-rules-reviewer。正式上線前：代理工具 launch-auditor。
3. 硬性規則（每個階段、每個代理工具皆適用）
- 外掛優先。 邏輯、資料、政策文字、表單、結構化資料與 SEO 都應放在核心強制啟用外掛中。主題負責版面，外觀負責視覺風格。重新設計時不得遺失任何功能。
- 範本中不得寫死卡片、價格或 slug。應查詢內容類型並透過核心的渲染函式輸出，使 CMS 編輯能即時更新所有地方。
- 先儲存詢問資訊。 表單提交至
admin-post.php並附上 nonce。網站先將詢問資訊存入自己的資料庫，再進行轉寄。頁面中不得包含 API 金鑰或第三方端點。 - 無虛假證明。 絕不顯示無法證明的評分、評論數量或推薦。匯入或「舊有」的評論數量在未經證實前視為虛假。
- 真實照片 用於任何有命名的地點、房間、產品或人物。AI 圖片僅能作為一般風景，命名為
ai-*，需記錄，且不得呈現為「這是您的房間」。 - 事實來自擁有着。 價格、政策、包含項目與安全事實不得自行編造。AI 產生的文案僅為草稿，須經擁有者核准。未知事項標記為
PENDING-<誰>。 - 未經分支、本地測試、差異比對及人工合併，不得將 AI 撰寫的 PHP 程式碼部署到正式環境。 遵循 WordPress 編碼標準。所有項目需加上前綴。
- 不使用頁面建置器。不呼叫 Google Fonts。 自架字型：德國法院曾判決賠償，因為從 Google 載入字型會外洩訪客 IP 位址。
- 測試環境與本機環境不得被索引，也不得向真實客戶發送電子郵件。
- 不得為了測試通過而減弱測試： 不得刪除、跳過或重新產生快照。重新命名測試需經擁有者同意。
- 部署權屬於擁有者。 從一次提交開始，透過
scripts/deploy-safe.sh：先進行模擬演練，先備份，並由真人輸入live這個詞。 - 資料庫即內容。 僅能透過可審查的變更檔案與附有模擬演練的受保護腳本來修改。每次資料庫變更前都需備份。
- 機密永不進入 git、日誌、提示詞或頁面中。
CREDENTIALS_INVENTORY.md列出機密名稱及其存放位置，絕不存放實際值。 - 僅有一個結構化資料擁有者（通常是 SEO 外掛）。不得在沒有價格的情況下輸出
Offer。
4. 先詢問擁有者
- 安裝外掛、佈景主題、工具或付費服務（頁面建置器：絕對不行）。
- 任何價格、貨幣、政策、品牌名稱或標誌的變更。發佈新語言。
- 任何涉及 DNS、Cloudflare、主機、測試環境或正式環境的操作。破壞性資料庫或檔案指令。
- 將程式碼或客戶內容傳送給第三方 AI API。
5. 工作方式
- 一次只進行一個階段，一次只進行一個小步驟。每個有意義的步驟後都進行提交（採用 Conventional Commits）。
- 建立分支、本地測試、差異比對，然後由擁有者合併。除非擁有者要求該特定操作，否則代理工具不得推送、合併、部署或透過
ssh連線至伺服器。 - 每個決策都記錄在
DECISIONS.md中（日期、決策者、原因）。每次工作階段結束時，在SESSION_LOG.md中新增一行記錄。 - 「完成」意指已驗證：開啟頁面、執行測試、讀取伺服器回應。切勿未經親自檢查就直接採信其他代理工具標記為「已解決」的項目。
6. 來自其他套件的實用技能（若已安裝）
- agent-skills-kit：提供
wordpress-modern、wp-plugin-development、wp-wpcli-and-ops、wp-performance以取得 WordPress API 細節。 - agent-loop-kit：提供
supervised-build、agent-supervisor用於含有閘門與審查者的無人建置迴圈。