Communitygithub.com

用 Claude Code 打造你的網站

一個從頭到尾的 Claude Code 技能,用你喜歡的風格親手打造專屬網站 — 作品集、登陸頁或部落格。這是一個流程,不是模板。

用 Claude Code 打造你的網站 是什麼?

這項技能將開發者轉變為「導演」,讓 Claude Code 扮演「製作團隊」的角色。它提供了一套從零開始打造個人網站的完整流程,涵蓋從構思、部署到反覆迭代的各個階段。核心原則是「先上線,再優化」—— 在第一天上線一個粗糙但真實的網站,然後透過小型、可見的改進步驟進行迭代。這項技能適用於所有主流框架和託管平台(如 Next.js、Astro、Vercel 和 Netlify),並特別強調查詢已安裝的文檔以避免因模型訓練資料過舊而產生的 API 幻覺錯誤。它還包含如何將使用者的品味和要求編碼為一套設計系統(包括顏色、字體、間距、動效和語調),並儲存在 `AGENTS.md` 和 `DESIGN_SYSTEM.md` 等檔案中,以確保每次建置都能保持一致。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add Williampannn/build-your-website-with-claude-code

在你喜歡的 AI 中提問

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

說明文件

用 Claude Code 打造你的網站 是做什麼的?

這是一個流程,而不是模板。它教你如何建立一個讓自己感到驕傲的網站 — 用你自己的品味、你自己的內容、適合你的技術棧 — 以 Claude Code 作為建造者。你提供框架和步驟;他們提供願景。

這一切都建立在一個關鍵轉變上:你是導演,Claude 是製作團隊。 他們決定網站該給人什麼感覺、什麼是「夠好了」;Claude 負責搭建、撰寫、設計樣式、驗證和部署。當你執行這項技能時,你的任務是:將他們的品味「挖掘」出來,轉化為 Claude 可以執行的指令,快速讓網站上線,然後持續迭代。

一條規則支配所有行為: 先取得一個真實、簡陋、已上線的網站,然後再透過你可以看到的小步驟來改進它。一個第一天就上線並迭代了 50 次的網站,遠遠勝過一個從未發布的傑作。


心態(及早大聲說出來)

  • 你導演,Claude 建造。 使用者完全不需要寫程式 — 甚至不必知道相關術語。他們描述感覺(「更溫暖」、「感覺很擁擠」、「太商業化」)並指出方向;Claude 將其轉譯為像素。
  • 先上線,再美觀。 在設計任何樣式之前就先部署一個空殼網站,這樣你可以在沒什麼東西會壞掉的時候,一次除錯好整個部署管道。
  • 將品味編碼成檔案。 一旦他們喜歡某個樣子,就將它記錄為一套設計系統,讓使用者和 Claude 在每次工作階段都能參考 — 這能防止網站偏離方向。
  • 小型、可見的步驟。 一次只做一個連貫的變更;看看它;提交它。大型、看不見的變更是網站失敗的溫床。
  • 形成反饋閉環。 及早發布,把它放到真實使用者面前,然後將他們的回饋直接餵給 Claude,作為下一份待辦事項清單。
  • 卡住時,問 Claude。 下面的每一個步驟 — 建立帳號、修正終端機的紅色錯誤、令人困惑的主機畫面 — 都是可以交給 Claude 處理的,而不是必須自己解決。使用者能說出的最有用的兩句話是「我從沒做過這個,帶我一步一步做」和「這是我看到的畫面截圖」。

如何使用這項技能

大致上按照順序進行各個階段,但它們不是僵硬的瀑布式流程 — 第 4 階段(迭代迴圈)是持續運作的引擎,位於其他階段之下:

第 0 階段 → 第 1 階段 規劃框架並讓它上線 · 第 2 階段 → 第 3 階段 讓它成為你的風格並填滿內容 · 第 5 階段 → 第 6 階段 讓它令人難忘並傾聽反饋 · 第 4 階段 全程運作。

每個階段都會提供:目標、步驟、一個讓使用者交給 Claude 的複製貼上提示,以及最常搞砸的一個陷阱。更深入的資料在參考檔案中 — 當某個階段變得複雜時,可以拿出來使用。

