Communitygithub.com

MCERQUA/jam-skills

從零開始打造可上線的 Next.js 15 網站 — 研究優先的工作流程:探索 → 深度研究(關鍵字、競爭者、內容策略、主題地圖)→ 設計規劃 → 搭建骨架 → 建置 → 部署。觸發詞:『建立網站』、『為我的生意建立網站』、開始一個新的網路專案。請勿在編輯現有網站(網頁開發)或單篇文章(文章寫手)時觸發。

jam-skills 是什麼?

這是一個專為 AI 代理(如 Claude Code)設計的專業技能,用於從零開始建立生產級 Next.js 15 網站。它強制執行嚴謹的 13 階段工作流程,從探索與深度研究(關鍵字、競爭者、內容策略)開始,然後進行設計規劃,最後才撰寫任何程式碼。該技能支援多種網站類型,包括 SEO 潛在客戶開發、本地服務、作品集和 SaaS 產品,並為本地服務網站提供詳細的轉換率優化(CRO)規則,以提升來電與表單轉換率。技術棧固定為 Next.js 15、React 19、TypeScript、Tailwind CSS v3、shadcn/ui、Motion 動畫庫和 Lenis 平滑捲動,並包含一個關鍵的 PNPM 11 需求檢查,以防止開發伺服器啟動失敗。整個流程以研究驅動,確保每個設計與內容決策都有數據支持,最終產出高品質、SEO 友善且轉換率優化的網站。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/MCERQUA/jam-skills/tree/HEAD/website-builder

在你喜歡的 AI 中提問

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

說明文件

⚠️ 優先閱讀:此技能目錄中的 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. 在完成研究與設計規劃之前,絕對不要撰寫程式碼。 階段 1-4 不會產出任何程式碼。這是正確的。
  2. 絕對不要提供帶有範本預設值的頁面。 如果你看到「Logo」、「(555) 000-0000」、「[email protected]」、「服務一」— 你失敗了。
  3. 未經關鍵字研究,絕對不要撰寫文案。 每個標題都必須針對階段 3 中的特定關鍵字。
  4. 絕對不要跳過設計計畫。 每個區塊、顏色和動畫都必須有記錄的理由。
  5. 絕對不要使用恐嚇策略或基於恐懼的標題。 撰寫以效益為重點、針對 SEO 的文案。
  6. 在呈現任何網站之前,務必執行佔位符號掃描。 零容忍。
  7. 務必自訂每個區塊。 如果某個區塊渲染了內建的預設值,表示你忘記傳遞 props 了。
  8. 絕對不要釋出會劫持返回按鈕的功能。 不要有 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 個欄位:

  1. 姓名
  2. 電話
  3. 所需服務(下拉選單 — 不要用自由文字欄位)
  4. 地址

永遠不要加入: 電子郵件、「最佳聯絡時間」、「您從何處得知我們」、評論框、地址驗證或任何資格審查問題。你不是在執行信用申請 — 你是在取得他們的電話號碼以便回電。資格審查應在通話中進行。

行動速度 — 不可協商

  • 行動裝置 PageSpeed 低於 50 = 失去 2–3 個地圖排名位置
  • 低於 70 = 在頁面載入完成前流失 20–30% 的行動訪客
  • 目標:行動裝置 PageSpeed 70+,頁面載入時間 < 2 秒

速度修正(按影響程度排序):

  1. 將英雄區圖片壓縮至 200–400KB(大多數網站提供 2–3MB 的英雄圖片)
  2. 移除不必要的外掛程式和追蹤腳本
  3. 使用真正的 CDN(不僅是主機商提供的捆綁選項)
  4. 對折頁以下的所有內容進行延遲載入
  5. 最小化第三方小工具(即時聊天、社交嵌入、評論聚合器)— 它們載入緩慢並遮擋電話號碼

評論 / 社會證明 — 必須在每個滾動深度出現

不要將所有證明放在頁面中途的一個推薦區塊中。訪客需要在每個層級看到它:

  • 折頁上方: "來自 312 則 Google 評論的 4.9 星" — 英雄區信任欄中的數量 + 評分
  • 英雄區: 2–3 則來自真實評論的簡短引言,最好是從 Google 商家檔案動態抓取
  • 服務頁面: 專門的評論區塊,擷取提及該特定服務的評論引言
  • 在表單旁邊: 在提出請求前再次重複證明

