Communitygithub.com

threejs-quality-kit

Three.js 品質套件:用於程式碼影片(Remotion + React Three Fiber)的品質提升工具,整合了所有提升水準的資源、工作方法、檢查清單,以及可傳授給學生的完整套件。

threejs-quality-kit 是什麼?

這是一個專為 Three.js 程式碼影片(使用 Remotion 與 React Three Fiber)設計的品質提升套件。它不僅是一個資源清單,更是一套完整的品質保證系統。該套件彙整了所有能顯著提升影片水準的關鍵資源,包括 GitHub 倉庫、已安裝的技能、素材庫、測量工具、音訊服務等。此外,它定義了一套從「參考 → 技能 → 程式碼研究 → 實作工作坊 → 渲染/觀看/修正 → 驗證」的系統化工作流程,並提供可操作的檢查清單。使用者可以在詢問「Three.js 資源有哪些」、「如何提升 Three.js 品質」、「程式碼影片檢查清單」、「給學生的套件」等問題時,或開始新專案前使用此套件,以確保萬事俱備。此套件支援 Claude Code、Cursor 等 AI 代理工具,並可透過安裝腳本自動設定公共技能。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Alex-sia99/threejs-quality-kit/tree/HEAD/skills/threejs-quality-kit

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Three.js 品質套件 — 資源、方法、檢查清單

這個技能回答一個問題:是什麼讓我們的 Three.js 影片從「堆疊的基本幾何體」變成一部有綁定角色、真實城市與乾淨場景調度的電影? 三件事:隨著專案逐步添加的資源、一套工作方法,以及系統性的審閱。兄弟技能 threejs-code-video 包含技術細節(管線、角色、攝影機、迴圈、陷阱);而這個技能是總覽與入門套件。

內容

檔案用途
references/ressources.md完整清單:倉庫、技能、網站、工具、服務 — 各項資源的用途、安裝方式、授權條款
references/methode.md逐步工作方法,以及真正提升品質的 6 個槓桿
references/checklist.md可勾選的檢查清單:安裝、編碼前、編碼期間、發送前
scripts/install-kit.js在專案中安裝套件的公開技能(克隆 + 複製,無相依性)
scripts/planche.js影片 → 分鏡表(每秒 1 幀),用於完整審閱渲染結果
scripts/polyfork-fetch.js搜尋並下載 Polyfork 模型(可參數化的 .mjs 模組)
scripts/face-landmarks.py、scripts/face-measure.py透過照片測量臉部(使用 MediaPipe),取代肉眼估計

一分鐘了解資源

需求資源在我們的專案中
最新的 Three.js (r186)、R3F、著色器、燈光…13 個 threejs-* 技能 — CloudAI-X/threejs-skills已安裝,每次組合時查閱
逐幀影片渲染8 個 Remotion 技能 — remotion-dev/skills已安裝
程式碼影片方法 + 範本技能 threejs-code-video + 倉庫 Alex-sia99/threejs-code-video由我們編寫,公開
物件、場景、低多邊形角色Polyfork(polyfork.dev,索引 lucas-martinic/polyfork-catalog)用於影片 v3 — .mjs 模組從未重新分發
動畫角色Mixamo 骨架與片段影片 v3 的綁定角色
根據照片實現相似度img2threejs/img2threejs + MediaPipe Face Landmarker採用「測量,而非估計」的方法
建模前的參考圖像Kie.ai nano-banana-2-lite用於比例與場景
語音、音效、音樂ElevenLabs、Suno、FFmpeg完整的管線
程式碼 2D 繪圖(另一種風格)alexgreensh/anidoodle、html-anime已安裝,但非 Three.js

詳細資訊、連結與注意事項:references/ressources.md。

十步驟方法

  1. 先找參考:分析風格影片分鏡、參考圖片、測量照片。
  2. 技能先於程式碼:載入相關的 threejs-* 或 remotion-* 技能,絕不憑記憶撰寫 API。
  3. 研究好程式碼,再重寫:閱讀一個寫得好的模組,記下方法,然後編寫自己的。
  4. 一切都是幀數的純函數:固定種子、距離行進、無累積狀態。
  5. 腳本 → 語音 → 時間軸:場景調度應對齊台詞(at("l14")),永遠不要使用硬編碼的秒數。
  6. 每個問題一個工作坊:臉部用 Lab 組合、身體用 RigLab、有疑問時進行一排實驗。
  7. 渲染、觀看、修正:靜態圖片 → 場景分鏡 → 以每秒 1 幀重新審閱最終影片。
  8. 大改版前,讓新眼睛進行嚴厲審計。
  9. 儘早進行人工驗證:在長時間渲染之前,確認角色與風格方向。
  10. 累積經驗:每個遇到的陷阱都記錄到 pitfalls.md,每個方法都變成一個技能。

詳細資訊:references/methode.md。

不可協商的規則

  • 絕不發送未經觀看的渲染結果。 靜態圖片不足以判斷電影品質:必須以分鏡表重新審閱最終影片。
  • 風格優先於精確度。 在風格化世界中出現寫實臉部已被拒絕兩次;相似度應透過形狀與少數清晰特徵來實現。
  • 遵守授權條款。 Polyfork:可自由用於影片,但 .mjs 模組與烘焙片段絕不能放在公開倉庫或套件中。
  • 一個特徵 = 一個體積、一個地點 = 一個可辨識的物件、一句台詞 = 一個能呈現它的視覺畫面。

將套件傳遞給學生

此套件已發佈在倉庫 **https://github.com/Alex-sia99/threejs-quality-kit**:只需發送此連結即可。README 是為學生編寫的(先備知識、三步驟安裝、要提供給其 AI 代理的提示詞);install.js 會自動下載公開技能與入門專案,因此倉庫保持輕量且更新。切勿在裡面加入 Polyfork .mjs 模組、anim-*.json 片段、API 金鑰、照片或個人語音。

相關技能