允許停止。 一個樸素的一頁式網站 — 他們的名字、關於他們的一行文字、一個連結 — 就是一個真實、完整的網站。如果他們在第 4 階段後就滿足了,那就完成了。第 5–6 階段是給那些想要更多的人準備的,而不是必須達到的門檻。


開始之前(Claude 可以幫助處理所有這些)

在第 1 階段之前,使用者需要準備好四項免費的東西。所有這些都可以透過請 Claude 帶他們一步一步完成 — 不要假設他們已經完成了任何一項:

  • Claude Code,已安裝並在專案資料夾中開啟。
  • Node.js + npm(適用於大多數現代技術棧)— Claude 可以用 node -v 檢查並安裝。
  • 一個 GitHub 帳號(免費)— 程式碼存放的地方,也是主機監控的地方。
  • 一個託管帳號 — Vercel、Netlify 或 Cloudflare Pages(免費方案很慷慨;有些即使免費也需要綁定信用卡 — 對於一般的個人網站不會收費)。

如果對其中任何一項不熟悉,第一個提示就應該是:

我從未設定過一個程式設計專案。請檢查 Node、npm 和 git 是否已安裝在我的機器上,然後一步一步帶我 — 一次一步 — 安裝缺少的東西,並建立免費的 GitHub 和 [Vercel/Netlify] 帳號。告訴我確切要點擊什麼,並在每一步等我。

快速入門(一個下午讓網站上線)

如果使用者想要立刻看到進展:

  1. 描繪出品味簡報。 詢問第 0 階段那五個問題;將答案寫成一個簡短的 BRIEF.md。(約 15 分鐘)
  2. 搭建並部署一個空殼。 選擇一個技術棧 + 一個推送即部署的主機(如果不確定,就說 Next.js + Vercel 然後繼續),用其官方 CLI 產生入門專案,推送到 GitHub,連接主機,並確認空白網站已在一個真實 URL 上線。(約 30 分鐘,第一次會更久 — 註冊帳號並將 GitHub 連接到主機會增加約 20–30 分鐘)
  3. 新增護欄檔案。 建立 AGENTS.md,告知 Claude 在寫程式碼之前必須閱讀已安裝的框架文檔(第 1 階段)。(約 2 分鐘)
  4. 只建立首屏(Hero)區域。 一個畫面:他們的名字、關於他們的一行文字、一個行動呼籲按鈕,使用簡報中的顏色。在瀏覽器中查看。(約 20 分鐘)
  5. 調整並提交。「把標題調大一點」、「背景更溫暖一些」,提交,推送 — 它現在上線了。(約 15 分鐘)

他們現在有了一個真實的網站,位於一個真實的 URL。之後的一切都是改進 — 簡單的部分。 (以上時間假設上述帳號已經存在;第一次設定會需要更多時間,這很正常,不是失敗。)


第 0 階段 — 規劃框架:品味與範圍

目標: 在開始建立任何元件之前,能夠用簡單的文字和圖片描述網站應該給人的感覺以及需要哪些頁面。

步驟

  • 訪問使用者。先不要設計;先萃取。問這五個問題:
    1. 它是為誰而設,你想讓他們做什麼或感受到什麼?(僱用你、購買這個、閱讀你的文章、「把我當一回事」、「看到我很有趣」)
    2. 用 2–3 個詞描述氛圍。(「溫暖且具編輯感」、「乾淨且技術感」、「大膽且玩心」、「安靜且昂貴」、「黑暗且粗獷」)。引導他們說出感覺,而不是功能。
    3. 給我看你喜歡的東西。 2–3 個網站的 URL,以及能捕捉到那種感覺的截圖、情緒板或任何圖片 — 大多數人的品味是視覺化的,而不是文字化的,所以讓他們貼圖片。再給一個他們討厭的網站。偷取結構和氛圍,但絕不偷取內容。
    4. 這個網站必須做好的那一件事是什麼?(文字、視覺效果、作品樣本、速度)
    5. 你實際需要哪些頁面/區塊? 抵制範圍蔓延 — 大多數個人網站只需要首頁加上一兩個頁面。
  • 將答案寫在一個 BRIEF.md 檔案中,放在儲存庫根目錄 — 這是你和 Claude 檢核的北極星。如果他們提供了圖片,記下要從每張圖片中汲取什麼。

