Communitygithub.com

超站构建器

指导智能体如何艺术指导和构建“超站”,最终输出一个标志和一份小型品牌手册。流程涵盖超站、不可妥协项、工作流程。当新任务需要此工艺时使用。

超站构建器 是什么?

此技能教导AI智能体构建一个类似大公司旗舰启动页的站点,仅使用真实资产和诚实数据,参考构建为ARFORGE项目。它强制执行一套严格的“不可妥协”规则,包括仅使用照片扫描的CC0模型、真实HDRI和纹理、每个部分作为全视口英雄、语义动画(每个动画词都按字面意义移动,并可按下'W'键显示原因),以及用浏览器测量的指标(如FPS、绘制调用)或实时API数据替代虚构的声明。工作流程从5分钟的概念阶段开始(选择一个工作室名称和一种视觉隐喻),然后进行资源采集(从Poly Haven查询,使用gltf-transform压缩)、编码搭建(Vite + Three.js + GSAP)、阶段构建(基于真实网格的形态场、过程射击)、语义文字处理,最后是跨桌面和移动端的QA检查并部署到GitHub Pages。该技能针对Claude Code、Cursor和Codex等平台,确保Agent产出一个拥有完整品牌信息、交互式3D内容且仪表盘化的高质量落地页。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ArfatArfart/ultra-site-skill/tree/HEAD/ultra-site

在你喜欢的 AI 中提问

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

文档

超站

此技能构建一个看起来像大公司旗舰启动页的站点,仅使用真实资产和诚实数据。参考构建为 ARFORGE (https://github.com/ArfatArfart/arforge, 在线地址 https://arfatarfart.github.io/arforge/)。当需要任何步骤的工作代码时,请阅读其源代码。

不可妥协项

  1. 仅使用真实3D资产。 永远不要用基本几何体“伪造”一个英雄对象。使用照片扫描的CC0模型(Poly Haven)、真实HDRI、真实NASA纹理、真实标志(Simple Icons)、客户自己现场工作的真实截图。在页脚注明每个来源。
  2. 单阶段,多镜头。 一个固定的 <canvas> 位于页面后方。每个部分声明 data-shot 和 data-theme。滚动位置变为浮点数(2.4 表示从镜头2到镜头3的40%)。
  3. 每个部分都是英雄区。 全视口、显示类型、自身主题、自身3D时刻。页脚也包括在内。
  4. 语义动画。 每个动画词都按字面意义移动。每个效果存储一句话的原因。提供“为什么模式”(W键),将这些原因固定在屏幕上。
  5. 以证明代替声明。 永远不要编造统计数据、客户或推荐信。显示浏览器测量的数字(fps、帧时间、绘制点数、绘制调用、字节数、首帧时间),以及实时获取的数据(GitHub仓库、API延迟)。
  6. 发布它。 使用 Vite 构建,base 设置为仓库路径,包含 GitHub Actions Pages 工作流,创建仓库并启用 Pages,以及一个已验证的在线 URL。

工作流程

  1. 概念(5分钟,除非受阻,否则不提问)。 选择一个工作室名称和一个每个视觉决策都能从中推导出的隐喻(ARFORGE:一个锻造厂,因此溶解像热金属一样发光,流程步骤是锤击,余烬升起)。用句子大小写撰写文案,无填充词,句内无连字符。
  2. 采集资产。 遵循 references/real-assets.md。查询 Poly Haven API,在1k(英雄区2k)分辨率下下载glTF,使用 gltf-transform(meshopt + WebP)压缩,检查边界,渲染 Blender 缩略图以了解每个模型的朝向。使用无头 Edge 或 Chrome 截图客户的实时项目。
  3. 搭建脚手架。 Vite + three + gsap(所有插件均为免费:SplitText、ScrambleText、ScrollTrigger)+ lenis + @fontsource-variable/geist。一个样式表包含令牌,十一个主题作为由 GSAP 补间动画驱动的 CSS 变量。
  4. 构建舞台。 遵循 references/stage-architecture.md:从真实网格采样的形态场,已修补到真实 PBR 材质上的锻造溶解,为没有对象的区域添加过程镜头,余烬,火花,一个带有真实太阳子点的地球。
  5. 构建各个部分。 英雄区(对英雄对象使用扫描着色器,带有真实网格统计的 HUD)、标语揭示、三个服务章节(每个包含一个真实对象和一个互动证明:实时画布屏幕、可拖动的手机演示、真实请求的终端)、带有冲击力的固定流程、作品展示网格、可拖动的科技球体、实时指标、常见问题、带有地球和热感文字的页脚英雄区。
  6. 语义文字。 使用 references/semantic-motion.md 中的目录。每个标题至少应用两个效果;一个标题内不要重复使用同一个效果。
  7. 在浏览器窗格中进行QA。 检查桌面和移动预设,阅读控制台错误,确认在375px处无水平溢出。隐藏的浏览器窗格会限制 requestAnimationFrame 速率,因此那里的慢速启动不是错误。
  8. 部署。 参见 references/deploy.md。创建仓库,以 build_type=workflow 启用 Pages,推送,等待运行,打开在线 URL 并检查那里的控制台。

质量标准

  • 英雄区标题在3D对象上可读(使用文本阴影或布局间距)。
  • 动效使用 cubic-bezier(0.22, 1, 0.36, 1) 或 GSAP 的 expo/elastic,UI 动效永远不用线性。
  • prefers-reduced-motion 将效果转为淡入淡出并禁用平滑滚动。
  • 自适应像素比:当 fps 低于40时降低 DPR。
  • 跳过链接、焦点环、对分割文本的 aria 标签、截图的替代文本、隐私和条款对话框、品牌化404页面、由真实英雄对象渲染的 OG 图片。
  • 移动端:3D 占据视口顶部,文案放在磨砂卡片下方。

相关技能