Communitygithub.com

Cosmic Forge — 导演工作流

专为构建电影级、照片级真实的实时3D网页体验(太空、黑洞、星系、行星或任何“宇宙”/物体场景)而设计,具备滚动驱动摄像机旅程、工作室级UI/UX、即时加载和完美移动端布局。

Cosmic Forge — 导演工作流 是什么?

Cosmic Forge 是一个AI智能体技能,旨在指导开发者和AI助手创建令人惊叹的3D WebGL/Three.js体验,例如黑洞网站或“Awwwards级别”的滚动动画站点。它结合了创意指导、图形工程和UI/UX领导力,确保最终产品在移动端和桌面端都能表现出色。该技能涵盖七个关键领域:WebGL电影引擎、太空真实感、滚动摄像机方向、UI/UX精通、即时加载性能、移动端优先3D,以及一个最终的质量关卡。其工作流程始于一个高质量模板(如黑洞事件视界),然后根据用户概念进行个性化定制,同时保留核心渲染管道(如TAA、泛光、动态分辨率)和滚动机制。技能强调连续性(通过摄像机运动实现无缝过渡)、真实艺术参考(真实纹理、物理规律和光照)、避免AI生成的视觉特征(如紫色雾霾、光晕文本),并优先考虑速度(2秒内可交互,移动端首包大小≤1.5MB)。建议用户在编写任何代码之前,先根据提示创建一个6行“处理方案”来规划视觉、叙事和性能预算,然后严格遵循构建顺序:从模板渲染开始,逐步添加内容、场景、摄像机、UI、移动端适配,最后性能优化和通过质量关卡。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/forpc1428-eng/cosmic-forge/tree/HEAD/skills/cosmic-forge

在你喜欢的 AI 中提问

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

文档

Cosmic Forge — 导演工作流 是做什么的?

您同时扮演创意总监 + 图形工程师 + UI/UX 主管。 标准是:访客应在 2 秒内,在一台中端手机上,认为“这怎么能在浏览器里运行?”,没有卡顿,没有裁剪,没有通用的“AI 感”。

本技能统筹七项精通技能。在编写代码之前,请阅读与任务相关的技能:

技能何时阅读
webgl-cinematic-engine任何实时 3D:渲染管线、着色器、TAA、泛光、色调映射、编译速度
space-realism黑洞、星系、星云、恒星、行星、太阳、光环、大气、光照、色彩科学
scroll-camera-direction随滚动移动的任何元素:摄像机路径、节奏、无缝过渡、比例变化
ui-ux-mastery排版、颜色、布局、3D 上的文字、加载器、提示、导航、可访问性、文案
instant-load-performance始终需要。加载预算、着色器编译、纹理、缓存、帧预算
mobile-first-3d始终需要。独立的手机配置文件、竖屏构图、触摸、安全区域
quality-gate始终需要,最后执行。未通过检查的代码不得发布

0. 默认行为

  • 未给概念(或“给我做点类似的”):复制 templates/event-horizon/ 并进行个性化定制(名称、角色、电子邮件、页面、项目列表)。该模板本身就是参考质量标准:一个带有透镜真实天空的史瓦西黑洞 → 体素星系 → 摄影级太阳系,全部在一次连续滚动中完成。不要将其“简化”。
  • 不同概念(海洋、城市、产品、动漫城堡、森林、原子、DNA...):仍从模板的引擎和管线出发(TAA、泛光、动态分辨率、加载器、滚动弹簧、节奏曲线、移动端配置文件、滚动提示),仅替换场景着色器、摄像机关键帧和内容。切勿从头重建管道——质量正是体现在这里。
  • 明确要求 Three.js:允许,但移植相同的规则(参见引擎技能 §Three.js)。

1. 简介 → 处理方案(编码前写下)

将任何请求(即使只有一行)转化为 6 行处理方案:

  1. 英雄图像:人们会截图的那一帧。描述光线、色彩、规模。
  2. 旅程:摄像机经过的 3–6 个节拍,每个节拍与下一个连续(除非要求,否则无剪切、闪光或隧道)。示例:黑洞 → 黑暗 → 星系 → 恒星 → 行星 → 家园。
  3. 页面:每个节拍出现哪些内容,以及位于框架的哪一侧。
  4. 调色板:一种主光颜色、一种强调色、一种深色背景。真实世界参考(NASA/ESA 照片、电影剧照)优于凭空想象。
  5. 运动感:例如“慢速壮观滑轨,加速进入黑洞,在页面上温柔停留”。
  6. 预算:桌面端动态分辨率下 ≤ 16 毫秒/帧,手机端首包加载 ≤ 1.5 MB。

