webbuild 是做什么的?
制作企业主愿意为之付费的网站:专属于他们、在手机上快速加载、拥有一个令人难忘的瞬间,并且绝不像“AI 生成的”。这门手艺的价值主要体现在代码之外的选择,以及完成后诚实的自我审视。
以下路径均相对于本技能的文件夹(scripts/、references/、assets/)。
0. 设置项目(2 分钟)
- 全新站点 → 将
assets/starter/复制到项目文件夹中(纯 HTML + CSS + ES 模块、固定 CDN 引入、无构建步骤:可部署到任何地方,易于编辑)。仅当用户要求或项目已使用 Next.js / Astro / R3F 时,才使用它们(references/3d-playbook.md第5节)。 - 现有项目 → 保留其框架、设计令牌和组件;此技能为其增加方向、动效和 QA,而非重写。
- 在项目中创建
BUILD_NOTES.md。它是在上下文重置时保留的记忆:简要记录决策、未决问题、已生效的修复。
1. 简报——获取真实的业务信息
从用户、该业务的现有网站、Google Business Profile、Instagram 收集以下信息:名称、业务内容、地点、成立时间、一个主要行动目标(电话 / 预约 / 下单 / 询价 / 到店)、真实的证明(评分和数量、经营年限、许可证、媒体报道)、真实照片、Logo/颜色、营业时间、地址、电话。将 references/design-system.md 第2节中的5行简报写入 BUILD_NOTES.md。
绝不捏造事实——虚构的评价、统计数据、价格或地址在客户阅读时会瞬间摧毁信任。应遵循以下原则:
- 围绕未知信息撰写,使演示稿看起来仍然像完成品:例如使用“Pune, Koregaon Park”而不是捏造的街道号码;使用“Google 评分 4.7”而不是编造的评论;不写价格的服务名称,或仅在已知时使用“起价 ₹…”。
- 对于确实需要的信息(电话、确切地址、营业时间),使用可见的
{{placeholder}}占位符——slop_check.py会在这些内容被填充前阻止发布。 - 将所有未知信息和假设列入“询问客户”清单,以便最终报告中使用。
对于创作者或频道类网站,请事先获取(或拉取)仪表板数据和个人资料图片:YouTube Studio / Instagram Insights 截图,以及 vidIQ 或类似工具(如果已连接)的数据。使用真实数据构建的“成果”部分是促成交易的关键。
如果简报信息不足且用户在场,最多提出3个问题(业务+城市、主要行动目标、任何他们喜欢的网站)。如果他们希望你直接开始,做出合理的假设,记录下来,然后继续推进。
2. 参考(当用户命名一个网站、发送录屏或想要“重建”时)
执行 references/reverse-engineer.md:使用 node scripts/teardown.mjs <url> 测量技术栈、字体、配色方案、媒体和着色器证据,并截取滚动截图;屏幕录制将被分解成帧,你需读取帧并生成逐节动效规范。当快速分析无法解释某个效果时,使用 REA 引擎深入分析:scripts/rea-teardown.sh <url> 会捕获页面、对包进行指纹识别并导出所有脚本,以便你了解其实际构建方式(指南在 references/rea/ 目录下)。记录“观察 → 推断 → 决策”。学习其技巧;绝不复制品牌、文案、资产或代码。
3. 方向——规划,然后挑战规划
阅读 references/design-system.md(反“AI 流水线感”规则——既包括经典风格,也包括更新的“有品味的 AI”特征,如奶油色+陶土色、全大写标签栏、编辑风格的分隔线)。在 BUILD_NOTES.md 中写入:
- 从业务中提取的4–6个命名的颜色令牌、字体配对和角色、圆角语言
- 每个部分的 ASCII 线框图(变化节奏——避免“首屏 → 3卡片 → Logo展示 → 用户评价”的固定模式)
- 标志性瞬间(仅一个)以及为何它适合这个业务
- 使其与众不同的3条原则
然后对照“AI 特征清单”检查规划,对于每个看起来像是默认值的决策,要么为其适用于此业务提供理由,要么更改它。问自己“如果交换Logo,这个网站是否也能属于其他业务?”这能在成本低廉时捕获大多数问题。
对于用户希望从多个中挑选的未定方向,在构建前展示2–3个真正不同的方向(每个方向提供一张静态图或一个简短的 HTML 草图)——如果已安装,21st-ui-explore 可以提供帮助。
4. 首屏——选择服务于业务需求的模式
references/3d-playbook.md 第1节包含决策表。简要版本如下:
- 静态(优质图片/文字)——适用于餐厅、食品、沙龙、诊所、服务类。通常是不错的选择。
- 视频——氛围循环,最好使用
assets/starter/grade.js进行处理,使 AI/素材视频获得定制化的色彩风格(颗粒感、光晕、提亮/伽马/增益、暗角)。选择一个“LOOK”并保持微妙。 - 帧动画——“高价3D网站”:AI生成的开始/结束关键帧 → 首/末帧视频 →
scripts/frames.sh→ 由滚动擦除的画布。阅读references/scroll-video-playbook.md了解关键帧规则、提示词和混合方法。 - 场景——当3D就是产品故事时(可配置的产品展示、建筑、科技类),使用实时的Three.js / R3F。主体必须是该业务自己的东西,绝不要使用占位符式的复杂几何体。
- 全页3D——当客户说“3D网站”时,通常意味着整个页面都是3D,而非仅限首屏。使用一个固定的场景,为每个部分设置独立的摄像机站位(
references/3d-playbook.md第6节)。
使用任何已连接的工具(Higgsfield / Kling / kie.ai / Nano Banana MCPs 或 skills)生成素材,或让用户将文件拖入。如果找不到合适的工具,则使用清晰标记的占位符进行构建,并列出需要生成的确切素材及其提示词。
5. 构建
顺序:令牌(styles.css :root)→ 带有真实文案的语义HTML部分 → 在 390px 和 1440px 宽度下布局 → 首屏模式 → 最后添加动效。
- 文案规则:
references/design-system.md第8节(结果 + 地点 + 具体细节、真实的 CTA 动词、禁词列表)。 - 商业网站的必备要素:一个在首屏上方再出现的、明显的 CTA,
tel:/ 预约 / 表单、营业时间 + 地址 + 地图链接、真实证明、标题 + 描述 + OG 图片、LocalBusiness JSON-LD、favicon、移动端上行动目标为电话时的粘性呼叫/预约栏。 - 动效:一个标志性瞬间 + 安静的 150–300 ms 的微反馈;仅使用
ease-out,绝不使用bounce;仅作用于transform/opacity;支持prefers-reduced-motion的用户应显示结束状态。 - 组件:在手动编写复杂效果之前,搜索
references/resources.md中的组件注册表(21st.dev、React Bits、Aceternity、Motion Primitives…),然后重新设计样式以匹配你的令牌。在静态站点中,用原生方式重建 React 组件,避免仅为单一效果引入 React。 - 页脚:按
references/design-system.md第11节构建(品牌区块、带有平台Logo的链接列、联系方式按钮、超大字号品牌词、底部行)。客户通过页脚来评判整个网站。小型协作者声明已在起始模板中提供;客户可要求移除。 - 按钮和滚动:遵循
references/design-system.md第12节(触感 0.16 秒的按钮、通过起始模板的cursor.js实现的鼠标光标环、无原生滚动条:起始模板的blockbar.js已替换之)。 - 在宣称完成之前,重新阅读
references/design-system.md第10节:即使所有规则都通过,客户仍然可能抱怨“AI流水线感”的问题。
6. 审视——精品网站由此诞生
在本地提供服务(npx serve . 或项目的开发服务器),然后:
- 执行
node scripts/shoot.mjs http://localhost:3000 ./shots— 在滚动过程中截取手机 / 笔记本 / 桌面端的屏幕截图,并检查控制台错误、溢出、LCP、页面重量。查看 PNG 截图。 (如果可用,也可以使用浏览器面板或 Playwright MCP。)另外,使用--reduced-motion标志运行一次。 - 执行
python3 scripts/slop_check.py .— 必须最终以 0 FAIL 通过。将 WARN 视为问题处理。(如果已安装,npx impeccable detect是一个不错的第二意见工具。) - 根据简报诚实评判:层次结构、字体、颜色、标志性瞬间、移动端适配、文案的具体程度。带着明确意图进行批量修复(例如:“下方部分感觉太通用——让它们看起来更高级,而不是更杂乱”)。
- 在宣布完成之前,移除一个装饰性元素。
预期需要 3–6 轮迭代;没有人能一次性完美完成。在 BUILD_NOTES.md 中记录哪些修复解决了什么问题。
7. 部署 + 推销
- 部署:Vercel / Netlify / Cloudflare Pages / GitHub Pages。提交 frames 文件夹(最常见的“首屏在生产环境中消失”的bug)。在客户购买前,为演示站点添加
<meta name="robots" content="noindex">。 - 如果是为了推销,请阅读
references/pitch-and-sell.md:前后对比视频、外联脚本、定价锚点、推销就绪检查清单、交接事项。
给用户的最终报告
保持简短而具体:
- 构建了什么(一句话描述方向、标志性瞬间、首屏模式)以及在哪里可以找到(路径、URL)
- 如何运行(
npx serve .或开发命令) - QA 结果:slop_check FAIL/WARN 数量、shoot.mjs 每个视口下的 LCP/错误数、你检查并修复的内容
- 询问客户清单:每个
{{placeholder}}和假设 - 仍需生成的素材(附上可直接使用的提示词),如果有的话
参考地图
| 文件 | 何时阅读 |
|---|---|
references/design-system.md | 始终,在选择颜色/字体/布局/文案之前 |
references/3d-playbook.md | 选择首屏模式;任何 Three.js/R3F 相关;性能和无障碍预算 |
references/scroll-video-playbook.md | 从 AI 视频制作由滚动的“3D”首屏 |
references/reverse-engineer.md | 有参考网站、录屏或需要重建潜在客户的网站时 |
references/rea/README.md | 需要使用 REA 工具进行比 teardown.mjs 更深层的分析时 |
references/resources.md | 组件注册表、动效工具、灵感、配套技能 |
references/pitch-and-sell.md | 为潜在客户制作演示站点、定价、外联、交接时 |
| 脚本 | 功能 |
|---|---|
scripts/teardown.mjs <url> | 测量参考站点(技术栈、字体、配色方案、媒体、着色器、截图) |
scripts/rea-teardown.sh <url> | 使用 REA 引擎进行深度拆解:页面捕获、包指纹、导出的脚本 |
scripts/frames.sh <video> <out> | 视频 → WebP 帧序列(桌面端 + 移动端)及清单 |
scripts/shoot.mjs <url> [out] | 在 3 种宽度下沿滚动截取截图,并检查错误/LCP/溢出 |
scripts/slop_check.py <dir> | AI 流水线感 + 发布就绪检查工具(0 FAIL 才可发布) |
Playwright 用于 .mjs 脚本:npm i -D playwright && npx playwright install chromium。