Moat → 3D 落地页
你将一家公司(其在线网站或一句护城河描述)转化为一个已完成、可运行、经过截图验证的落地页。引擎已编写好(template/);每个客户你只需编写一个文件 src/content.js,生成图片并验证。引擎的更改会被回移植到 template/,以便下一个客户同样受益。
根据需要阅读(均在 references/ 中):
intake.md 调研客户 · narrative.md 护城河 → 故事 → 文案 · art-direction.md 色彩理论、字体、光照、可读性 · scenes.md 物体与场景、章节分割 · engine.md 模式与模块 · qa.md 截图脚本与评估标准 · advanced.md 真实资产与趋势路线图 · lessons.md 迄今为止的所有错误——开始前快速浏览一遍。
参考研究(随技能保存):references/research/oryzo-teardown.md、graphify-teardown.md、video-and-writeup-research.md。已完成客户:pages/poolco/、pages/secureco/、pages/hotelsaas/。
参考资料一句话总结
Oryzo 将单个英雄物体置于舞台中央,并改变其周围世界(相机、渲染模式、色调、明/暗)——简短冷峻的文案,每个节拍一个主张 + 一个证据;一个固定的 WebGL 画布位于高 DOM 后方,每个缓动值都是弹簧。Graphify 将 3D 用作调味料:一个粘性的“工作原理”部分,其示意图就是产品的隐喻(投影 SVG 线框),并通过证据密度进行销售。我们融合了它们——并且,对于实体企业,用一个真实、可识别的、可以被剖开并贴上标签的场景取代抽象物体。
工作流程(全部按顺序执行)
1 · 调研与收集 → research/<slug>/brief.md
如果客户有网站,首先爬取每个页面(intake.md):文本、服务、流程、地点、常见问题、条款/免责声明、真实 logo 文件、采样品牌颜色和字体、公开联系方式。提取:公司、一句话护城河(其反复宣称的主张)、买家、真正的行动号召、确实存在的证据。仅对无法找到或推断的内容向用户询问一次。输入中包含凭据/账号/个人数据 → 首先停止并警告。
2 · 策略(编码前写入 brief)
- 护城河类型 → 隐喻(
narrative.md §2)。 - 物体还是场景? 应用一秒测试(
scenes.md)。场所/装置 → 场景(pool模式);关于访问/可见性的软件 →repo;按钟表运行的场所的软件(酒店、场馆、零售) →city;产品 → 物体形状。 - 主题句(品类习惯 vs 护城河使其为真的内容)。
- 章节计划:10–15 个章节(
narrative.md §3,或服务业 §3b 构建顺序)。每个章节至少改变 2 项:相机、舞台/模式、色调、数值、布局形状。 - 所有文案(
§4):标题 ≤ 7 词,正文 ≤ 35 词,一个主张 + 一个证据,仅来自 brief。 - 变化格式——没有两个客户获得相同的页面。 在 brief 中决定并写下:滚动意味着什么(旅程、构建顺序、时钟……)、读者做什么(阅读、点击、拖拽、播放)、3D响应什么(仅滚动,或通过
send/receive的小部件)。对于有仓库的软件,让章节可玩(type: 'play'):使用演示数据在真实产品组件的小型诚实副本上移动 3D(engine.md→ HotelSaaS)。
3 · 艺术指导
art-direction.md:从品牌 + 产品颜色 + 互补强调色出发的以光照为先的 60·30·10 调色板(在交接中解释理论)、客户自己的字体、为实现真实感 Bloom 设为 0、在杂乱 3D 上放置文案卡片、每个 3D 章节的移动端关键帧。
4 · 图片(并行)
编写 research/<slug>/images.json(每个服务一张照片 + og),然后在后台运行 node .claude/skills/moat-landing/tools/gen-batch.mjs research/<slug>/images.json 并构建。检查联系表;重新生成不合格的图片。原始文件保留在 research/ 中,绝不进入 public/。关键点:GEMINI_API_KEY 在你的 shell 环境中——绝不要打印它或将其作为参数传递。
软件/开发者品牌: 跳过摄影;待主体获批后,从你自己的英雄渲染图制作 public/og.jpg(1200×630 视口截图)。
5 · 构建
SLUG=<slug>; ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
mkdir -p "$ROOT/pages/$SLUG" && rsync -a --exclude node_modules --exclude dist "$ROOT/.claude/skills/moat-landing/template/" "$ROOT/pages/$SLUG/"
cd "$ROOT/pages/$SLUG" && npm install
重写 src/content.js(模式:模板顶部 content.js + engine.md),包括 meta.url/image、business、brand.copyCards、quickActions、章节 notes/cover/mobile。页面特定 CSS 放入 brand.css。新功能 → 在 template/ 中构建,然后 rsync -a --exclude content.js template/src/ pages/<slug>/src/。
5b · 其他页面(当客户网站有它们时)
在其原始 URL 重建原始网站的每个页面(src/pages/<slug>.js,engine.md → 多页面):每个子页面保持相同的 3D 世界、卡片语言和一个可玩片段(功能 → 探索器、定价 → 计划选择器、关于 → 故事小部件);法律页面使使用 doc 类型并附带实时文本(标记日期和管辖区以供审核);联系方式使用 WhatsApp/电子邮件表单(未经批准无后端)。
6 · 验证(强制要求,每次迭代,两种尺寸)
npm run check(预算门限)→ 预览 → 在 1440×900 和 390×844 下截图所有章节 → 联系表 → 行为 + SEO 检查 → qa.md 中的评估标准。预计 2–3 轮。
7 · 交接
运行位置(npm run dev / 预览 URL)、主题、章节地图、色彩理论依据、客户仍需提供的内容(真实证据、表单端点、分析 ID、域名)、已选默认值、以及来自 advanced.md §9 的前 2–3 个升级项。提醒:数据、监管和比较性声明在发布前必须经过验证。将学到的任何内容更新到 lessons.md 和记忆中。
设计规则(来自客户反馈——默认应用)
- 一秒可识别性。 先构建真实事物;然后剖开它。
- 无发光。 任何真实事物 Bloom 设为 0;光来自太阳、天空和场景内光源。
- 明亮、阳光充足的调色板适用于实体/服务业;仅限夜晚/科技主题时使用深色。
- 绝不在纹理上放置文字。 卡片放在水面、瓷砖和杂乱的 3D 之上。
- 用剖面图 + 锚定标签解释,而不是 X 光发光。
- 绝不发布可见的占位符。 缺少证据 → 省略该章节,在交接中列出。
不可妥协项
- 整页只有一个英雄(物体或场景);流程内容存在于
cover章节中。 - 擦洗舞台,触发文案(文案在重新进入时重播;绝不是一次性)。
- 文本是 HTML,绝不烘焙到纹理或图片中;结构化数据仅陈述页面所显示的内容。
- 诚实。 无虚构指标、客户、logo、引用、认证或竞争对手事实;生成的图片标注为示意;生成的个人绝不呈现为客户。
- 绝不冒充用户无权代表的品牌;虚构的演示需明确说明。
- 品牌。 始终使用客户自己的品牌(字体、颜色、logo)——从其实时网站读取。
- 预算(
npm run check):页面 JS ≤ 55 KB gz,舞台 ≤ 205 KB gz,图片 ≤ 500 KB,一个画布,DPR ≤ 1.75;在关闭 WebGL、开启减少动画、390 px 宽度下正常工作;0 控制台错误;0 溢出。 - 未经用户明确同意,不进行部署、表单端点、分析 ID 或外部账户。