建立客戶網站
主 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:規劃
- 撰寫
plan.md:頁面(大多數客戶需要首頁、每個主要服務的頁面或選單/服務頁面、關於我們、聯絡我們)、每個頁面的一個主要行動,以及每個頁面上的區塊順序。使用簡報和site-essentials。 - 使用
copywriting技能撰寫文案,然後對其執行copy-editing。從簡報的客戶語言和客戶自己的詞彙出發,並幾乎逐字使用其中一些詞組。遵循 CLAUDE.md 中的內部規則 9(無通用 AI 用語)。將文案放在src/data/中(例如 home.json, services, FAQs),而不是放在元件中。 - 將任何你不確定的內容標記為
[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:上線準備
- 執行
npm run check:launch並修正每個 FAIL。然後填寫docs/launch-checklist.md,將每個項目標記為已完成、不適用或正在等待某人(請註明是誰)。 - 為客戶填寫
docs/handoff.md。 - 如果客戶將自行編輯網站,請遵循
docs/client-editing.md。 - 網站在其正式網域上線後,提醒使用者對其執行 claude-seo:
/seo local <url>和/seo audit <url>。
階段 8:經驗教訓
掃描報告和修正輪次,找出任何發生過兩次或耗費實際時間的問題。將每個經驗教訓以一行附帶日期的形式附加到 docs/lessons.md。告訴使用者哪些經驗教訓值得複製回 site-starter,以便每個未來的網站都能受益。