Communitygithub.com

客戶網站搭建

跑通客戶網站的整條流水:需求與設計採集、網站地圖與文案、搭建、檢查、審閱、SEO 與上線準備,中間有兩道確認,修改次數有上限。

客戶網站搭建 是什麼?

從採集做到上線準備,用來新開或重建一個客戶網站,並在確認點停下,而不是無休止地改視覺。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cgfeletar/website-builder/tree/HEAD/core/.claude/skills/build-site

在你喜歡的 AI 中提問

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

說明文件

建立客戶網站

主 session 會執行此管道並將任務委派給子代理。(子代理無法啟動其他子代理,這就是為什麼這是一個技能,而不是一個協調器代理。)

[0 輸入關卡]  簡報 + DESIGN.md + 參考資料
      ↓
[1 規劃]  網站地圖、頁面區塊、文案  →  plan.md, src/data/*
      ↓
[使用者關卡 1]  批准規劃與文案
      ↓
[2 建置]  頁面與視覺系統
      ↓
[3 SEO]     SEO 代理            →  seo-report.md
      ↓
[4 驗證]  npm run verify(強制關卡)
      ↓
[5 審閱]  網站審閱代理  →  review-report.md
      ↓
[6 修正迴圈]  P0/P1 → 修正 → 驗證 → 重新審閱(最多 2 輪)
      ↓
[使用者關卡 2]  批准網站
      ↓
[7 上線準備]  上線檢查清單 + 交接文件
      ↓
[8 經驗教訓]  附加到 docs/lessons.md

產出物

所有產出物都放在 .claude/pipeline/ 中:

pipeline-state.md   階段、修正輪次、最後更新時間
plan.md             網站地圖、每個頁面的區塊、每個頁面的主要行動
review-report.md    來自 site-reviewer
seo-report.md       來自 SEO
screenshots/        來自 npm run verify

在每個階段開始時讀取 pipeline-state.md,並從它所指示的地方繼續。在每個階段結束時更新它。這讓建置過程可以跨越多個 session。

階段 0:輸入關卡

檢查每個項目。如果缺少任何項目,請先停止並協助使用者補齊,再進行後續步驟。

項目準備就緒當
.agents/product-marketing.md商業事實部分已完成,主要行動已命名,目標受眾與語調已填寫。使用 product-marketing 技能根據使用者提供的內容進行草擬。
src/data/business.json名稱、電話、地址、營業時間、地圖連結與簡報相符。從簡報中複製這些資料。
DESIGN.md每個章節都已填寫。如果使用者只有參考資料,請從 references/ 草擬並要求他們確認。
references/至少兩張螢幕截圖或 URL,並附上一行說明要從每個參考資料中汲取什麼。
客戶素材Logo 和照片,或明確說明目前可以使用替代素材。
編輯權限客戶是否會自行編輯網站?(會影響階段 7。)

然後根據 DESIGN.md 填寫 src/styles/tokens.css。

階段 1:規劃

  1. 撰寫 plan.md:頁面(大多數客戶需要首頁、每個主要服務的頁面或選單/服務頁面、關於我們、聯絡我們)、每個頁面的一個主要行動,以及每個頁面上的區塊順序。使用簡報和 site-essentials。
  2. 使用 copywriting 技能撰寫文案,然後對其執行 copy-editing。從簡報的客戶語言和客戶自己的詞彙出發,並幾乎逐字使用其中一些詞組。遵循 CLAUDE.md 中的內部規則 9(無通用 AI 用語)。將文案放在 src/data/ 中(例如 home.json, services, FAQs),而不是放在元件中。
  3. 將任何你不確定的內容標記為 [NEED: ...]。切勿用捏造的事實填補空白。

使用者關卡 1

停止。向使用者顯示:網站地圖、每個頁面的區塊和主要行動、完整文案,以及每個 [NEED: ...] 項目。等待批准或修改。文案在現在修改比在建置後修改更便宜。

階段 2:建置

使用 design-taste-frontend 技能(品味技能)在此 Astro 專案中進行建置。開始之前,請告訴它:

  • 類型是 place(人們前往的地點)或 service(人們被僱用的服務),絕對不是科技類型。
  • DESIGN.md 和 references/ 設定色板、字型和風格。它原有的處理色板和字型將被覆蓋。
  • 商業事實來自 src/data/business.json。它原有的替代聯絡規則不適用。
  • 動畫效果遵循 CLAUDE.md 中的內部規則。

逐頁建置,先建首頁。建置首頁後,執行 npm run verify,查看三張螢幕截圖,並在繼續建置下一頁之前修正所看到的問題。品味技能的完成關卡在其停止時會自行執行;將其發現作為輸入,但在衝突時以 CLAUDE.md 為準。

階段 3:SEO

SEO 代理會編輯 head 標籤、JSON-LD 和 robots.txt,因此它在驗證和審閱之前執行。這樣審閱時評估的是最終完成的網站。

seo: "為此網站進行 SEO 稽核與實施,包括本地商家步驟。簡報:.agents/product-marketing.md。將你的報告寫入 .claude/pipeline/seo-report.md。"

階段 4:驗證(強制關卡)

npm run verify

所有 check-site 的 FAIL 以及螢幕截圖問題(橫向滾動、主控台錯誤)必須在審閱前修正。[NEED: ...] 的失敗僅允許用於使用者已被詢問過的事實;請列出它們。重寫任何被 check-site 標記為通用語的文案,除非客戶實際使用了該詞。

階段 5:審閱

審閱者為唯讀,並將其報告作為最終訊息返回。將該訊息逐字儲存到 .claude/pipeline/review-report.md。

site-reviewer: "審閱已建置的網站。規劃:.claude/pipeline/plan.md。簡報:.agents/product-marketing.md。設計:DESIGN.md。螢幕截圖:.claude/pipeline/screenshots/。已完成的 SEO 變更:.claude/pipeline/seo-report.md。將完整報告作為你的最終訊息返回。"

階段 6:修正迴圈

site-reviewer 判定行動
準備就緒進入關卡 2
需要跟進,僅有 P2進入關卡 2,列出 P2
需要跟進(有 P1)或封鎖(有 P0)回合 < 2:修正它們,重新執行階段 4(驗證),對變更過的頁面重新執行 site-reviewer 並儲存其報告。回合 = 2:停止並向使用者顯示。

對於任何損壞(而不僅僅是偏離簡報)的問題,使用 bug-fixer 代理。每次修正時,在 pipeline-state.md 中遞增回合數。

使用者關卡 2

停止。向使用者顯示:首頁在 390 和 1440 寬度下的螢幕截圖、判定結果、剩餘的 P2、需要的 SEO 決策、剩餘的 [NEED: ...] 項目,以及需要更換的替代照片。等待批准。

階段 7:上線準備

  1. 執行 npm run check:launch 並修正每個 FAIL。然後填寫 docs/launch-checklist.md,將每個項目標記為已完成、不適用或正在等待某人(請註明是誰)。
  2. 為客戶填寫 docs/handoff.md。
  3. 如果客戶將自行編輯網站,請遵循 docs/client-editing.md。
  4. 網站在其正式網域上線後,提醒使用者對其執行 claude-seo:/seo local <url> 和 /seo audit <url>。

階段 8:經驗教訓

掃描報告和修正輪次,找出任何發生過兩次或耗費實際時間的問題。將每個經驗教訓以一行附帶日期的形式附加到 docs/lessons.md。告訴使用者哪些經驗教訓值得複製回 site-starter,以便每個未來的網站都能受益。

相關技能