⚠️ 優先閱讀:此技能目錄中的
PNPM_11_REQUIREMENTS.md。 網頁開發容器(Mike 用來預覽你網站的地方)自 2026-05-13 起使用 pnpm 11.1.1。每個新專案必須在 package.json 中宣告pnpm.onlyBuiltDependencies(至少包含["sharp"],適用於任何 Next.js 專案),否則開發伺服器將無法啟動。忽略此步驟會導致容器重啟循環、網站出現 502 錯誤,使用者會責怪你。閱讀此文件僅需 60 秒;忽視它後果自負。
網站建置工具 — 完整的 Next.js 網站技能
研究驅動、設計用心。每個決策都有數據支持,每個區塊都有研究依據。
何時使用此技能
使用者提出以下請求時觸發:
- 建立一個新網站
- 為他們的生意建立一個網站
- 開始一個新的網路專案
- "幫我做一個網站"
請勿用於:
- Canvas 頁面(請改用
canvas-web-design技能) - 編輯現有的網站專案(請遵循該專案的
.claude/CLAUDE.md) - Remotion 影片專案(請改用
remotion-video技能)
不可協商的規則
- 在完成研究與設計規劃之前,絕對不要撰寫程式碼。 階段 1-4 不會產出任何程式碼。這是正確的。
- 絕對不要提供帶有範本預設值的頁面。 如果你看到「Logo」、「(555) 000-0000」、「[email protected]」、「服務一」— 你失敗了。
- 未經關鍵字研究,絕對不要撰寫文案。 每個標題都必須針對階段 3 中的特定關鍵字。
- 絕對不要跳過設計計畫。 每個區塊、顏色和動畫都必須有記錄的理由。
- 絕對不要使用恐嚇策略或基於恐懼的標題。 撰寫以效益為重點、針對 SEO 的文案。
- 在呈現任何網站之前,務必執行佔位符號掃描。 零容忍。
- 務必自訂每個區塊。 如果某個區塊渲染了內建的預設值,表示你忘記傳遞 props 了。
- 絕對不要釋出會劫持返回按鈕的功能。 不要有
history.pushState循環、重新導向陷阱,或是阻止瀏覽器返回按鈕將使用者帶回搜尋結果頁面的模態框/覆蓋層連鎖 — 這是 Google 垃圾郵件政策違規(惡意行為,2026-06-15 起執行),會帶來手動處罰和排名降級的風險。請審查離開意圖腳本、插頁式廣告以及任何包含的廣告/函式庫程式碼(違規行為通常源自於此,而非第一方程式碼)。請在階段 12 中驗證。
網站類型
在需求收集階段進行識別 — 這會影響所有後續決策:
| 類型 | 目標 | 關鍵區塊 | 文案風格 |
|---|---|---|---|
| SEO 潛在客戶開發 | 排名 + 獲取潛在客戶 | 英雄區 + 信任欄 + 服務範圍網格 + 運作方式 + 常見問題 + 推薦 + 行動呼籲 | 關鍵字豐富、效益導向、專業 |
| 本地服務 | 電話 + 表單 | 英雄區 + 信任欄 + 服務 + 服務區域 + 評論 + 行動呼籲 | 直接、建立信任、鎖定地理位置 |
| 作品集 | 展示作品 | 英雄區 + 專案網格 + 關於 + 流程 + 聯絡方式 | 視覺化、文案極簡,讓作品說話 |
| SaaS / 產品 | 註冊 / 試用 | 英雄區 + 功能 + 定價 + 推薦 + 常見問題 + 行動呼籲 | 效益導向、比較驅動 |
本地服務網站:在建立任何居家服務或承包商網站之前,請先參閱下方的本地服務 CRO 規則一節。大多數本地網站的轉換率低於 1%。這些規則可以幫助提升至 3–5%。
本地服務 CRO 規則
來源:Noah Igler (@noahiglerSEO) 針對居家服務網站(水電工、暖通空調、屋頂工、電工、景觀設計師等)的轉換審計。大多數網站流量不錯,但電話不響 — 因為網站洩漏了潛在客戶,而不是流量。
大多數居家服務網站的轉換率低於 1%。這些規則旨在用相同的流量達到 3–5%。
折頁上方(80% 的轉換在這裡決定成敗)
在登陸後 3 秒內,訪客必須知道:你做什麼、你在哪裡服務、你值得信賴,以及如何打電話給你。以下每個元素都是必需的 — 不是可選的。
- 標題格式:
"[服務] 在 [城市]"或"[城市] 值得信賴的 [服務] 公司"— 不要用"您自 2003 年以來的居家服務合作夥伴" - 電話號碼: 右上角,大字型,隨著使用者滾動保持在頂部 — 直接使用
tel:連結(不要用模態框、彈出視窗或確認步驟 — 曾有一個客戶因為使用模態框而導致來電量下降 30%) - 信任欄 / 副標題: 星級評分 + 評論數量 + 營業年資 + 牌照號碼 + 服務區域 — 全部放在英雄區
- 主要行動呼籲:
"立即致電"或"取得免費報價"— 在按鈕上或緊鄰按鈕下方顯示電話號碼 - 英雄區圖片: 團隊穿著品牌制服的真實照片、工作現場的卡車或實際工作照 — 不要用微笑家庭的庫存照片(訪客一眼就能認出,信任感會瞬間轉為負面)
電話可見性 — 最大的單一槓桿
- 固定頂部標頭:手機號碼在使用者於行動裝置上滾動時始終可見
- 行動裝置上的固定底部欄:兩個按鈕 —
"立即致電"(tel: 連結)和"線上預約"— 始終在視野中 - 長頁面上的浮動動作按鈕
- 實際上可增加 15–25% 的來電量
表單 — 每個額外的欄位會減少約 10% 的轉換
任何居家服務潛在客戶表單最多 4 個欄位:
- 姓名
- 電話
- 所需服務(下拉選單 — 不要用自由文字欄位)
- 地址
永遠不要加入: 電子郵件、「最佳聯絡時間」、「您從何處得知我們」、評論框、地址驗證或任何資格審查問題。你不是在執行信用申請 — 你是在取得他們的電話號碼以便回電。資格審查應在通話中進行。
行動速度 — 不可協商
- 行動裝置 PageSpeed 低於 50 = 失去 2–3 個地圖排名位置
- 低於 70 = 在頁面載入完成前流失 20–30% 的行動訪客
- 目標:行動裝置 PageSpeed 70+,頁面載入時間 < 2 秒
速度修正(按影響程度排序):
- 將英雄區圖片壓縮至 200–400KB(大多數網站提供 2–3MB 的英雄圖片)
- 移除不必要的外掛程式和追蹤腳本
- 使用真正的 CDN(不僅是主機商提供的捆綁選項)
- 對折頁以下的所有內容進行延遲載入
- 最小化第三方小工具(即時聊天、社交嵌入、評論聚合器)— 它們載入緩慢並遮擋電話號碼
評論 / 社會證明 — 必須在每個滾動深度出現
不要將所有證明放在頁面中途的一個推薦區塊中。訪客需要在每個層級看到它:
- 折頁上方:
"來自 312 則 Google 評論的 4.9 星"— 英雄區信任欄中的數量 + 評分 - 英雄區: 2–3 則來自真實評論的簡短引言,最好是從 Google 商家檔案動態抓取
- 服務頁面: 專門的評論區塊,擷取提及該特定服務的評論引言
- 在表單旁邊: 在提出請求前再次重複證明
目標:在他們到達表單時,已經看過 5–6 次證明。
照片 — 真實照片永遠勝過庫存照片
- 團隊穿著品牌制服在工作現場的真實照片
- 停放在實際客戶家門口的卡車
- 前後對比照(水管清潔、配電盤工程、空調安裝、風管工程、屋頂更換)
- 拍攝並展示牌照文件、製造商認證、保險證明
- 網站看起來應該像一個有真實人員的實體企業,而不是行銷機構丟入 Logo 的範本
融資 — 高價服務($5K+)的必要選項
約 60% 的客戶在需要更換等級的工作時想要融資。如果你的競爭對手顯示 Synchrony / GreenSky / Wisetack 的標誌而你沒有,他們在你能報價之前就已經成交了。
- 在服務頁面的折頁上方顯示融資夥伴的標誌
- 在英雄區中標註
"提供 0% 利率融資"或"每月最低 $89 起" - 從主導覽列連結到獨立的融資頁面
- 在高價服務頁面嵌入預先資格審查小工具
扼殺轉換的常見錯誤
這些錯誤在審計中經常出現 — 不要提供任何以下內容:
- 較長的表單以「篩選」潛在客戶 — 你不是在篩選他們,而是在失去他們
- 隱藏電話號碼以強迫填寫表單 — 他們只會直接離開
- 英雄區自動播放影片 — 扼殺行動速度,惹惱訪客
- 首次訪問時的彈出視窗 — 在行動裝置上會立即觸發返回按鈕
- 即時聊天小工具 — 需要 4 秒載入,遮擋電話號碼,對居家服務毫無價值
技術棧(每個專案)
| 工具 | 套件 | 用途 |
|---|---|---|
| Next.js 15 | next | 應用程式路由器、伺服器元件、伺服器動作 |
| React 19 | react | UI 框架 |
| TypeScript | typescript | 型別安全 |
| Tailwind CSS v3 | tailwindcss | 工具優先樣式(v3 — 不是 v4,v4 有 PostCSS 問題) |
| shadcn/ui | shadcn (CLI) | 元件庫(Radix + Tailwind) |
| Motion | motion | 動畫(彈簧物理、滾動、佈局) |
| Lenis | lenis | 平滑滾動(< 4kb,可存取) |
| Lucide React | lucide-react | SVG 圖示 |
選用(需要時安裝)
| 工具 | 套件 | 使用時機 |
|---|---|---|
| Pretext | @chenglou/pretext | 無需 DOM 回流即可測量文字 — 虛擬化列表、聊天 UI、磚形網格、自動調整大小的文字容器、Canvas 文字渲染。比 getBoundingClientRect 快約 500 倍。無依賴項。請參閱 /mnt/shared-skills/pretext/SKILL.md |
| GSAP | gsap | 複雜的滾動序列、SplitText、MorphSVG |
| Three.js | three + @react-three/fiber | 3D 背景或英雄區元素 |
| MDX | @next/mdx | 具有豐富內容的部落格 |
| Prisma | prisma | 資料庫存取 |
13 階段工作流程
請依序遵循這些階段。不要跳過任何階段。階段 1-4 不會產出任何程式碼 — 它們會產出研究和計畫。這就是重點。
階段 1:探索
閱讀: instructions/brand-intake.md
在執行任何其他操作之前,先向客戶詢問品牌需求收集問題:
- 企業身分、產業、目標客戶
- 品牌顏色、語氣、個性
- SEO 目標、競爭者、客戶搜尋的內容
- 需要的頁面、特殊功能、主要行動呼籲
- 網站類型(SEO 潛在客戶開發、本地服務、作品集、SaaS)
交付物: 完成的需求收集答案
階段 2:設定
閱讀: instructions/folder-setup.md
在專案目錄內建立 ai/ 資料夾結構:
- 建立所有研究目錄(01-07)
- 建立設計、內容和部落格研究目錄
- 初始化
research-status.json - 從需求收集答案填入
01-business-profile/profile.md
交付物: 完整的 ai/ 資料夾結構,並填入商業檔案
階段 3:研究(基礎 — 不要急)
閱讀: instructions/research-plan.md
六項研究任務,影響後續的一切:
-
關鍵字研究 — 在主要、次要、長尾、地理位置類別中找出 50-100+ 個關鍵字。記錄在
ai/research/02-keyword-research/中。搜尋 Google,擷取「其他人也問」問題,建立關鍵字群集。 -
競爭者深度分析 — 詳細審查 5-10 個競爭者網站。針對每個網站:記錄其首頁區塊、英雄區佈局、行動呼籲、視覺設計、字體排版、動畫、內容品質、優勢、劣勢。在
ai/research/03-competitor-analysis/site-reviews/中建立每個競爭者的審查檔案。然後綜整成pattern-analysis.md(利基市場中的常見模式)和gaps-opportunities.md(我們可以利用的缺口)。 -
內容策略 — 對應每個頁面:網址、關鍵字、區塊、H1、中繼標籤。在
ai/research/04-content-strategy/content-briefs/中為每個頁面建立內容簡報。從「其他人也問」、Reddit、論壇研究常見問題。 -
主題地圖 — 建立主題群集架構:支柱頁面、群集內容、內部連結策略。記錄在
ai/research/05-topical-map/中。 -
本地 SEO(如適用) — 目標服務區域、本地競爭者、城市特定關鍵字。記錄在
ai/research/06-local-seo/中。 -
轉換模式 — 分析競爭者的行動呼籲、信任訊號、社會證明模式。繪製轉換漏斗。記錄在
ai/research/07-conversion-patterns/中。
交付物: 跨 7 個目錄的 20-40 個研究檔案。更新 research-status.json。
階段 4:設計計畫(思考階段 — 每個決定都有用意)
閱讀: instructions/design-plan.md
這是網站從「另一個範本」變成「有效用」的關鍵階段。六份設計文件:
-
競爭者視覺審計 (
ai/design/competitor-visual-audit.md) — 審查所有競爭者網站的視覺模式:英雄區類型、區塊順序、配色方案、字體排版、動畫、攝影風格。根據視覺品質對它們進行排名。找出需要超越的目標。 -
風格方向 (
ai/design/style-direction.md) — 附帶理由選擇美學。顏色、字型、深色/淺色模式、間距 — 每個選擇都追溯到品牌需求收集 + 競爭者分析 + 產業背景。 -
元件計畫 (
ai/design/component-plan.md) — 需要的每個元件,按順序,附帶其用途。為什麼用這個英雄區佈局?為什麼用這種信任欄樣式?為什麼這些區塊按這個順序排列?對應到轉換漏斗。 -
動畫計畫 (
ai/design/animation-plan.md) — 什麼會動、為什麼、如何動。進場動畫、懸停狀態、滾動效果。有意義的動畫,不是隨機的裝飾。 -
頁面線框圖 (
ai/design/page-wireframes.md) — 每個頁面逐區塊的佈局。使用 ASCII 線框圖顯示結構。 -
設計摘要 (
ai/design/design-brief.md) — 主文件。總結所有設計決策,列出這個網站相對於競爭者的「亮點」,將每個選擇與研究連結起來。
交付物: 6 份設計文件。設計摘要是整個建置過程的參考。
階段 5:搭建骨架
閱讀: instructions/architecture.md
使用: templates/project/ 目錄
- 將
templates/project/複製到Websites/<project-name>/ - 執行
pnpm install - 安裝 shadcn:
pnpm dlx shadcn@latest init - 安裝核心 shadcn 元件:
pnpm dlx shadcn@latest add button card badge separator input textarea label - 安裝動畫依賴項:
pnpm add motion lenis - 初始化 git,提交骨架
- 建立私有 GitHub 儲存庫,推送,建立
web-dev分支 - 使用
templates/config/claude-project.md填入.claude/CLAUDE.md
階段 6:設計系統
閱讀: instructions/design-system.md
使用: templates/config/desi
... [已截斷以利翻譯]