目標:在他們到達表單時,已經看過 5–6 次證明。

照片 — 真實照片永遠勝過庫存照片

  • 團隊穿著品牌制服在工作現場的真實照片
  • 停放在實際客戶家門口的卡車
  • 前後對比照(水管清潔、配電盤工程、空調安裝、風管工程、屋頂更換)
  • 拍攝並展示牌照文件、製造商認證、保險證明
  • 網站看起來應該像一個有真實人員的實體企業,而不是行銷機構丟入 Logo 的範本

融資 — 高價服務($5K+)的必要選項

約 60% 的客戶在需要更換等級的工作時想要融資。如果你的競爭對手顯示 Synchrony / GreenSky / Wisetack 的標誌而你沒有,他們在你能報價之前就已經成交了。

  • 在服務頁面的折頁上方顯示融資夥伴的標誌
  • 在英雄區中標註 "提供 0% 利率融資" 或 "每月最低 $89 起"
  • 從主導覽列連結到獨立的融資頁面
  • 在高價服務頁面嵌入預先資格審查小工具

扼殺轉換的常見錯誤

這些錯誤在審計中經常出現 — 不要提供任何以下內容:

  • 較長的表單以「篩選」潛在客戶 — 你不是在篩選他們,而是在失去他們
  • 隱藏電話號碼以強迫填寫表單 — 他們只會直接離開
  • 英雄區自動播放影片 — 扼殺行動速度,惹惱訪客
  • 首次訪問時的彈出視窗 — 在行動裝置上會立即觸發返回按鈕
  • 即時聊天小工具 — 需要 4 秒載入,遮擋電話號碼,對居家服務毫無價值

技術棧(每個專案)

工具套件用途
Next.js 15next應用程式路由器、伺服器元件、伺服器動作
React 19reactUI 框架
TypeScripttypescript型別安全
Tailwind CSS v3tailwindcss工具優先樣式(v3 — 不是 v4,v4 有 PostCSS 問題)
shadcn/uishadcn (CLI)元件庫(Radix + Tailwind)
Motionmotion動畫(彈簧物理、滾動、佈局)
Lenislenis平滑滾動(< 4kb,可存取)
Lucide Reactlucide-reactSVG 圖示

選用(需要時安裝)

工具套件使用時機
Pretext@chenglou/pretext無需 DOM 回流即可測量文字 — 虛擬化列表、聊天 UI、磚形網格、自動調整大小的文字容器、Canvas 文字渲染。比 getBoundingClientRect 快約 500 倍。無依賴項。請參閱 /mnt/shared-skills/pretext/SKILL.md
GSAPgsap複雜的滾動序列、SplitText、MorphSVG
Three.jsthree + @react-three/fiber3D 背景或英雄區元素
MDX@next/mdx具有豐富內容的部落格
Prismaprisma資料庫存取

13 階段工作流程

請依序遵循這些階段。不要跳過任何階段。階段 1-4 不會產出任何程式碼 — 它們會產出研究和計畫。這就是重點。

階段 1:探索

閱讀: instructions/brand-intake.md

在執行任何其他操作之前,先向客戶詢問品牌需求收集問題:

  • 企業身分、產業、目標客戶
  • 品牌顏色、語氣、個性
  • SEO 目標、競爭者、客戶搜尋的內容
  • 需要的頁面、特殊功能、主要行動呼籲
  • 網站類型(SEO 潛在客戶開發、本地服務、作品集、SaaS)

交付物: 完成的需求收集答案

階段 2:設定

閱讀: instructions/folder-setup.md

在專案目錄內建立 ai/ 資料夾結構:

  1. 建立所有研究目錄(01-07)
  2. 建立設計、內容和部落格研究目錄
  3. 初始化 research-status.json
  4. 從需求收集答案填入 01-business-profile/profile.md

交付物: 完整的 ai/ 資料夾結構,並填入商業檔案

