ref-image-3d-scenelisted
Install: claude install-skill shine-1314521/ref-image-3d-scene
# 参考图驱动的动漫风 3D 场景生成器
作用:把一张图拆成可执行的渲染决策,然后一段一段地长成一个 HTML 文件——而不是一次许愿。
不是「一次生成成品」,是**可归因的增量修改**。每次只动一个变量,画面变好变坏都能算到具体参数头上。
## 质量优先级(冲突时的裁决顺序)
四条目标并列时按此排序,**前面的优先,不允许为了后面的牺牲前面的**:
| 顺位 | 目标 | 含义 | 典型取舍 |
|---|---|---|---|
| 1 | **准确性** | 主体可辨识、构图与参考图可对差、色彩与光影有数值依据 | 不为了「好看」改动已实测的基线值 |
| 2 | **细节丰富度** | P0/P1 细节到位,近看有内容,不是大色块 | 宁可少两个可动元素,也要把桌面道具做全 |
| 3 | **结构合理性** | 支撑、接触、尺度链、透视、遮挡自洽 | 参考图本身画错时按物理反解,并写明偏离理由 |
| 4 | **整体质量** | 亮度分布、性能、响应式、可交付性 | 前三条都成立后才谈优化帧率与分辨率 |
裁决规则:**当「更快出图」与「更准确」冲突时,选准确**;当「更多特效」与「更合理」冲突时,选合理。
牺牲任一条都要在门禁块里写明「牺牲了什么、代价是什么、可否后续补回」。
> 优先级落地方式:Stage 0 产出可校验的 RCI 修正项(准确性)→ Stage 2/3 逐条兑现 P0/P1(细节)
> → 结构六查(合理性)→ Stage 5/8 收尾(整体质量)。规则见 `references/reference-spec.md`。
## 何时使用
- 用户给出场景参考图(动漫截图、插画、实景照片),希望产出 Three.js 三维场景。
- 用户要求「动漫风 / 赛璐璐 / 卡通渲染 的 3D 网页」。
- 用户已有 Three.js 场景,要求按「构图→材质→光→后处理」的顺序分阶段调优。
- 用户只给文字描述,需要从零构建一个风格化 3D 场景(跳过参考图拆解,走命题拆解)。
- 用户说「只是表面像 / 不够准 / 细节太少 / 结构不对」——先补 Stage 0 的规格书与工程参考,再谈调参。
**不适用**:写实 PBR 场景还原、需要加载外部 glTF/贴图的资产管线、Three.js 之外的引擎(Babylon / Unity WebGL)、纯 2D 插画生成、需要真实物理模拟的场景。
## 硬规则
按违反代价排序,R1–R3 违反即产出报废;R7–R15 违反即整轮返工。
| 编号 | 规则 | 违反后果 |
|---|---|---|
| R1 | 一次只做一个阶段,交付后停下等确认 | 多变量同时变动,问题无法归因 |
| R2 | 每阶段必须落盘一个 HTML 快照,不能只在对话里贴代码 | 无法回滚,改坏了只能重来 |
| R3 | 所有视觉参数集中在文件顶部 `CONFIG`,正文不得出现魔法数字 | 用户无法自改,AI 无法定位 |
| R4 | 不加载外部模型与贴图,全部程序化生成(用户明确授权除外,且需记录 URL 与许可证) | 单文件不再单文件,链接失效即白屏 |
| R5 | 阶段间不越界:前序阶段的能力不得提前实现 | 白模阶段被材质干扰,判断不了构图 |
| R6 | 只输出当前阶段需要的代码,不预写后续逻辑 | 代码臃肿,用户读不懂也改不动 |
| R7 | **几何语言必须匹配参考图**:手绘卡通要用圆角盒 / 自定义轮廓 / 旋转体 / 曲线管,禁止整场