Communitygithub.com

MCERQUA/jam-skills

从零开始构建生产级 Next.js 15 网站——以研究为先的工作流程:发现→深度研究(关键词、竞争对手、内容策略、主题图谱)→设计规划→脚手架搭建→构建→部署。触发关键词:'建一个网站'、'为我的企业创建一个网站'、开始一个新的网络项目。请勿因编辑现有网站(web-dev)或单篇文章(article-writer)而触发。

jam-skills 是什么?

此技能为 Claude Code 或类似 AI 代理提供了一个端到端的、13 个阶段的网站构建工作流程,专注于使用 Next.js 15、React 19、TypeScript、Tailwind CSS v3 和 shadcn/ui 创建生产级网站。在执行任何代码之前,它强调一个彻底的研究优先方法(阶段 1-4),要求进行关键词研究、竞争对手分析、内容策略和设计规划,以确保每个决策都有数据支持。该技能提供了专门针对本地服务网站的详细转化率优化 (CRO) 规则,例如显眼的电话号码展示、简短的表格和真实的图片,旨在将转化率从低于 1% 提高到 3-5%。它还强制执行关键规则,包括禁止模板默认值、无基于恐惧的文案、无返回按钮劫持,并在部署前进行占位符清扫。该技能支持多种网站类型(SEO 潜在客户生成、本地服务、作品集、SaaS/产品)并包括一个内存系统,通过分类、标签和完整搜索保留项目知识和跨项目学习。

兼容平台✓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。 自 2026-05-13 起,Webdev 容器(Mike 预览您的网站的地方)运行 pnpm 11.1.1。每个新项目都必须在 package.json 中声明 pnpm.onlyBuiltDependencies(至少包括:任何 Next.js 项目都需要 ["sharp"]),否则开发服务器将无法启动。跳过此步骤会导致容器重启循环,网站返回 502 错误,用户会责怪您。60 秒阅读,忽视后果自负。

网站构建器 — 完整的 Next.js 网站技能

以研究为驱动、注重设计的网站构建。每个决策都有数据支持,每个部分都有研究依据。

何时使用此技能

在用户要求以下内容时触发:

  • 构建一个新网站
  • 为他们的企业创建一个网站
  • 开始一个新的网络项目
  • “给我做个网站”

请勿用于:

  • Canvas 页面(改用 canvas-web-design 技能)
  • 编辑现有的网站项目(请遵循该项目的 .claude/CLAUDE.md)
  • Remotion 视频项目(改用 remotion-video 技能)

不可协商的规则

  1. 在完成研究和设计规划之前,绝不能编写代码。 阶段 1-4 不产生任何代码。这是正确的做法。
  2. 绝不能交付带有模板默认值的页面。 如果你看到“Logo”、“(555) 000-0000”、“[email protected]”、“Service One”——那你就失败了。
  3. 绝不在没有关键词研究的情况下编写文案。 每个标题都应针对阶段 3 中的特定关键词。
  4. 绝不能跳过设计规划。 每个部分、每种颜色、每个动画都必须有记录在案的理由。
  5. 绝不能使用恐吓策略或基于恐惧的标题。 编写以利益为重点、针对 SEO 的文案。
  6. 在展示任何网站之前,务必执行占位符清扫。 零容忍。
  7. 务必自定义每个部分。 如果某个部分渲染了内置默认值,说明你忘了传递 props。
  8. 绝不能输出返回按钮劫持。 不允许 history.pushState 循环、重定向陷阱、或阻止浏览器返回按钮将用户返回 SERP 的模态框/覆盖层链——这是 Google 垃圾邮件政策(恶意行为,自 2026-06-15 起强制执行),会带来手动操作和排名降级的风险。审计退出意图脚本、插页广告和任何包含的广告/库代码(违规行为通常源于此处,而非第一方代码)。在阶段 12 进行验证。(developers.google.com/search/blog/2026/04/back-button-hijacking)

网站类型

在需求采集阶段进行识别——这会影响所有后续工作:

类型目标关键部分文案风格
SEO 潜在客户生成排名 + 捕获潜在客户Hero + TrustBar + CoverageGrid + HowItWorks + FAQ + Testimonials + CTA关键词丰富,以利益为重,专业
本地服务电话呼叫 + 表单Hero + TrustBar + Services + ServiceAreas + Reviews + CTA直接,建立信任,针对地理位置
作品集展示作品Hero + ProjectGrid + About + Process + Contact视觉化,最少文案,让作品说话
SaaS / 产品注册 / 试用Hero + Features + Pricing + Testimonials + FAQ + CTA以利益为重,对比驱动