階段 3:研究(基礎 — 不要急)

閱讀: instructions/research-plan.md

六項研究任務,影響後續的一切:

  1. 關鍵字研究 — 在主要、次要、長尾、地理位置類別中找出 50-100+ 個關鍵字。記錄在 ai/research/02-keyword-research/ 中。搜尋 Google,擷取「其他人也問」問題,建立關鍵字群集。

  2. 競爭者深度分析 — 詳細審查 5-10 個競爭者網站。針對每個網站:記錄其首頁區塊、英雄區佈局、行動呼籲、視覺設計、字體排版、動畫、內容品質、優勢、劣勢。在 ai/research/03-competitor-analysis/site-reviews/ 中建立每個競爭者的審查檔案。然後綜整成 pattern-analysis.md(利基市場中的常見模式)和 gaps-opportunities.md(我們可以利用的缺口)。

  3. 內容策略 — 對應每個頁面:網址、關鍵字、區塊、H1、中繼標籤。在 ai/research/04-content-strategy/content-briefs/ 中為每個頁面建立內容簡報。從「其他人也問」、Reddit、論壇研究常見問題。

  4. 主題地圖 — 建立主題群集架構:支柱頁面、群集內容、內部連結策略。記錄在 ai/research/05-topical-map/ 中。

  5. 本地 SEO(如適用) — 目標服務區域、本地競爭者、城市特定關鍵字。記錄在 ai/research/06-local-seo/ 中。

  6. 轉換模式 — 分析競爭者的行動呼籲、信任訊號、社會證明模式。繪製轉換漏斗。記錄在 ai/research/07-conversion-patterns/ 中。

交付物: 跨 7 個目錄的 20-40 個研究檔案。更新 research-status.json。

階段 4:設計計畫(思考階段 — 每個決定都有用意)

閱讀: instructions/design-plan.md

這是網站從「另一個範本」變成「有效用」的關鍵階段。六份設計文件:

  1. 競爭者視覺審計 (ai/design/competitor-visual-audit.md) — 審查所有競爭者網站的視覺模式:英雄區類型、區塊順序、配色方案、字體排版、動畫、攝影風格。根據視覺品質對它們進行排名。找出需要超越的目標。

  2. 風格方向 (ai/design/style-direction.md) — 附帶理由選擇美學。顏色、字型、深色/淺色模式、間距 — 每個選擇都追溯到品牌需求收集 + 競爭者分析 + 產業背景。

  3. 元件計畫 (ai/design/component-plan.md) — 需要的每個元件,按順序,附帶其用途。為什麼用這個英雄區佈局?為什麼用這種信任欄樣式?為什麼這些區塊按這個順序排列?對應到轉換漏斗。

  4. 動畫計畫 (ai/design/animation-plan.md) — 什麼會動、為什麼、如何動。進場動畫、懸停狀態、滾動效果。有意義的動畫,不是隨機的裝飾。

  5. 頁面線框圖 (ai/design/page-wireframes.md) — 每個頁面逐區塊的佈局。使用 ASCII 線框圖顯示結構。

  6. 設計摘要 (ai/design/design-brief.md) — 主文件。總結所有設計決策,列出這個網站相對於競爭者的「亮點」,將每個選擇與研究連結起來。

交付物: 6 份設計文件。設計摘要是整個建置過程的參考。

階段 5:搭建骨架

閱讀: instructions/architecture.md 使用: templates/project/ 目錄

  1. 將 templates/project/ 複製到 Websites/<project-name>/
  2. 執行 pnpm install
  3. 安裝 shadcn:pnpm dlx shadcn@latest init
  4. 安裝核心 shadcn 元件:pnpm dlx shadcn@latest add button card badge separator input textarea label
  5. 安裝動畫依賴項:pnpm add motion lenis
  6. 初始化 git,提交骨架
  7. 建立私有 GitHub 儲存庫,推送,建立 web-dev 分支
  8. 使用 templates/config/claude-project.md 填入 .claude/CLAUDE.md

階段 6:設計系統

閱讀: instructions/design-system.md 使用: templates/config/desi

... [已截斷以利翻譯]

相關技能