Three.js着色器 技能
GLSL uniform、着色器片段、自定义效果及TSL替代。
社区 · CloudAI-X| 作者 | CloudAI-X |
|---|---|
| 许可证 | MIT |
| 来源 | CloudAI-X/threejs-skills · GitHub 上的 SKILL.md |
| 适用于 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| 读取源文件日期 |
threejs-shaders: GLSL uniform、着色器片段、自定义效果及TSL替代。
这是针对 Three.js r186 的社区参考指令;图形引擎需单独安装。
摘自该技能的 SKILL.md: # Three.js Shaders
功能
- 实现自定义着色并明确输出颜色处理。
产出内容
- 项目代码和实现指导,不是托管渲染服务。
适用场景
- 在着色器中移动顶点。
不适用的场景
- 需要自动安装引擎或保证设备性能。
所需条件
- 可操作项目的代理、兼容的 Three.js 依赖和浏览器;React 或资产工具按任务另配。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 参考示例、API 边界和迁移说明。 |
2026-11-16 在仓库中查到的许可证:MIT。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 在着色器中移动顶点。
- 添加自定义uniform。
- 将GLSL效果迁移到TSL。
如何安装 threejs-shaders
准备工作流程
复制技能目录,再按所读源码匹配项目依赖。这不会安装 Three.js,也不代表云端执行已验证。
技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:
Claude Code:把文件夹复制到技能文件夹
把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。
git clone --depth 1 https://github.com/CloudAI-X/threejs-skills.git
mkdir -p ~/.claude/skills
cp -R threejs-skills/skills/threejs-shaders ~/.claude/skills/Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /threejs-shaders,或直接描述任务。
在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。
Codex、Gemini CLI、Cursor 和 GitHub Copilot
这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:
git clone --depth 1 https://github.com/CloudAI-X/threejs-skills.git
mkdir -p .agents/skills
cp -R threejs-skills/skills/threejs-shaders .agents/skills/| 智能体 | 项目文件夹 | 用户文件夹 | 说明 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | 输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | 在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | 适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。 |
这些步骤的来源
已于 2026-11-14 对照各厂商的文档核实:
实现边界
色调映射与色彩空间转换要匹配渲染流程;改名的片段可使字符串替换静默失效。
在项目中验证
检查编译错误,并与内置材质比较输出颜色。
关于 threejs-shaders 的常见问题
安装技能会安装 Three.js 吗?
不会,项目包需单独安装。
这是 Three.js 官方技能吗?
不是,这是 CloudAI-X 发布的社区参考。
涵盖RawShaderMaterial吗?
对比原始与内置着色路径。
WebGPU直接替换GLSL吗?
不是,应使用节点材质和TSL路径。
更多 AI 技能
相关技能
Three.js泛光 技能
社区 · Scott Sun在明确曝光和材质所有权下实现HDR泛光。Shader GLSL 技能
社区 · iArt为运动、过渡和生成式背景编写片元着色器。Three.js基础 技能
社区 · CloudAI-X场景、相机、渲染器、变换和清理。Three.js性能 技能
社区 · CloudAI-X绘制调用、GPU内存、填充率、CPU循环及着色器停顿。Three.js几何体 技能
社区 · CloudAI-X内置形状、BufferGeometry、实例化、批处理和点云。Three.js材质 技能
社区 · CloudAI-X无光照、受光、PBR、透明和节点材质。