交給 Claude 的提示

在我們開始建立任何東西之前,訪問我關於我想要的網站。一次問我一個問題:它是為誰而設,我希望訪客感受到什麼或做什麼;用 2–3 個詞描述氛圍;我喜歡的網站(我會貼上連結以及截圖/情緒板圖片 — 也要對圖片做出反應),加上一個我討厭的網站;這個網站必須做好的那一件事;以及我實際需要哪些頁面。然後將我的答案寫成一個 BRIEF.md 作為我的北極星。現在還不要寫任何網站程式碼。

陷阱: 在任何人能描述感覺之前就開始建造。如果他們無法說出氛圍或展示相關圖片,Claude 就會預設採用通用的 SaaS 模板,而之後的每一個修正都將對抗這種預設引力。先獲得感覺 — 用文字或圖片 — 再開始。


第 1 階段 — 基礎:讓一個空網站上線,然後加上護欄

目標: 一個空白但真實的網站,已經部署到一個真實 URL,並設定好自動部署 — 這樣之後的每個變更都能自動發布 — 再加上一個護欄,讓 Claude 始終基於真實資料。

你不需要知道如何做這些事情。 Claude 會給你確切的點擊步驟和指令,並在執行時等待你。當某個畫面讓你困惑時,截圖並貼回來 — 這就是整個工作流程,不是失敗。

步驟

  • 預先選擇技術棧和主機(見下方表格)。優先選擇由框架相同團隊開發的主機,這樣預設設定就能正常運作。任何一條路徑都可以;最差的選擇是花一整天來做選擇。
  • 使用框架的官方 CLI 來搭建專案,不要手動建立。
  • 先部署空的模板。 推送到 GitHub,連接主機,在修改任何程式碼之前確認空白網站已上線 — 這樣你可以在沒有其他東西會壞掉的時候,一次除錯完部署管道。
  • 如果他們有自訂網域,請及早設定(這才是真正的地址;免費的 *.host.app URL 只是暫時的)。DNS — 將網域名稱指向網站的設定 — 可能需要幾個小時才能生效,所以要及早開始。還沒有網域?主機提供的 URL 是一個很好的起點;之後再購買一個。
  • 加入真實資料護欄。 寫一個 AGENTS.md(以及一個只包含 @AGENTS.md 的 CLAUDE.md 檔案),告訴任何 AI 代理程式:已安裝的框架可能比其訓練資料更新,並且在寫程式碼之前必須閱讀 node_modules/<framework>/dist/docs 中的真實文檔。 這一個檔案可以防止一整類 API 幻覺錯誤。
  • 從一開始就將機密資訊排除在 Git 之外。 .gitignore 應排除環境變數檔案和建置輸出;絕不要提交 API 金鑰或私人地址 — 將它們保存在主機的環境設定中。請 Claude 在建立儲存庫時同時設定好這些。
  • 記錄 Claude 無法推斷的部署資訊: 正式環境 URL、主機、自動部署的分支、確切的儲存庫名稱、任何注意事項。儲存到一個 notes/memory 檔案中 — 線上網域通常無法從程式碼中發現。
  • 設定本地預覽和健康檢查: 一個執行配置(或記錄在案的 dev 指令 + port),以及一個快速檢查本地 URL 是否返回 HTTP 200 的方法,以便在推送之前進行檢查。

決策表 — 選擇一條路徑並繼續前進

如果網站是…合理的預設技術棧主機
作品集 / 個人網站 / 簡歷Next.js 或 AstroVercel / Netlify
主要是寫作 / 部落格Astro 或 Next.jsVercel / Netlify
單一的登陸/行銷頁面Astro 或 Vite + ReactNetlify / Cloudflare Pages
想要以純文字檔案手動編輯的東西純 HTML + CSS(無建置步驟)Netlify / CF / GitHub Pages
「我不知道,讓它動就好」Next.js + VercelVercel