如果用户措辞模糊,请自信地做出决定,并用一行陈述您的选择。仅在确实需要用户做出决定时(品牌名称、真实电子邮件、真实项目名称)才提问。

2. 构建顺序(切勿跳过,切勿重新排序)

  1. 复制模板 → 本地运行(python -m http.server)→ 确认能渲染。
  2. 个性化内容(js/main.js → SITE、PAGES;index.html 标题/meta/加载器名称)。
  3. 场景工作(引擎 + 真实感技能)。一次更改一个节拍;每次更改后查看效果。
  4. 摄像机与节奏(滚动摄像机技能)。使用 ?u=0.42 风格的跳转链接进行调整。
  5. UI 层(UI/UX 技能):面板、导航、加载器、滚动提示、标签。
  6. 手机配置文件(移动端技能):构图、纹理、布局、菜单。
  7. 性能优化(即时加载技能):测量每个节拍的 GPU 毫秒数、编译毫秒数、字节数。
  8. 质量关卡(质量关卡技能)。修复其标记的所有问题。然后发布。

3. 不可协商的规则(“200%”规则)

  • 连续性:每次过渡都是在一个世界中移动摄像机。比例跳跃使用两帧技巧(引擎技能)。仅从/向真正的黑色淡入/淡出,切勿闪烁白色。
  • 先有真实参考:真实纹理(行星地图、银河系全景图)、真实物理(透镜效应、多普勒效应、黑体辐射、Novikov–Thorne 盘、开普勒剪切)、真实光照角度。
  • 无 AI 痕迹:不要到处都是紫色雾霾、不要彩虹渐变、不要所有东西都发光、不要色差拖影、不在文本上使用泛光、不要通用镜头光晕、不要“霓虹”UI。使用深邃的黑色。少量、精心设计的高光。
  • 文本是神圣的:切勿让 3D 对象位于段落文本后方。将主题置于桌面端的对侧或手机端的底部工作表之上。
  • 速度即设计:加载器应在首屏绘制时可见,手机端在 4G 网络下 < 2 秒内可交互。
  • 每个数字都通过观察调整,然后测量。每个节拍都截取桌面端和手机端的截图。

4. 交付

完成后说明:构建的内容、在线/本地 URL、用户需要编辑的内容(电子邮件、姓名)、如何部署(Vercel:框架“Other”,无构建)以及任何诚实的限制(例如“在模拟器中测试,未在实体 iPhone 上测试”)。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

mobile-first-3d

Dedicated phone/tablet experience for heavy 3D/WebGL sites — device profile detection, lighter render settings and texture sets, portrait camera framing so subjects (planets with rings, galaxies) are never clipped, bottom-sheet content, menu sheet, safe areas, touch behaviour and shorter scroll. Use always when building a 3D site, and whenever someone says "on mobile it's cut off / not seen perfectly / slow / ugly".

space-realism

Physically grounded, photoreal look-development for space and natural scenes — black holes and accretion disks, spiral galaxies, nebulae, star fields, the Sun, planets, moons, rings, atmospheres, lighting angles and colour science — plus how to avoid the generic "AI render" look. Use whenever a scene contains space objects or must look "real", "ultra detailed", "NASA-like", "Interstellar-like", or currently looks bland, plastic, hazy or fake.

ui-ux-mastery

Studio-level UI/UX for immersive and 3D websites — typography systems, colour tokens and contrast, layout over moving 3D, text panels, navigation and phone menus, custom loaders, idle scroll cues, micro-interactions and easing, copywriting, accessibility and reduced motion. Use when designing or reviewing any interface layer, portfolio, landing page or hero; when something looks "generic", "AI-made", "cluttered", "not premium"; or when text is unreadable over visuals.

webgl-cinematic-engine

Film-quality real-time rendering in the browser with raw WebGL2 (or Three.js): fullscreen raymarching, geodesic/raytraced scenes, temporal anti-aliasing, dynamic resolution, physically based bloom, ACES tone mapping, grain, sky baking, multi-scale scenes, and shader compile-time tricks for Windows/ANGLE. Use for any 3D/WebGL/GLSL/shader/Three.js scene work, black holes, volumetrics, or when a scene looks flat, aliased, flickery, slow or "CG".

相关技能