Communitygithub.com

moat-landing

从企业官网或一句话的「护城河」出发,构建一个滚动驱动的3D落地页,包含研究、叙事、配色、可识别的3D主体、剧照、动效、SEO数据、转化追踪以及桌面与移动端截图质量检查。一个内容文件驱动共享引擎,使每个客户页面保持独特性。

moat-landing 是什么?

Moat Landing 是一个专业的 AI 智能体技能,专为 Claude Code、Cursor、Codex 等 AI 编码助手设计,用于自动化构建 3D 落地页。其核心流程从用户提供的企业网站或一句“护城河”描述开始,经过深入调研、叙事策略、艺术指导、图片生成、代码构建、多轮质量检查直至交付。该技能遵循严格的“一个引擎,一个内容文件”架构:所有通用逻辑和3D渲染引擎存储在 `template/` 目录中,而每个客户页面只需编写一个 `src/content.js` 文件来定义其独特内容,包括章节规划、品牌配色、文案和3D场景。引擎的改进会回移植到 `template/`,惠及后续所有客户。技能内置了详尽的参考文档,涵盖客户研究、叙事方法、色彩理论、场景设计、工程质量基准和案例教训,并强制要求“一个可识别的3D英雄”贯穿始终,禁止使用发光特效和纹理上的文字,确保视觉真实性和无障碍性。它还强调诚实,禁止虚构指标、客户或品牌,并要求生成的图片明确标注为示意。

兼容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/thisisshivamtiwari/3d-landing-pages-skill/tree/HEAD/moat-landing

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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)

  1. 护城河类型 → 隐喻(narrative.md §2)。
  2. 物体还是场景? 应用一秒测试(scenes.md)。场所/装置 → 场景(pool 模式);关于访问/可见性的软件 → repo;按钟表运行的场所的软件(酒店、场馆、零售) → city;产品 → 物体形状。
  3. 主题句(品类习惯 vs 护城河使其为真的内容)。
  4. 章节计划:10–15 个章节(narrative.md §3,或服务业 §3b 构建顺序)。每个章节至少改变 2 项:相机、舞台/模式、色调、数值、布局形状。
  5. 所有文案(§4):标题 ≤ 7 词,正文 ≤ 35 词,一个主张 + 一个证据,仅来自 brief。
  6. 变化格式——没有两个客户获得相同的页面。 在 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 或外部账户。

相关技能