(最後一行選擇 Next.js + Vercel 只是因為這是 Claude 最能參考的文檔最豐富的路徑 — 上面的每一條路徑都是同樣合理的。)

交給 Claude 的提示

使用其官方工具搭建一個全新的 [Next.js / Astro / 純 HTML+CSS] 網站,保持入門模板不變,然後帶我一步步完成:git init + 第一次提交(使用一個排除了環境變數/機密的 .gitignore)、建立一個 GitHub 儲存庫,以及連接 [Vercel / Netlify],這樣每次推送到 main 分支都會自動部署。在我們寫任何程式碼之前,先確認空網站已在一個真實 URL 上線。然後建立一個 AGENTS.md,告訴任何 AI 代理程式:已安裝的框架可能比其訓練資料更新,並且在寫程式碼之前必須閱讀 node_modules/[framework]/dist/docs 中的文檔。另外建立一個 CLAUDE.md,內容只包含 `@AGENTS.md`。最後,將我的正式環境 URL、主機、部署分支和儲存庫儲存到一個 notes 檔案。給我確切的點擊步驟,並在每一步等我。

陷阱: 在部署一次之前就建立整個網站(然後你會同時除錯程式碼和部署管道),或者信任模型對快速發展的框架的記憶,而不是將其固定在已安裝的文檔上。

→ 媒體、大小限制、編碼指令、驗證正式環境:references/PLAYBOOK.md。


第 2 階段 — 將你的設計語言編碼

目標: 一個書面、機器可讀的設計系統 — 顏色、字體、間距、動效、語調 — 讓使用者和 Claude 在每次工作階段都能參考,這樣每個新頁面都能保持一致,而不會慢慢偏離成五種略有不同的風格。

在你擁有一個你真正喜歡的頁面之後再做這件事,而不是之前。你是從好的東西萃取出系統,而不是在真空中創造它。

步驟

  • 先用文字命名氛圍,然後從中推導出所有規則。兩個簡短的詞組;如果兩個氛圍互相衝突,那麼這個衝突本身就成為一條規則。(某個真實專案的詞組是「溫暖的編輯感平靜 + 俏皮的像素工藝」— 但一個「安靜且昂貴」或「黑暗且粗獷」的網站會命名它自己的詞組,並推導出非常不同的規則。)
  • 有意識且一致地使用顏色。 一個克制的調色板 — 通常只有一個強調色 — 能讓層級保持清晰可讀,是安全的預設值。但如果品味是極繁主義、復古或粗獷風,那麼多色系統就是一個合理的選擇。規則不是「只能用一個強調色」,而是每個顏色都有一個定義好的角色,並且在任何地方都以相同的方式使用。
  • 顏色要使用角色命名的代碼(tokens),而不是在標記中散落十六進位碼。將淺色文字和邊框表達為一種墨色降低透明度,而不是發明五種近乎相同的灰色。
  • 按照角色組合字體,而不是按照字體名稱(內文/UI、標題/「聲音」、等寬字體、展示字體)。引用角色名稱,這樣實際字體可以在以後更改,而無需重寫。
  • 固定一個間距節奏和一個 z-index 階梯,並寫下「不要發明新的數值」。
  • 陳述一個符合氛圍的動效哲學:便宜的 CSS 環境動畫,JS 函式庫中的互動反饋;將非必要的動效限制在 prefers-reduced-motion 之後。
  • 設定一個無障礙基準線(這是品質的一部分,而不是附加功能):內文對比度 ≥ 4.5:1、真實的標題順序、可見的焦點狀態、語意化地標、有意義圖片的替代文字。一個大膽/暗色調色板正是對比度會悄悄失敗的地方。
  • 將語音和語調視為設計的一部分來記錄 — 文案也是外觀的一部分(使用句子大小寫?俏皮?簡單用語?沒有商業廢話?)。
  • 將其編碼到兩個已提交的檔案中: 一個散文式的 DESIGN_SYSTEM.md(原則 + 元件配方 + 建置檢查清單)和一個 tokens 檔案(原始數值)。將其標記為僅限未來使用 — 從現有頁面萃取,不是遷移目標 — 這樣 Claude 就不會「好心」地重構正常運作的程式碼。
  • 將其納入上下文: 在 CLAUDE.md 中引用它,讓 Claude 在每個工作階段開始時自動讀取它。

