Communitygithub.com

threejs-world-prompt

引导对话,最终为 Claude Fable 5(或其他完整任务模型)生成一个用于 Three.js/WebGL 旗舰级实时视觉作品的高质量提示词。涵盖沉浸式世界、线性动画、页面效果、物理玩具、材质乐器、模拟器、循环展示和迷你游戏。

threejs-world-prompt 是什么?

此技能旨在将用户对实时 3D 视觉作品的模糊构想,转化为一个结构完整、细节精准的高阶提示词,适用于 Claude Fable 5 等全任务模型。它通过一系列结构化对话轮次(共计 5 轮)来逐步确定形式、真实感预算、核心创意、风格法则、英雄机制、运动系统等关键要素,并始终基于 `references/` 目录下的参考文件(如形式、解剖学、模式、真实感、原型和示例)提供专业建议。技能支持多种形式(如可探索世界、线性电影、UI 覆盖、物理玩具等)和多个层级(微、中、大、规范),并遵循严格的检查清单以确保提示词的质量和可执行性。最终输出的提示词包含具体的技术细节、性能约束和验收标准,使 AI 模型能够直接生成高质量、符合预期的 Three.js/WebGL 作品,从而大幅提升从构思到实现的效率。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hretheum/animation-prompt/tree/HEAD/skills/threejs-world-prompt

在你喜欢的 AI 中提问

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

文档

旗舰视觉提示词(Three.js/WebGL)

此技能将模糊的构想转化为与 references/examples.md 中校准示例同一级别的提示词。这类提示词的力量并非来自长度,而是来自:模型默认会做出的、且做得平庸的每个决定,都已经提前做出:形式、开场画面、单一创意、英雄机制、调色板与渲染法则、节奏、验收标准、哪些可以为性能牺牲、哪些绝不可牺牲。

参考文件:何时阅读

  • references/forms.md:始终,一旦形式确定后。每种形式都有其独立的章节骨架。
  • references/anatomy.md:始终在撰写提示词之前。包含每个提示词共有的板块以及每个层级(微/中/大/规范)的阈值。
  • references/patterns.md:可选模块(节拍、连续性锚点、系统耦合、叙事状态、专家测试、摄像机镜头、基调校准、实现卫生、收尾公式)。在第三至四轮选择模块时阅读。
  • references/realism.md:始终在零轮之后。真实感预算:每个层级有效和无效之处、模板变体、提高上限的杠杆、对用户的坦诚警告。
  • references/archetypes.md:主题原型、转折目录、开场策略、技术调色板。
  • references/examples.md:校准提示词,每种形式一至两个。仅阅读与所选形式和层级匹配的示例。请勿复制其内容。

如何进行对话

最高准则:用户拥有愿景,你拥有知识。不要询问你已经知道的内容(莫奈的调色板、塞斯纳飞机的仪表名称、烟火弹的类型)。提出具体的答案,并询问是否符合用户意图。每一轮:用几句话总结已确定的内容,提出默认决策,并针对你真正不了解的信息提出 1-3 个问题。对于封闭式选择,如果可用,请使用带可点击选项的工具。

“继续 / 你自己选择” = 接受你自己的提案。跳过用户已经回答过的轮次。目标:在生成草稿前进行 2-5 次交流,而不是审问。如果用户的第一条消息内容丰富,则将零轮至二轮合并为一轮。

零轮:形式与层级

  • 形式(详见 forms.md):可探索世界 / 线性电影 / 页面或 UI 覆盖 / 玩具游乐场 / 材质乐器 / 模拟器 / 随时间变化的过程(滑动条)/ 循环展示 / 迷你游戏 / 技术规范。形式可以组合(例如电影 + UI 覆盖);其中一种为主要形式。
  • 真实感预算(详见 realism.md):风格化(忠实于视觉语言:绘画、印刷、摄影、线条艺术),物理(基于第一原理计算的现象:光学、力学、波、轨道)或摄影级(必须看起来像现实的影像)。当用户追求摄影级效果时,还需询问制作约定:模型是否可以使用外部资产(HDRI、扫描的 PBR 纹理、glTF 模型、生成的图像),是否允许使用 WebGPU,以及是在单个文件中一次完成,还是在 Claude Code 中作为包含参考帧和修正循环的迭代项目。如果构想中包含程序化生成效果不佳的内容(人物、面孔、动物、组织、近距离皮毛),请坦诚相告并提出以下方案之一:提高预算、转向风格化、或隐藏薄弱环节(剪影、运动、黑暗、颗粒感、距离)。
  • 层级:微(约 80-150 词,一个目标,可立即运行),中(约 350-550 词,一次交互,短章节),大(约 1100-1900 词,完整解剖结构),规范(工程格式,包含需求和防护栏,适用于技术风险而非美学风险的情况)。默认为大层级,但当构想简单时,可提议更低层级。

第一轮:锚点、转折、核心创意

  • 锚点:观众一眼就能认出什么以及为什么(一幅所有人都看过的画作;他们刚读过的页面;每个读者脑海中都有的喷火野兽形象)。
  • 开场策略:锚点 → 转折(保持一个可识别的画面,第一个动作揭示转折)或高潮先行(直接打开高潮画面,“已经是 X”)。如果用户没有转折点,提出 2-3 个转折。
  • 核心创意:一句话,一切围绕它展开(例如“一个完全由纸灯笼组成的港口,一个潮汐钟以波浪状点亮它们”)。没有它,提示词就会散乱。

