使い方
- インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
- 必要なツール、認証情報、対応環境を原文で確認します。
- 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/full-stack-skills/threejs-skills --skill threejs-dev-setup開始前の確認
- 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
- スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。
When to use this skill
ALWAYS use this skill when the user mentions:
- Creating or configuring a new three.js project, Vite/Webpack/Rollup entry, or browser
importmap - Installing the
threepackage, aligning version with documentation, or TypeScript setup (@types/threewhere applicable) - Import errors for
three/addons/...,examples/jsm, ESM vs CJS interop, or bare specifier resolution
IMPORTANT: this skill vs runtime topics
- threejs-dev-setup = install paths, bundler, module graph, and where to import addons from.
- threejs-renderers =
WebGLRenderer/WebGPURenderer, canvas, pixel ratio, render loop—after the project loads. - threejs-loaders =
GLTFLoader,DRACOLoader, progress callbacks—after imports resolve.
Trigger phrases include:
- "vite three.js", "webpack three", "import map", "three/addons", "cannot find module", "jsm"
- "新建项目", "安装 three", "找不到模块", "ESM", "TypeScript three"
How to use this skill
- Confirm delivery model: SPA bundler (Vite/Webpack), Node tooling, or static HTML with
importmap—each affects howthree/addons/resolves. - Pin `three` version to a release compatible with the docs the user cites; note that addon paths follow the published package layout.
- Show canonical imports: core from
three; controls/loaders/effects fromthree/addons/...(mapped toexamples/jsmin source tree). See examples/workflow-scaffold.md. - Minimal loop: create renderer + scene + camera + one mesh;
requestAnimationFrame—enough to verify toolchain without duplicating threejs-renderers depth. - TypeScript: enable
moduleResolutionappropriate for bundler; reference types fromthreepackage typings; avoid duplicating global script tag patterns unless user targets no-bundler HTML. - On failure: distinguish missing dependency vs wrong path vs SSR context (no
window/document). - Deepening: link user to three.js manual first chapter after scaffold works.
Doc map (official)
| Docs section | Representative links |
|---|---|
| Manual (getting started) | https://threejs.org/manual/ |
| Docs index | https://threejs.org/docs/ |
| Package / install context | https://www.npmjs.com/package/three |
Scope
- In scope: npm/install, bundlers, import maps, TypeScript basics for three, addon import paths, minimal verification snippet.
- Out of scope: WebGL theory, full render target or post stack (threejs-renderers, threejs-postprocessing), physics, deployment beyond "build runs".
Common pitfalls and best practices
- Mixing multiple
threecopies in one page breaks singletons; dedupe with bundler aliases. - Importing addons from deep
node_modules/.../examples/jsmpaths is fragile; prefer package exportsthree/addons/...when available. - Always match r152+ style color management docs when giving snippet defaults (output color space)—point to threejs-renderers/textures for details.
- SSR frameworks need dynamic import or client-only components for WebGL context.
Documentation and version
Toolchain and import paths follow the three npm package version the user installs. The Manual and docs are updated with the library; addon paths (three/addons/...) must match the package layout for that release—when in doubt, cite the version number and the exact import line from the current docs.
Agent response checklist
When answering under this skill, prefer responses that:
- Name the bundler or runtime (Vite, Webpack, bare ESM,
importmap) and the intendedthreeversion. - Link https://threejs.org/manual/ and/or https://threejs.org/docs/ for authoritative setup context.
- Distinguish threejs-dev-setup (resolution) from threejs-renderers (runtime API) failures.
- Never assume global script tags unless the user explicitly uses CDN/no-bundler HTML.
- Recommend deduplicating
threeinpackage.json/ lockfile when duplicate singleton issues appear.
References
- https://threejs.org/manual/
- https://threejs.org/docs/
- https://www.npmjs.com/package/three
Keywords
English: three.js, vite, webpack, rollup, import map, typescript, npm, three/addons, examples jsm, module resolution, scaffold
中文: three.js 安装、构建、importmap、模块解析、three/addons、脚手架、Vite、Webpack