⚠️ 请先阅读:本技能目录中的
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-4 不产生任何代码。这是正确的做法。
- 绝不能交付带有模板默认值的页面。 如果你看到“Logo”、“(555) 000-0000”、“[email protected]”、“Service One”——那你就失败了。
- 绝不在没有关键词研究的情况下编写文案。 每个标题都应针对阶段 3 中的特定关键词。
- 绝不能跳过设计规划。 每个部分、每种颜色、每个动画都必须有记录在案的理由。
- 绝不能使用恐吓策略或基于恐惧的标题。 编写以利益为重点、针对 SEO 的文案。
- 在展示任何网站之前,务必执行占位符清扫。 零容忍。
- 务必自定义每个部分。 如果某个部分渲染了内置默认值,说明你忘了传递 props。
- 绝不能输出返回按钮劫持。 不允许
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 个字段:
- 姓名
- 电话
- 所需服务(下拉菜单——不是自由文本)
- 地址
永远不要添加: 电子邮件、“最佳联系时间”、“您是如何听说我们的”、评论框、地址证明或任何筛选问题。你不是在运行信用申请——你是在获取他们的电话号码以便回电。筛选工作应在通话中进行。
移动端速度——不可协商
- 移动端 PageSpeed 低于 50 = 在地图包中失去 2-3 个位置
- 低于 70 = 在页面加载前失去 20-30% 的移动端访客
- 目标: 移动端 PageSpeed 70+,页面加载时间 < 2 秒
速度修复(按影响排序):
- 将 Hero 图片压缩到 200-400KB(大多数网站提供 2-3MB 的 Hero 图片)
- 移除不必要的插件和跟踪脚本
- 使用真正的 CDN(而不仅仅是主机捆绑的选项)
- 延迟加载首屏以下的所有内容
- 最小化第三方小部件(在线聊天、社交嵌入、评论聚合器)——它们加载缓慢并会遮挡电话号码
评论 / 社交证明——必须在每个滚动深度出现
不要将所有的证明都放在中间某个地方的单一推荐部分。访客需要在每个层面看到它:
- 首屏:
"来自 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 15 | next | App Router、服务器组件、服务器操作 |
| 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 背景或 Hero 元素 |
| MDX | @next/mdx | 包含丰富内容的博客 |
| Prisma | prisma | 数据库访问 |
13 阶段工作流程
请按顺序遵循这些阶段。不要跳过任何阶段。阶段 1-4 产生零代码——它们产生研究和计划。这正是关键。
阶段 1:发现
阅读: instructions/brand-intake.md
在任何其他事情之前,先向客户询问品牌需求采集问题:
- 业务身份、行业、目标客户
- 品牌颜色、语调、个性
- SEO 目标、竞争对手、客户搜索什么
- 所需页面、特殊功能、主要 CTA
- 网站类型(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,捕获 PAA 问题,构建关键词集群。 -
竞争对手深度分析 — 详细审查 5-10 个竞争对手网站。针对每个网站:记录其首页部分、Hero 布局、CTA、视觉设计、排版、动画、内容质量、优势、劣势。在
ai/research/03-competitor-analysis/site-reviews/中为每个竞争对手创建审查文件。然后综合成pattern-analysis.md(小众中的常见模式)和gaps-opportunities.md(我们需要利用什么)。 -
内容策略 — 映射每个页面:URL、关键词、部分、H1、元标签。在
ai/research/04-content-strategy/content-briefs/中为每个页面创建内容简报。从 PAA、Reddit、论坛研究 FAQ 问题。 -
主题图谱 — 构建主题集群架构:支柱页面、集群内容、内部链接策略。记录在
ai/research/05-topical-map/中。 -
本地 SEO(如适用)— 目标服务区域、本地竞争对手、特定城市关键词。记录在
ai/research/06-local-seo/中。 -
转化模式 — 分析竞争对手的 CTA、信任信号、社交证明模式。映射转化漏斗。记录在
ai/research/07-conversion-patterns/中。
交付物: 分布在 7 个目录中的 20-40 个研究文件。更新 research-status.json。
阶段 4:设计规划(思考阶段——每个决策都有意为之)
阅读: instructions/design-plan.md
这是网站从“另一个模板”转变为真正有效的网站的阶段。六个设计文档:
-
竞争对手视觉审计 (
ai/design/competitor-visual-audit.md) — 审查所有竞争对手网站的视觉模式:Hero 类型、部分顺序、配色方案、排版、动画、摄影风格。根据视觉质量对其进行排名。确定需要超越的目标。 -
风格方向 (
ai/design/style-direction.md) — 选择美学风格并说明理由。颜色、字体、深色/浅色模式、间距——每个选择都追溯到品牌需求采集 + 竞争对手分析 + 行业背景。 -
组件计划 (
ai/design/component-plan.md) — 每个需要的组件,按顺序排列,及其用途。为什么使用这种 Hero 布局?为什么使用这种信任栏样式?为什么这些部分按此顺序排列?映射到转化漏斗。 -
动画计划 (
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...
...(内容已截断以用于翻译)