umairmsm/wp-kickoff

階段 1：啟動

目標：產出一份關於商業的真相文件，以及一個包含方法論預期所有檔案的空白專案。尚未進行任何設計或建置。

步驟

1. 是否已有現有網站？ 如果是，請將其視為正在運行的商業服務，而非閒置域名。首先進行盤點 (references/discovery-brief.md，"現有網站")：
   • 所有 URL（從其 Sitemap）、表單、付款流程、部落格文章與聯絡資訊；
   • 其 Search Console 數據（若網站擁有者願意分享）；
   • 目前哪些功能在營利。重建時必須讓所有功能持續運作。 禮貌爬取：先閱讀使用條款 (robots.txt 並非授權許可)，且請求之間至少間隔 2 秒。
2. 商業探索。 詢問 references/discovery-brief.md 中的問題，並將答案寫入 docs/BRIEF.md。每個事實都要標註來源（網站擁有者、文件、爬取結果）。如果不知道某個事實，請寫 PENDING-<對象>。絕對不要猜測。
3. 技術棧。 以 references/stack.md 的預設值為起點。僅在能提出具體理由時才變更某一層，並將理由記錄在 DECISIONS.md 中。
4. 建立專案，使用 kit 的腳手架工具（此技能所在的資料夾向上兩層）：

   bash <kit>/bin/wp-site-new --name "Acme Tours" --slug acme-tours --prefix acme \
        --domain example.com --dir ~/sites/acme-tours --git
   

   • slug：小寫字母與連字號。它會命名 DDEV 專案、資料夾與文字域。
   • prefix：2 到 12 個小寫字母或數字。每個函式、選項、文章類型、Meta key、Hook 與 Nonce 都會以 <prefix>_ 開頭。
5. 填寫 AGENTS.md：
   • 網站是什麼；
   • 誰審核設計與客戶文案；
   • 鎖定的決策；
   • 此商業特有的硬規則，例如法規要求的聲明、需展示的執照，或網站擁有者從不希望出現的用字。
6. 私人遠端倉庫，第一天就設定好。 網站擁有者建立私人倉庫並推送。本機網站建立後（階段 3），執行 scripts/backup.sh 並在其他機器保留一份備份。
7. 憑證庫 (docs/reference/CREDENTIALS_INVENTORY.md)：
   • 列出每個帳戶（註冊商、DNS、主機、SMTP、分析工具、Search Console、金流、CDN）；
   • 記錄每個密碼的存放位置；
   • 僅記錄名稱，絕不寫入數值。
8. 在 SITE_STATUS.md 中勾選啟動關卡，並附上證據：探索文件的核准日期、第一個 commit SHA、遠端倉庫名稱。

關卡檢查

• docs/BRIEF.md 已獲得網站擁有者核准（日期）
• 鎖定決策與商業硬規則已記錄在 AGENTS.md 中
• 專案已建立並 commit；私人遠端倉庫已存在
• 憑證庫已開始記錄（僅名稱）
• 如果是更換現有網站：URL 與功能盤點已儲存在 docs/data/legacy/（或填寫「n/a」）

我們踩過的坑

• 將「切換」當作 DNS 變更，結果舊網站當天仍在處理付費預約。
• 舊網站的評論數（"1,118 則評論"）後來發現是捏造的。不要繼承它們。
• 透過 Cloudflare 代理域名，而舊主機按 IP 限制速率。主機只看到 Cloudflare 的 IP，導致真實訪客收到 429 錯誤。在開啟代理前，請先檢查來源端的限制。
• 信任另一位代理的筆記寫著「已解決」。修復檔案既未推送、未測試，也從未部署。請檢查真實狀況。
• 有人把 API 金鑰貼到代理對話中。任何被代理看過的金鑰都必須輪換。