使用程式碼代理建立網站時,提示詞只是其中最小的一部分。決定您最終獲得的是一個展示品還是一個可運作網站的關鍵,在於圍繞提示詞的工作流程:如何記錄需求、在生成開始前鎖定哪些決策,以及如何檢查結果。
以下是我使用的工作流程,其結構與 Web Builder 技能的設計方式相同。Web Builder 是一個可以安裝到 Claude Code、Cursor 或 Codex 中的技能,能將網站從簡報階段帶到經過驗證的交付。即使您從未安裝此技能,這些步驟也同樣適用;該技能只是讓它們難以被跳過。
本文強調,使用 AI 程式碼代理建立網站,成功的關鍵在於一個結構化的工作流程,而非僅僅依賴單一提示詞。它概述了一個六步驟的實用方法,涵蓋從詳細簡報、鎖定範圍、選擇設計、生成基礎到嚴格驗收測試和維護專案記錄。這個流程確保了從需求定義到最終交付的每個環節都經過仔細規劃與驗證,避免了僅依賴單一提示詞的盲目開發。

使用程式碼代理建立網站時,提示詞只是其中最小的一部分。決定您最終獲得的是一個展示品還是一個可運作網站的關鍵,在於圍繞提示詞的工作流程:如何記錄需求、在生成開始前鎖定哪些決策,以及如何檢查結果。
以下是我使用的工作流程,其結構與 Web Builder 技能的設計方式相同。Web Builder 是一個可以安裝到 Claude Code、Cursor 或 Codex 中的技能,能將網站從簡報階段帶到經過驗證的交付。即使您從未安裝此技能,這些步驟也同樣適用;該技能只是讓它們難以被跳過。
步驟一:撰寫一份讓未來的自己也能理解的簡報。像「為我的維修公司建立一個網站」這樣的提示詞,將所有實際決策都留給了即興發揮。一份簡報則會將這些決策記錄下來。
Web Builder 將簡報作為一個 JSON 檔案,包含 brand、business、locale、region、websiteType、adminRequired 和 modules 等欄位,每個欄位都有其重要性。region 和 locale 會在稍後提供具體建議,例如根據商家所在國家和收件人位置選擇合適的簡訊供應商,以及根據倉庫來源和目的地選擇適合的運送 API。adminRequired 則強制做出大多數人會拖延到成本高昂時才做的決策。
該技能文件中的對話式簡報版本是:「使用 $web-builder 為一家服務英國的維修公司建立一個網站。網站應為英文,包含服務、案例研究、預訂、客戶諮詢和管理區域。協助我選擇前端和管理模板,實作並驗證工作流程,並首先交付一個本地專案。」
請注意其中包含的內容:目標受眾和市場、工作流程(預訂、諮詢,而非「頁面」)、管理決策,以及交付目標(首先是一個本地專案)。這種程度的具體性才能在生成過程中存活下來。
步驟二:將範圍鎖定為一個組合,並預覽它。Web Builder 將範圍定義為網站類型加上功能模組。它有 11 種網站類型,例如維修公司屬於 business 類型,商店屬於 commerce 類型,列表網站則屬於 directory 類型。
此外,還有 26 個模組,從 inquiries、bookings 和 content 到 payments、shipping、subscriptions 和 entitlements。在生成任何內容之前,一個組合解析器會檢查這些組合,包括引入的依賴項、遵守的排除項、應用管理決策,並預覽一個計畫供您審查。
這個預覽步驟是範圍誤解可以低成本解決的地方。類型定義對於邊界是刻意直接的:一個列表目錄不會自動包含多賣家交易,一個課程展示網站也不會自動包含完整的學習平台。在計畫階段發現這些問題只需一分鐘,但在生成之後才發現則需要重新建構。
步驟三:選擇設計,先前端後管理,並檢查存取權限。在範圍鎖定後,代理會根據角色和行業在 Skillux 模板目錄中搜尋,然後您可以從實際選項中選擇一個前端設計,如果專案有管理區域,再選擇一個管理設計。
這一步驟有兩個細節比聽起來更重要。首先,在模板下載之前會檢查權限,避免您在無法使用的設計上建立半個網站。其次,封面圖和預覽圖會明確標示其性質:封面圖是展示圖片,只有實際預覽才能顯示您將採用的設計。
如果專案沒有管理功能,這一步驟會更短:無需管理模板,生成器會完全省略管理頁面、API、資料模型和憑證。
步驟四:生成基礎,然後實作,並區分兩者。生成過程會搭建應用程式的基礎。Web Builder 目前提供兩種可執行的基礎:標準版(Next.js、TypeScript、Prisma、SQLite、網站設定、可選管理功能)和商務版(範例產品、SKU、庫存、購物車、訂單、存取金鑰、模擬支付)。
模組目錄中的其他所有內容都由代理根據技能的指示實作,這些實作會受到引導和檢查,並為您的專案量身打造。將「生成」與「實作」這兩個動詞區分開來,是工作流程與魔術之間的區別。
該技能的專案記錄檔 .web-builder/project.json 會追蹤每個項目的區別:pending 表示仍需工作,scaffolded 表示基礎已存在,只有當其檢查通過時,工作流程才算完成。這裡還有一個實用的小陷阱:選擇 commerce 類型本身並不會自動選擇商務基礎,簡報必須明確包含 orders 模組和三位數的貨幣代碼,並且生成時需要帶上 --foundation commerce 旗標。模擬支付,雖然不言而喻但顯然必須強調,並不會向任何人收費。
步驟五:像懷疑論者一樣執行驗收測試。一個成功的建置只是驗證的開始,而非結束。首先要執行生成專案本身的檢查:npm run typecheck、npm test、npm run build。
然後,以使用者可能破壞它的方式測試工作流程:使用真實和錯誤的輸入提交每個表單。查詢表單應該保存您可以找到的記錄,並以使用者可以處理的錯誤狀態拒絕無效輸入,而不是無聲的失敗或堆疊追蹤。
查看空狀態頁面。例如沒有預訂的預訂列表、沒有產品的商店、沒有結果的搜尋。這些是您的第一批訪客實際會遇到的畫面,也是生成過程中最常跳過的。
檢查登入的兩端。以管理員和客戶身份登入。只有管理員才能執行的操作,對於客戶帳戶應該是無法觸及的,而不僅僅是從其選單中隱藏。
練習載入和失敗路徑。放慢網路速度,斷開供應商連線。一個未配置的支付或簡訊服務在交付時大聲失敗的網站是可以完成的;一個在生產環境中默默失敗的網站則不行。
檢查那些不那麼光鮮亮麗的頁面。例如項目多於一頁時的分頁、手機寬度視窗下的網站顯示、模板較淺部分文字的對比度。
自動化 HTTP 檢查應僅針對專案的獨立本地副本執行,並在測試時將外部服務指向沙盒或本地接收器。最終的交付物是一個本地專案,加上一份狀態記錄,逐項說明哪些已通過,哪些仍需關注,包括仍在等待真實憑證的外部服務。這份清單是交付的一部分,而不是需要隱藏的尷尬。
步驟六:讓下一個工作階段從記錄開始,而非記憶。網站很少能一次完成,而第二個工作階段通常是代理建立專案開始瓦解的地方,代理會重新詢問已解決的問題,或悄悄做出不同的選擇。
解決方案既枯燥又有效:專案記錄會持續存在。當您返回時,代理會首先讀取 .web-builder/project.json 和現有程式碼,並重複使用已記錄的語言、模板、模組和供應商決策。您在第二個工作階段的任務是描述變更,而不是重新爭論簡報內容。
工作流程總結:簡報需書面化,包含市場和管理決策。範圍應明確組合,並在生成前預覽。設計按順序選擇,下載前驗證存取權限。生成和實作應作為不同狀態追蹤。
驗收測試應在使用者操作層面進行,例如提交、登入、失敗、空狀態,而不僅僅是通過建置。最後,專案記錄應允許下一個工作階段繼續,而非重新開始。
這些步驟都不需要 Web Builder 才能執行,它們要求的是拒絕讓單一提示詞承載它無法處理的決策。該技能的存在就是為了讓這種拒絕自動化。
如果您想以產品形式查看整個流程,Skillux 上的 Web Builder 概述逐步涵蓋了從簡報到交付的路徑,而 Skillux 上的 Web Builder 技能可免費安裝到您的代理中。
我在 Skillux 工作,這是一個為 Claude Code、Cursor 和 Codex 提供 AI 設計技能的目錄和市場。像 Web Builder 這樣的技能,就是我們將這種工作流程(簡報、建置、驗證)打包的方式,讓代理能夠重複執行,而不是每個專案都重新發明。
覺得值得一看?分享給朋友。
以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Claude Code) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。
43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。