本地服务网站:在构建任何家庭服务或承包商网站之前,请先参阅下面的本地服务 CRO 规则。大多数本地网站的转化率低于 1%。这些规则可以达到 3-5%。


本地服务 CRO 规则

来源:Noah Igler (@noahiglerSEO) 对家庭服务网站(水管工、暖通空调、屋顶工、电工、景观设计师等)的转化率审计。大多数网站流量不错,但电话不响——因为网站泄露的是潜在客户,而不是流量。

大多数家庭服务网站的转化率低于 1%。这些规则的目标是,在相同流量下达到 3-5%。

首屏(80% 的转化在此处决定成败)

在着陆后的 3 秒内,访客必须知道:你做什么、你在哪里做、你值得信赖、以及如何打电话给你。以下是每个必需元素——不是可选的。

  • 标题格式: "[服务] in [城市]" 或 "[城市]'s Trusted [服务] Company"——而不是 "Your Trusted Home Service Partner Since 2003"
  • 电话号码: 右上角,大字体,随着用户滚动固定——直接链接到 tel:(没有模态框、没有弹窗、没有确认步骤——一个模态框曾导致一位客户电话量下降 30%)
  • 信任栏 / 副标题: 星级评分 + 评论数量 + 经营年限 + 许可证号 + 服务区域——所有这些都在 Hero 区域中
  • 主要 CTA: "立即致电" 或 "获取免费报价"——在按钮上或紧挨其下方显示电话号码
  • Hero 图片: 您的团队穿着品牌衬衫、卡车停在工地或实际工作的真实照片——不要使用面带微笑的家人照片库(访客一眼就能认出;信任感立刻转为负面)

电话可见性——最大的单一杠杆

  • 粘性标题:用户在移动设备上滚动时,电话号码始终可见
  • 移动设备上的粘性底部栏:两个按钮——"立即致电"(tel: 链接)和 "在线预订"——始终在视线内
  • 长页面上的浮动操作按钮
  • 实践证明可增加 15-25% 的通话量

表单——每增加一个额外字段大约会损失 ~10% 的转化

任何家庭服务潜在客户表单最多 4 个字段:

  1. 姓名
  2. 电话
  3. 所需服务(下拉菜单——不是自由文本)
  4. 地址

永远不要添加: 电子邮件、“最佳联系时间”、“您是如何听说我们的”、评论框、地址证明或任何筛选问题。你不是在运行信用申请——你是在获取他们的电话号码以便回电。筛选工作应在通话中进行。

移动端速度——不可协商

  • 移动端 PageSpeed 低于 50 = 在地图包中失去 2-3 个位置
  • 低于 70 = 在页面加载前失去 20-30% 的移动端访客
  • 目标: 移动端 PageSpeed 70+,页面加载时间 < 2 秒

速度修复(按影响排序):

  1. 将 Hero 图片压缩到 200-400KB(大多数网站提供 2-3MB 的 Hero 图片)
  2. 移除不必要的插件和跟踪脚本
  3. 使用真正的 CDN(而不仅仅是主机捆绑的选项)
  4. 延迟加载首屏以下的所有内容
  5. 最小化第三方小部件(在线聊天、社交嵌入、评论聚合器)——它们加载缓慢并会遮挡电话号码

评论 / 社交证明——必须在每个滚动深度出现

不要将所有的证明都放在中间某个地方的单一推荐部分。访客需要在每个层面看到它:

  • 首屏: "来自 312 条 Google 评论的 4.9 星"——在 Hero 的信任栏中显示数量 + 评分
  • Hero 部分: 2-3 条来自真实评论的简短引用,最好从 GBP 动态获取
  • 服务页面: 专门的评论部分,提取提到该特定服务的引用
  • 表单旁边: 在请求之前重复证明

目标:到他们到达表单时,他们已经看到了 5-6 次证明。