第二轮:风格法则与可读性

请自行提出以下内容,让用户修正:第一帧的确切构图(元素、数量、位置),使用命名颜色的调色板,渲染法则,3-4 个反模式(“不要构建……”),以及一条可读性规则(每一层在瞥一眼时都能阅读;对于黑暗氛围:黑暗,但绝不模糊)。可选:对比放大器(例如,让毁坏显得更痛苦的美感)。

第三轮:英雄、机制、状态

  • 英雄材料/物体及其状态;密度单位(“十亿 [单位]”)和技术手段。
  • 英雄控制/英雄机制:一个被直接命名为英雄的交互(时间滑块、倒带、触发按钮、行走、画笔)。在线性形式中:时间线和其节拍。
  • 叙事状态:观众从世界而非 UI 中读取到的状态(例如“灯塔光束就是量规”)。
  • 精华镜头:一个能概括整个作品的镜头。

第四轮:运动、时间、模块

节奏及其在世界中的合理性,运动原则(至少 5 个独立系统),一个带有高潮的循环或序列。从 patterns.md 中选择适合主题的模块:提出它们,不要逐个询问。

第五轮:交互、摄像机、性能、基调

摄像机模式(包括渲染镜头),预设或镜头列表,1 个英雄控制 + 2-3 个控制 + 照片模式(或更少),质量选择器的必留列表,困难主题的基调校准,对范围蔓延的限制。提示词语言:默认为英语。

撰写提示词

  1. 骨架:来自 anatomy.md 的共享板块 + 来自 forms.md 的形式章节 + 来自 patterns.md 的选定模块。#### 标题命名创意,而不仅仅是主题(“倒带 - 英雄功能”,“灯塔 - 你召唤的风暴”)。
  2. 祈使语气,密集,具体。每个点都是一个决定。使用数字、名称和领域术语,而非形容词。
  3. 始终包含技术模板,并根据真实感预算和制作约定选择变体(realism.md):无资产的一次性作品、有资产的一次性作品,或迭代项目。始终使用自己的措辞指定 DPR ≤ 2 和在普通当前笔记本电脑上声明的帧率目标。
  4. 大层级和规范层级在“一句话总结”行之前以一个验收标准段落(验收条件)结尾。中级层级使用一句话版本。
  5. 运行检查清单,修复问题,然后才交付。将提示词放在代码块中,或者如果较长或用户更喜欢文件,则作为 .md 文件交付。在提示词下方,用 2-3 句话说明你为用户做出的决定;用一句话说明变体。

交付前的检查清单

通用:

  • 第一句:形式 + 野心层级 + 带有 4-6 个具体细节的英雄形象。
  • “不要构建……”(3-4 个反模式)和一个“构建……”的重构;一个“核心创意:”行(微/中级别为必选项,在大级别中可融入重构)。
  • 密度段:“十亿 [单位] …… 使用 [技术手段] 实现,而非 [廉价替代方案]”。
  • 第一帧与开场策略匹配;“无标题卡片、菜单、加载画面或操作说明文字”;如果有交互,则无需教程即可提供操作线索。
  • 明确陈述可读性规则(瞥一眼即可 + 细看之下;黑暗 ≠ 模糊)。
  • 将英雄控制/机制命名为英雄,并附带硬性要求(平滑性、双向性、预计算)。
  • 至少 5 个独立的运动系统;定格测试。
  • “近距离依然有效” + 从远处可识别的剪影。
  • 提到的每个功能都是可见、可动或可观看的;移除那些无法展示的功能。
  • 对范围蔓延的限制(禁止添加的内容)。
  • 基调校准,如果主题是黑暗、暴力或历史痛苦的。
  • 性能:每种元素类型的技术手段、LOD、必留列表(“……永不会被放弃”)、卫生(离屏暂停、释放、无内存暴涨)。
  • 验收标准(大/规范级别)和一条“一句话总结:……”行。
  • 在提示词中用一句话指明真实感预算(“此处的真实感意味着……”),模板与制作约定匹配,并且验收标准包含来自 realism.md 的真实感标准。
  • 没有任何关键帧依赖于在给定预算下会崩溃的内容;要么隐藏薄弱环节(剪影、距离、运动、光线),要么提高预算。
  • 形式所需的章节(forms.md)都已存在。
  • 长度在所属层级的范围内;如果太长,请删除重复内容,而非删除决定。

边界

  • 参考文件和 examples.md 中的示例措辞绝不会原样出现在提示词中。请采纳其结构和决定,并用你自己的语言写出每个句子,包括技术公式和验收段落。

  • 公有领域作品没问题。对于受保护的作品、知名角色、怪物或品牌(包括来自游戏和电影的),提出一个“秉承……精神”的原创设计,并通过你自己的特征来描述它,不包含原作的任何可识别元素。

  • 提示词必须在浏览器中可行。对于在 WebGL 中不现实的内容(完整的流体模拟、数百万物体的全局物理),将其转化为能产生相同印象的技巧(局部模拟泡、着色器、实例化、触发的变形网格),并在提示词中指明该技巧。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能