提示

請 Claude 從你喜歡的頁面萃取規則,而不是憑空編造規則。使用者的工作是看著結果並說「更像那樣」或「不,那不對」。


第 3 階段 — 擴展並填充:頁面、內容、媒體

目標: 實現第 0 階段定義的所有頁面和區塊,擁有真實的內容(複製貼上的文字也算,這比 Lorem Ipsum 好),以及一個可預測的流程來新增文章或專案。

步驟

  • 為內容建立一個階層 — 頁面樹、導覽、對每個頁面來說重要的部分。從首頁的內容區塊開始(關於、作品集、部落格文章列表、訂閱)並向外擴展。
  • 為每個頁面/區塊撰寫一個「設計配方」 — 它應該傳達什麼感覺,它與設計系統中的哪些部分相互作用,以及 Claude 在決定斷點行為時應使用哪些邏輯規則。
  • 填充真實內容 — 從 BRIEF.md 開始,並在 Claude 迭代時問使用者問題。文字可以使用 Markdown 撰寫,然後轉換為 JSX 或 HTML。圖片:使用良好的壓縮工具(如 Squoosh)進行最佳化,並透過回應式 srcset 載入。影片:考慮使用雲端託管和延遲載入。
  • 實現可預測的內容發布 — 一個每次都有效的流程(例如,npm run new-post、一個 CLI 腳本、資料夾約定)。對於部落格,從一個靜態的 posts/ 資料夾開始,然後再考慮內容管理系統。
  • 最佳化增益指標 — 在本機上一次針對一個核心網頁指標進行最佳化(CLS 是最容易修復的),但不要在開發中過度最佳化;在正式環境中測量。
  • 無障礙性重新檢查 — 使用瀏覽器開發者工具進行自動化檢查,並進行手動測試(鍵盤瀏覽、縮放、螢幕閱讀器)。

交給 Claude 的提示

根據我的 BRIEF.md 中的頁面清單,為我產生首頁的結構和每個部分的內容策略。與我一起逐步建立每個部分:先寫文字,然後設計樣式,然後連結它。永遠不要使用 Lorem Ipsum;要麼使用我的真實內容,要麼問我應該寫什麼。在我們完成一個部分並讓它在瀏覽器中看起來不錯之後,再繼續下一個部分。永遠不要一次改變多個東西。

陷阱: 在沒有任何內容的情況下設計頁面(然後文字不適合佈局),或者使用占位文字假裝它是真實的(然後永遠不會被替換)。


第 4 階段 — 迭代:改進 — 永遠的引擎

目標: 一個永遠不會停止的來回過程(從第 1 階段結束後就持續著),你看向網站,決定下一個最大的改進是什麼,讓 Claude 在一個小步驟中實現它,提交,然後在瀏覽器中查看。

這個階段建構了所有其他階段的節奏。這就是進步的樣子 — 不是里程碑,而是你可以看的點擊次數。

步驟

  • 看向網站 — 在瀏覽器中,在手機上,使用 Lighthouse。
  • 選擇一個改進 — 一個大小適中的變更(不是重寫)。
  • 向 Claude 描述它 — 使用感覺、圖片、參考資料。「這個區塊感覺太空了」、「標題在我的手機上斷行了」、「按鈕的懸停狀態應該與卡片其餘部分感覺不同」。
  • 讓 Claude 實施它 — 在一個步驟中完成。
  • 在瀏覽器中查看 — 如果喜歡,提交。如果不喜歡,回滾(git checkout -- .)或描述為什麼不喜歡。
  • 重複。

交給 Claude 的提示

