昨天刚和大家分享过 vue-skills：🔗Vue Skills 发布！Vue3 "AI 避坑指南"！
简单说，它干的事就是一件：把 Vue 的最佳实践，提前告诉 AI，别让它乱写。
没想到，Three.js 这边马上也跟上了。
threejs-skills 做的事情其实一模一样：
👉 教 AI 正确写 Three.js
这不是巧合，而是很自然的事情。
因为 Three.js 对大部分前端来说，本来就难。
😵 为什么 AI 写 Three.js 特别容易翻车？
Three.js 难在哪，其实很多前端都心里有数：
API特别多，看着就头大文档能看懂，但照着写不一定对性能、内存这些问题，调起来很要命Demo能跑，项目一上就开始出事
所以你经常会看到 AI 写出来的 Three.js 代码：
- 用了早就不推荐的
API render loop写得随心所欲几何体、材质、贴图从来不释放灯光、后处理全开，显卡直接起飞- 看着很复杂，但完全不是工程写法
这些坑，对老 Three.js 开发来说一眼就能看出来， 但 AI 并不知道哪是坑。
threejs-skills 要做的，就是把这些坑提前告诉 AI。
📦 threejs-skills 到底是什么？
说白了，threejs-skills 就是一套给 AI 用的 Three.js 经验包。
它不是教程，也不是示例合集。
它更像是：
Three.js的「避坑清单（AI 专用）」- 老
Three.js开发踩过的坑的总结 官方文档+社区经验的整理版
🧱 threejs-skills 里都有什么？
threejs-skills 的内容很清晰，它按照技术模块拆分，每一块都是一个技能文件：
| 技能 | 内容简介 |
|---|---|
| threejs-fundamentals | 场景初始化、相机、渲染器、坐标体系等基础设置 |
| threejs-geometry | 常用几何体、BufferGeometry、实例等 |
| threejs-materials | 各种材质（PBR、Standard、ShaderMaterial 等） |
| threejs-lighting | 光源类型、阴影配置、环境光等 |
| threejs-textures | 纹理类型、UV 映射、贴图处理 |
| threejs-animation | 动画混合器、骨骼动画、关键帧等 |
| threejs-loaders | 模型加载（GLTF/GLB）、纹理加载、异步模式 |
| threejs-shaders | GLSL 基础、自定义着色器写法 |
| threejs-postprocessing | 后处理效果（Bloom、DOF、Pass） |
| threejs-interaction | 鼠标/触摸输入、射线检测、控件交互 |
这些文件加起来，就像把 Three.js 的“套路和方法”拆成了一块块小卡片， AI 在写代码时能自动去参考和组合。
⚡ threejs-skills 怎么用？
这是 threejs-skills 最大不同于普通文档的地方 —— 它是给 AI 工具用的，不是给人看的说明书。
🧩 安装到本地
最简单的方法是把它放到你项目里的 .claude/skills 目录下（这是 Claude Code 的习惯目录）：
git clone https://github.com/CloudAI-X/threejs-skills
或者你也可以手动把里面的 skills 文件夹复制到 .claude/skills 里。
也可以在你的项目里执行一行命令：
npx add-skill CloudAI-X/threejs-skills
这一步会把 threejs-skills 按 Agent Skills 规范装好。
🔍 装和不装，有什么区别？
简单对比一下就很清楚了：
| 没有 threejs-skills | 有 threejs-skills |
|---|---|
| 能跑就算成功 | 要考虑能不能长期跑 |
| Demo 思路 | 工程思路 |
| 性能随缘 | 性能有底线 |
| 写完就走 | 会考虑后续维护 |
它不会让 AI 一下子变成 Three.js 大神， 但能帮你少踩很多低级又隐蔽的坑。
🔮 Three.js 的门槛，真的在变低
threejs-skills 本身，其实不只是 Three.js 的事情。
它和 vue-skills 指向的是同一个方向：
以后写代码， 关键不是“AI 会不会写”， 而是“你有没有提前告诉它什么是对的”。
当连 Three.js 这种门槛很高的技术， 都开始被整理成 Skills 交给 AI，
意味着一件事：
普通前端，也能更轻松、更安全地用上 Three.js 了。
如果你正在用 AI 写 Three.js， 这个项目，真的值得试一试。
- 🔗 GitHub：
https://github.com/CloudAI-X/threejs-skills