照片——真实图片永远优于素材库

  • 团队成员穿着品牌衬衫在工地的真实照片
  • 停在真实客户家中的卡车
  • 前后对比照片(管道疏通、面板工作、空调安装、管道工程、屋顶更换)
  • 拍摄并显示许可证文件、制造商认证、保险证书
  • 网站看起来应该像一个拥有真实人员的实体企业,而不是一个营销机构放入 Logo 的模板

融资——高价值服务($5K+)必需

~60% 的更换级工作客户想要融资。如果你的竞争对手显示了 Synchrony / GreenSky / Wisetack 的 Logo 而你没有,他们在你报价之前就成交了。

  • 服务页面首屏可看到融资合作伙伴的 Logo
  • Hero 中有 "提供 0% 融资" 或 "月付低至 $89" 的标注
  • 主导航链接到单独的融资页面
  • 在高价值服务页面上嵌入预资格小部件

会扼杀转化的常见错误

这些在审计中频繁出现——不要输出其中任何一个:

  • 为了“筛选”潜在客户而使用更长的表单——你并不是在筛选他们,而是在失去他们
  • 隐藏电话号码以强制填写表单——他们只会直接离开
  • 在 Hero 部分自动播放视频——降低移动端速度,惹恼访客
  • 首次访问时的弹窗——移动端立即触发返回按钮
  • 在线聊天小部件——加载需要 4 秒,遮挡电话号码,对家庭服务毫无价值

技术栈(每个项目)

工具包用途
Next.js 15nextApp Router、服务器组件、服务器操作
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 背景或 Hero 元素
MDX@next/mdx包含丰富内容的博客
Prismaprisma数据库访问

13 阶段工作流程

请按顺序遵循这些阶段。不要跳过任何阶段。阶段 1-4 产生零代码——它们产生研究和计划。这正是关键。

阶段 1:发现

阅读: instructions/brand-intake.md

在任何其他事情之前,先向客户询问品牌需求采集问题:

  • 业务身份、行业、目标客户
  • 品牌颜色、语调、个性
  • SEO 目标、竞争对手、客户搜索什么
  • 所需页面、特殊功能、主要 CTA
  • 网站类型(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,捕获 PAA 问题,构建关键词集群。

  2. 竞争对手深度分析 — 详细审查 5-10 个竞争对手网站。针对每个网站:记录其首页部分、Hero 布局、CTA、视觉设计、排版、动画、内容质量、优势、劣势。在 ai/research/03-competitor-analysis/site-reviews/ 中为每个竞争对手创建审查文件。然后综合成 pattern-analysis.md(小众中的常见模式)和 gaps-opportunities.md(我们需要利用什么)。

  3. 内容策略 — 映射每个页面:URL、关键词、部分、H1、元标签。在 ai/research/04-content-strategy/content-briefs/ 中为每个页面创建内容简报。从 PAA、Reddit、论坛研究 FAQ 问题。

  4. 主题图谱 — 构建主题集群架构:支柱页面、集群内容、内部链接策略。记录在 ai/research/05-topical-map/ 中。

  5. 本地 SEO(如适用)— 目标服务区域、本地竞争对手、特定城市关键词。记录在 ai/research/06-local-seo/ 中。

  6. 转化模式 — 分析竞争对手的 CTA、信任信号、社交证明模式。映射转化漏斗。记录在 ai/research/07-conversion-patterns/ 中。

交付物: 分布在 7 个目录中的 20-40 个研究文件。更新 research-status.json。

阶段 4:设计规划(思考阶段——每个决策都有意为之)

阅读: instructions/design-plan.md

这是网站从“另一个模板”转变为真正有效的网站的阶段。六个设计文档:

  1. 竞争对手视觉审计 (ai/design/competitor-visual-audit.md) — 审查所有竞争对手网站的视觉模式:Hero 类型、部分顺序、配色方案、排版、动画、摄影风格。根据视觉质量对其进行排名。确定需要超越的目标。

  2. 风格方向 (ai/design/style-direction.md) — 选择美学风格并说明理由。颜色、字体、深色/浅色模式、间距——每个选择都追溯到品牌需求采集 + 竞争对手分析 + 行业背景。

  3. 组件计划 (ai/design/component-plan.md) — 每个需要的组件,按顺序排列,及其用途。为什么使用这种 Hero 布局?为什么使用这种信任栏样式?为什么这些部分按此顺序排列?映射到转化漏斗。

  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...

...(内容已截断以用于翻译)

相关技能