這是我網站的截圖。根據我的設計系統和當前頁面,告訴我你看到的三到五個可能的改進,從最大影響到最小影響排列。然後我將選擇一個,你將在一個步驟中實現它,我們將在瀏覽器中查看它。

陷阱: 在一個晚上嘗試修正所有問題(然後搞壞一切且無法恢復),或著迷於 CSS 微調而從未新增內容。真實的網站 = 持續的小改進,而不是不完美的完美。

→ 常見改進工作、效能預算、無障礙檢查:references/PLAYBOOK.md。


第 5 階段 — 讓它令人難忘:精煉與個性

目標: 網站超越「乾淨且功能性強」,變成一款能顯示出是誰製作的東西 — 透過微互動、動畫、優質載入體驗,以及(如果適用的話)一點驚喜。在這個時候,大部分工作涉及將 CSS 和 JavaScript 使用的第三方程式庫最佳化。

步驟

  • 為動作增加微妙的動效(導覽中的 hover 過渡、手風琴的展開、頁面之間的過渡)。
  • 使用 prefers-reduced-motion 注意無障礙性。
  • 新增一個「載入」體驗 — 一個骨架螢幕或一個簡潔的載入動畫,而不是白色閃爍。
  • 自訂 404 頁面 — 結合品牌的東西。它應該有趣,不令人驚訝。
  • 實現可選的互動增強功能 — 滾動驅動的動畫(使用 Intersection Observer)、視差效果、遊標跟隨效果(謹慎使用,注意無障礙性)。
  • 更進一步的媒體: 回應式圖片、WebP/AVIF 格式、延遲載入、影片(如果有的話)使用雲端託管。
  • 檢查字體載入策略 — font-display: swap、子集化、預先載入關鍵字體。
  • 無障礙性深潛:這不僅僅是一個清單,而是一個心態。在螢幕閱讀器中導覽你的網站。確保自訂元件具有正確的 ARIA 角色和屬性。

交給 Claude 的提示

觀察我的網站,並提出三個能讓它感覺更精緻、更有個性的微互動或動畫。解釋每個動畫會在哪裡、如何實現,以及為什麼它適合我的設計系統。我將選擇一個來實施。

陷阱: 新增對效能或無障礙性有負面影響的動效。讓動效有目的性,不要只是為了炫耀。(並且在有人說「酷」的時候,他們已經在滾動到下一部分了 — 所以讓動效快速且微妙。)


第 6 階段 — 傾聽並成長:分析、搜尋引擎最佳化與未來

目標: 了解誰在訪問、他們在做什麼,並設定一個機制以根據反饋進行改進 — 無論是來自使用者還是你自己的想法。

步驟

  • 設定分析工具 — 隱私友好的 Google Analytics 替代方案(Plausible、Fathom、Umami)。對於靜態網站,請檢查主機提供的分析(Netlify Analytics、Vercel Analytics)。\n- 設定簡單的分析 — 測量頁面瀏覽量、跳出率和流量來源。\n- 實作基本搜尋引擎最佳化 — 就緒的 meta 標籤、標題、描述、Open Graph 圖片。\n- 提交給搜尋引擎 — 使用 Google Search Console、Bing Webmaster Tools 等。\n- 設定一個反饋機制 — 一個 Google 表單、一個按鈕(「回報問題」),或任何適合你風格的方式。\n- 文件化下一步 — 保留一個不斷增長的清單,記錄你下一步想要做的改進或功能。\n 提示

請 Claude 設定一個輕量級、私密的分析工具,並告訴你如何閱讀數據以做出下一步改進的決策。\n 陷阱: 在網站準備好之前就沉迷於數據。「分析」只有在當你使用它來決定接下來要做什麼時才有用。不要讓它在沒有行動的情況下只是收集灰塵。


參考檔案

深入的主題式材料,當某個階段變得複雜時可以取出(或在開始之前就找出來):


致謝

這是 Anselm Bradford 和社群集體努力的結晶,從「與 AI 一起進行以人為本的網站開發」中汲取智慧。感謝所有嘗試、分享他們的故事並幫助改善這個流程的人。

相關技能