ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ ไฟล์คำสั่งให้ AI อ่าน
- บัญชีหรือคีย์ ไม่พบคีย์ใน README และ SKILL.md
- หมวด เขียนโค้ด
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
一句话 brief 生成动态图形 / 动效宣传片 · Agent Skill。时长按 BPM×小节算(12–60 秒),默认 1920×1080;常规宣传片走 remotion/ 模板,特殊质感走自研引擎:2× 超采样矢量/文字、真 3D 点云、丝网印四色分色、普朗克/薄膜干涉物理配色、代码合成配乐,不用外部美术素材、不用 AE。16 张风格牌为参考库,已做过九种视觉语言(暗色科技 / riso / 纸艺 / 银盐 / 普朗克恒星 / 氰版蓝图 / 紫外光刻 / 品牌暗色 / 品牌亮色),成片见 docs/films/สำหรับผู้ทำ: ติดป้ายใน README
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/skills/hruiccc-ruic-motion-reel)ใช้คู่กับ
MCP ที่ต่อ AI เข้ากับบริการในงานเดียวกัน
Fallow
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
Desktop Commander
MCP server for terminal commands, file operations, and process management
Skill ที่ทำงานคล้ายกัน
หมวดงานเดียวกัน เรียงแบบเดียวกับหน้ารายการ Skill
| ตัวนี้ RuiC-motion-reel | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| ผู้ทำ | HRuiCcc | morluto | multica-ai | Graphify-Labs | harry0703 |
| จำนวน Skill | 1 | 1 | 1 | 1 | 1 |
| ดาว GitHub | 202 | 467,235 | 234,125 | 149,873 | 144,332 |
| แก้โค้ดล่าสุด | 1 พ.ย. 2569 | 18 พ.ย. 2569 | 20 เม.ย. 2569 | 18 พ.ย. 2569 | 18 พ.ย. 2569 |
| สัญญาอนุญาต | – | MIT | – | Apache-2.0 | MIT |
ชุดคำสั่ง (Skill) 1 ชุดจาก HRuiCcc ให้ AI อ่านแล้วทำงานตามวิธีนี้ · ไม่ใช่ MCP server
Skill ต่างจาก MCP ยังไง
MCP = มือ
ต่อ AI เข้ากับบริการหรือข้อมูลข้างนอก เช่น อ่าน Notion หรือสร้างใบแจ้งหนี้ ต้องมีโปรแกรมหรือ server ทำงานอยู่
Skill = คู่มือ
ไฟล์ข้อความที่สอน AI ว่างานนี้ทำยังไง ไม่ต่อบริการใด
บางตัวคล้ายกัน: Skill บางตัวมีสคริปต์เรียกเครื่องมือ และ MCP บางตัวส่งแค่ความรู้ ให้ดูที่งานที่อยากทำเป็นหลัก
ใช้กับแอปไหน
Claude Code
ตามที่ README ของผู้ทำเขียนไว้ และโฟลเดอร์ที่มีใน repo
ติดตั้ง
ปลอดภัยไหม
- ใครทำ
บัญชี GitHub HRuiCcc (บุคคล) เพิ่งเปิดมา 2 เดือน ระวังเป็นพิเศษ
- คนใช้และการดูแล
★ 202 ดาว ยังมีคนใช้น้อย · แก้โค้ดล่าสุด 1 พ.ย. 2569
- มีสคริปต์ไหม
มีสคริปต์ 27 ไฟล์ที่รันบนเครื่องได้: scripts/new_reel.py, engine/__init__.py, engine/anim.py, engine/color.py และอีก 23 ไฟล์
- ใช้อินเทอร์เน็ตไหม
ตรวจสคริปต์ได้ไม่ครบ (บางไฟล์ใหญ่เกิน) ควรอ่านเองก่อน
- แก้ค่าตั้งทั้งเครื่องไหม
ไม่พบ hook หรือการเขียนค่าตั้งของเครื่อง
ตรวจอัตโนมัติจากไฟล์ใน repo ที่ commit bc1ffd2 (อ่านไฟล์อย่างเดียว ไม่ได้รัน) ไม่ใช่การรับรองความปลอดภัย อ่านแล้วตัดสินใจเอง
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่ใช้ แล้วหน้านี้จะแสดงเฉพาะวิธีติดตั้งของแอปนั้น
ทางที่ 1อัปโหลดเข้า claude.ai (เว็บและแอป)
ดาวน์โหลดจาก GitHub
Skill นี้ไม่ระบุใบอนุญาต เราจึงไม่แจกไฟล์ ZIP จากเว็บเรา ดาวน์โหลดจาก GitHub แล้วจัดโฟลเดอร์เอง หรือใช้ทาง "ให้ AI ติดตั้งให้" ด้านบนซึ่งง่ายกว่า
ดาวน์โหลดจาก GitHub (ทั้ง repo) ↗
แตกไฟล์ แล้วบีบอัดเฉพาะโฟลเดอร์ ruic-motion-reel ใหม่ ZIP ต้องมีโฟลเดอร์ ruic-motion-reel ที่มี SKILL.md อยู่ชั้นบนสุด ห้ามวางไฟล์หลวมไว้ชั้นบนสุด
เปิดหน้า Skills ใน claude.ai แล้วอัปโหลด
+Create skillUpload a skillเลือกไฟล์ ruic-motion-reel.zip
ไม่เห็นปุ่ม Upload: เปิดสิทธิ์สร้างไฟล์ก่อน
SettingsCapabilitiesCode execution and file creation
ต้องเปิด Code execution and file creation ก่อน (เมนูรุ่นใหม่เรียก Create and edit files) · แผนส่วนตัวที่ Settings → Capabilities · Team/Enterprise ผู้ดูแลเปิดที่ Organization settings → Plugins & skills · ใช้ได้ทุกแผนรวมแผนฟรี
อัปโหลดครั้งเดียว ใช้ได้ทั้ง claude.ai และ Claude Desktop รวมถึง Claude Code รุ่นใหม่ที่ล็อกอินด้วยบัญชี Claude (ล็อกอินด้วยคีย์ API ไม่ซิงก์)
Cowork และ session บนคลาวด์ใช้ Skill ที่เปิดในบัญชี claude.ai ไม่อ่าน ~/.claude/skills ในเครื่อง (งานตั้งเวลาของ Claude Desktop ที่รันในเครื่องยังอ่านได้)
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: support.claude.com, support.claude.com, code.claude.com
ทางที่ 1ให้ Claude Code ติดตั้งให้
คัดลอกประโยคนี้ไปวางในแชตของ Claude Code
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
เปิด Claude Code ใหม่ แล้วพิมพ์ /RuiC-motion-reel หรือสั่งงานที่ตรงเรื่อง Claude จะเลือกใช้เอง
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: code.claude.com
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.claude/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
เปิด Claude Code ใหม่ แล้วพิมพ์ /RuiC-motion-reel หรือสั่งงานที่ตรงเรื่อง Claude จะเลือกใช้เอง
Skill ที่ติดตั้งเองใช้ได้ในแอป ChatGPT บนคอม, Codex CLI และส่วนขยาย Codex ใน IDE · ChatGPT บนเว็บและมือถือใช้ Skill ที่ติดตั้งเองไม่ได้ ใช้ได้เฉพาะ Skill ที่มากับปลั๊กอินในไดเรกทอรี
แอป ChatGPT บนคอม
แอป ChatGPT บนคอมมี Codex อยู่ในตัว Codex อ่าน Skill จากโฟลเดอร์ ~/.agents/skills
ทางที่ 1ให้ ChatGPT ติดตั้งให้
เปิด Codex ในแอป ChatGPT บนคอม แล้ววางประโยคนี้ในแชต
AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
ทางที่ 2วางโฟลเดอร์เอง
วางโฟลเดอร์ ruic-motion-reel ไว้ที่ ~/.agents/skills/ruic-motion-reel
~ คือโฟลเดอร์บ้านของคุณ ($HOME)
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.agents/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
หลังติดตั้ง
- แอป ChatGPT บนคอม: เปิด Skills ในแถบข้างเพื่อดูว่า Skill ขึ้นแล้ว
- เรียกใช้: ใน ChatGPT พิมพ์ @ แล้วเลือก Skill · ใน Codex CLI หรือส่วนขยายใน IDE พิมพ์ /skills หรือพิมพ์ $ แล้วตามด้วยชื่อ Skill
- Codex เห็น Skill ที่ติดตั้งใหม่เอง ถ้ายังไม่ขึ้นให้ปิดแล้วเปิด Codex ใหม่
ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com
ChatGPT บนเว็บและมือถือ
ใช้ Skill ที่ติดตั้งเองไม่ได้ ใช้ได้เฉพาะ Skill ที่มากับปลั๊กอินในไดเรกทอรี
อยากใช้ Skill นี้กับ ChatGPT ให้ใช้แอป ChatGPT บนคอมตามวิธีด้านบน
ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com
ทางที่ 1ให้ Codex ติดตั้งให้
คัดลอกประโยคนี้ไปวางในแชตของ Codex · ใช้ได้ทั้ง Codex ในแอป ChatGPT บนคอม, Codex CLI และส่วนขยายใน IDE
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
Codex เห็น Skill ที่ติดตั้งใหม่เอง ถ้ายังไม่ขึ้นให้ปิดแล้วเปิด Codex ใหม่ · เรียกใช้: ใน ChatGPT พิมพ์ @ แล้วเลือก Skill · ใน Codex CLI หรือส่วนขยายใน IDE พิมพ์ /skills หรือพิมพ์ $ แล้วตามด้วยชื่อ Skill
ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.agents/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
เปิด Codex ใหม่ แล้วสั่งงานที่ตรงเรื่อง Codex จะเห็น skill นี้ในรายการ
ทางที่ 1ให้ Cursor ติดตั้งให้
คัดลอกประโยคนี้ไปวางในแชตของ Cursor
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
ใน Agent chat ของ Cursor พิมพ์ / แล้วเลือก RuiC-motion-reel
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: cursor.com
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.cursor/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
ใน Agent chat ของ Cursor พิมพ์ / แล้วเลือก RuiC-motion-reel
ทางที่ 1ให้ AI ติดตั้งให้
สำหรับแอปอื่นที่อ่าน Skill ได้ ประโยคนี้มี path ของ Claude Code, Codex และ Cursor ให้ AI เลือกตามแอปที่ใช้ · คัดลอกประโยคนี้ไปวางในแชตของแอป
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: code.claude.com, learn.chatgpt.com, cursor.com
สำหรับคนที่ใช้ Terminal
แอปอื่นที่รองรับ Agent Skills (เช่น Gemini CLI, GitHub Copilot) เก็บ skill ในโฟลเดอร์ต่างกัน ดูคู่มือของแอปนั้น แล้วคัดลอกโฟลเดอร์ที่มี SKILL.md ไปวาง
ตรวจโฟลเดอร์ skill กับคู่มือทางการของ Claude Code, Codex และ Cursor เมื่อ 11 พ.ย. 2569
ดูไฟล์ต้นฉบับ SKILL.md
ข้อความต่อไปนี้มาจาก repo ของผู้ทำ ไม่ใช่คำสั่งของ PopNx MCP
แสดง 8,000 ตัวอักษรแรก · เปิดไฟล์เต็มบน GitHub
---
name: ruic-motion-reel
description: "用代码生成动态图形与动效宣传片成片,时长按需(12 / 15 / 24 / 30 / 45 / 60 秒),默认 1920×1080。两条路线:常规宣传片(HUD / 终端 / 动字 / 玻璃面板 / 粒子)走仓库自带的 remotion/ 模板(React 组件 + 浏览器渲染,60fps 无压力);需要自研渲染独有能力(超采样矢量文字、真 3D 点云、丝网印/riso 四色分色、普朗克真彩色、合成器配乐)走本引擎的 Python 管线。画面与音乐全部由代码产出、不用任何外部美术素材、不用 AE。视觉语言有 16 张牌,默认随机抽一张(轻的、非 3D 的、编辑排版/手绘/纸艺/标本那类一样做),不默认做最炫的那一支。当用户说「用代码做个动效视频/动态图形/motion graphics」「生成一条作品集样片/产品片/宣传短片」「做一条 24 秒/30 秒的品牌片」「按某种风格做视频」「给某个品牌/产品做一条片子」「复刻某条动效片的风格」,或要改已有片子的品牌、配色、节奏、镜头、时长时使用。触发词:动效视频、动态图形、motion graphics、作品集样片、产品片、宣传片、任意时长、24 秒、30 秒、1080p30、1080p60、代码生成视频、ruic-motion-reel。"
user-invocable: true
metadata:
dsh:
compatibility: native
requires:
- python3
- ffmpeg
---
# RuiC-motion-reel —— 代码生成动态图形成片
一条产线:**从零用代码渲染出一支动态图形 / 动效宣传片**,**片长由 BPM × 小节算出来**
(12 / 15 / 24 / 30 / 45 / 60 秒都能做),默认交付 **1920×1080**。
画面(字体、3D、粒子、印刷分色)和音乐(合成器)全部由代码产出,
不依赖任何外部美术素材、不打开 After Effects。
**两条路线**:常规宣传片(HUD / 终端 / 动字 / 玻璃面板 / 粒子)走 `remotion/` 模板;
自研引擎独有的(印刷分色、点云 3D、物理反解颜色)走下面的 Python 管线。
选型与分镜模板见 `references/promo-brief.md`。
> **本 skill 由作者用 DeepSeek Flash 跑通**(建模 / 排版 / 分色 / 配乐 / 出片全链路)。
> **不绑定模型**:纯 Python + ffmpeg,不含任何模型专属依赖,
> 支持各大主流多模态模型——任何能读写文件、执行命令的编码 Agent 都能用。
已经用它做过这几类视觉语言:
| 语言 | 观感 | 关键手法 |
|---|---|---|
| **暗色科技** | 近黑底板 + 霓虹青/品红、HUD 套件、发光字体 | 加色光缓冲、bloom、色差、扫描线 |
| **丝网印 / riso** | 暖米纸张 + 荧光三色油墨、网点、套印 | multiply 叠印、半调网点、套印偏移、纸纹 |
| **品牌暗色产品片** | 品牌色暗色主题 + 真实产品 UI + 3D 硬件 | 品牌色板映射、真 3D 建模、产品界面复刻 |
| **暗房 / 银盐** | 中性纸白 + 碳黑 + 一个安全灯红,无网点无霓虹 | 光晕 halation、片门微抖、两级银盐颗粒、点云刻线 |
| **恒星 / 普朗克真彩色** | 深棕余烬底 + 黑体色温条 + 光谱线,没有一个是挑的 | 普朗克→CIE 1931→sRGB 反解颜色、点云磁流管、真谱线 |
| **紫外光刻 / 半导体** | 近黑冷蓝腔体 + 405 nm 紫外紫 + 氧化层彩虹,一条片子走完版图→掩膜→曝光→显影→探针→划片 | 薄膜干涉真彩、递归版图生成、衍射曝光场(振幅孔径过环形 PSF 再平方)、彩色点云(每点带自己的颜色) |
| **品牌亮色产品片** | 品牌自己的纸白 + 品牌色满幅,迪多尼大标题骑在发丝网格上,两场暗场换气 | 官方 lockup 真素材位图、亮底反转后期、品牌色与 token 逐个实测、产品界面自绘 |
> 最后一支 **LITHO**(`docs/films/litho-wafer-15s.mp4`,1080p / 160 BPM / 10 小节 × 1.5 s)是这条线的样板,
> 同时是牌堆里的 `uv-litho`。它的颜色全部追得到物理量:曝光光 = 405 nm 反解,
> 晶圆彩虹 = SiO₂ 厚度 20–780 nm 的双光束干涉积分到 CIE 1931。
### 风格:从一句话推出来,不抽牌(2026-11 用户定调)
上面九支是引擎**做过**的九种,**不是**可选清单,也不是默认答案。
**"一句话生不同的动态样式视频"才是这条产线的用法**:不参考历史片,也不从牌堆里挑。
一句话进来,先落成 `SPEC.md`,再由 SPEC 决定一切:
```bash
python3 {skill_dir}/scripts/new_reel.py <片子目录> --brief "做一条 20 秒的咖啡品牌片,暖色胶片感,慢"
```
读出来的是六件事 —— **时长 / 画幅 / 冷暖 / 质感 / 节奏 / 语言**,
由它们推出**色板(H/S/L 反解)+ 字体对 + 运动语法 + 分镜骨架**,全部写进 SPEC.md 和 theme.py:
| 句子里出现 | 推出的东西 |
|---|---|
| "20 秒" | 时长 + 反解出一组每小节整数帧的 BPM/小节 |
| "竖屏" / "9:16" | 1080×1920,作者空间 720×1280 |
| "暖 / 咖啡 / 日落" | 基色相 26°,暗底,主色推到琥珀 |
| "冷 / 科技 / 夜" | 基色相 214°,主色推到电青 |
| "胶片 / 颗粒" | 颗粒 + halation + 片门微抖,转场 flash-frame,衬线标题 |
| "印刷 / riso" | 网点 + 套印偏移 + 纸纹,转场 ink-wipe |
| "极简 / 瑞士 / 杂志" | 亮底、无颗粒、只有发丝线,转场 wipe |
| "慢" / "快" | 决定一小节塞几个动作、以及反解时偏好哪个 BPM 区间 |
同一句话永远给同一个结果;换一句话就是另一套样子。**这就是"不生限制"的含义**:
没有必须 15 秒、必须横屏、必须全英文、必须先抽牌这些前置条件——句子说什么就是什么,
句子没说的才用默认值(16:9 / 30fps / 15s / 中性)。
16 张风格卡还在(`scripts/style_lottery.py`),但**降级为参考库**:
只有在"我就是想要那种印刷/纸艺/仪器图录的样子"时才 `--style <id>` 指一张,
默认不抽、不写 STYLE.md。
推完 SPEC 之后仍然要一场一场写 `scenes.py` —— SPEC 说清了"该长什么样",
画面还是得画出来。方法见 `references/style-synthesis.md`。
> ## ⚠️ 默认出口不在这里(2026-09-28 用户定调)
>
> **常规成片默认走本机已有的 Remotion 产线**(耶莱 / 亚莱 / 克莱 / 梦莱 / 企鹅 / 排行榜 1&2),
> 从最接近的那条复制一份改数据文件即可。**本技能是特殊风格的最后手段**,
> 只在需要它独有能力时才用(点云写实 3D / 印刷分色 / 普朗克真彩色 / 合成器配乐)。
>
> 用它的时候两条硬规矩:**编码走 `h264_nvenc`**(实测比 libx264 快 3.7 倍、体积小 28%、
> PSNR 差 0.9 dB),**并行度不许吃满全机**(一场一核足够,用户原话「cpu爆了」)。
>
> **注意:Remotion 也不是 GPU 渲染**——它的帧同样是 headless Chrome 在 CPU 上画的,
> 显卡真正出力的只有**编码**那一步。路由与配方见 `references/remotion-default.md`。
## DSH 运行约定
- `{skill_dir}` 是本 `SKILL.md` 所在目录。引擎、模板、字体、参考文档都在其下,用绝对路径定位。
- 文中命令都写 `python3`。**在 Windows 上换成 `py -3`**——`python3` 很可能是应用商店的
别名桩,非交互下静默退出(exit 49,什么都不吐),会被误判成脚本有问题。
- **产出写进用户指定的项目目录**,不改 `{skill_dir}` 内的模板真源;需要模板时先复制。
- 渲染是 CPU 密集的长任务(15 秒 ≈ 1~3 分钟多进程),开工前说清目标目录与预计耗时。
- 成片审核由用户做:渲完把文件路径直接给用户。
---
## 一、先判断:是「新做一支」还是「改已有的」
| 用户意图 | 走哪条 |
|---|---|
| 新做一支(没指定风格) | 先按下面「二」问清 3 件事,再按「四」开工 |
| 新做一支(指定了品牌/配色/参考片) | 先做「三」的品牌取色,再按「四」开工 |
| 改已有片子(改品牌/配色/节奏/镜头) | 进该片目录,只改 `theme.py` + 相关 scene,**不要重建工程** |
| 只要某个镜头/效果 | 从 `template/scenes.py` 抽对应类,单独 `--at` 渲染验证 |
---
## 二、开工前必须定下的三件事(风格已由 brief 推成 SPEC)
这三件事决定了整支片子的骨架,**含糊就必问**,不要自己替用户选完就开工。
风格不在这三件里——它已经由 `scripts/brief.py` 推成 `SPEC.md` 了,照着执行:
1. **时长与节奏**。默认 15 秒,**宣传片从 24 秒起**(12 小节 × 2.0 s,够讲完三个 act)。
节奏必须落在一个音乐网格上(见下),别用"大概每 2 秒切一次"。
2. **说话对象与文案**。是产品片、作品集样片还是品牌片?文案用什么语言?有没有必须出现/必须不出现的词(例如某些片子要求全英文、要出现某域名、不能出现某个品牌)。
3. **品牌色**。有品牌就必须**取实测色值**,不要凭印象挑(见「三」)。
### 时间网格:先定 BPM,再定镜头
整片锁在一个音乐网格上,**每个场景正好一小节**,每次剪辑都落在强拍上。
所以「画面节奏」和「音乐」是同一套时间轴,而不是后期硬凑的。
```
秒数 = 小节数 × 每小节拍数 × 60 / BPM
BPM = 每小节拍数 × 60 × 小节数 / 总秒数
```
**先选片长,再反解 BPM**(任选,别自己发明分数):
| 片长 | 小节数(=镜头数) | BPM | 每小节 | 适合 |
|---|---|---|---|---|
| 12 s | 8 | 160 | 1.500 s | 纯冲击,无叙事 |
| 15 s | 8 | 128 | 1.875 s | 作品集样片、单点 demo |
| **24 s** | **12** | **120** | **2.000 s** | **宣传片起点:三个 act** |
| 30 s | 10 | 80 | 3.000 s | 需要一点呼吸的品牌片 |
| 45 s | 12 | 64 | 3.750 s | 产品发布、功能串烧 |
| 60 s | 15 | 60 | 4.000 s | 开场短片、展会循环 |
`theme.plan(seconds)` 会反解出「每小节整数帧」的那组 BPM/小节;
`new_reel.py <dir> --seconds 24` 直接按目标时长起工程(BARS/BPM/DUR 一起改好)。
12 秒以下别做(BPM 会飙过 200),45 秒以上别靠堆场景撑,按 act 切。
**8 小节 ≠ 必须 8 个场景**:场景 02 可以是「一拍一个词」的四个词,等于把 1 小节拆成 4 拍用。
**帧数 = 秒 × FPS**(默认 30 fps:15 秒 = 450 帧,24 秒 = 720 帧)。
一小节 = `4 × 60 / BPM × FPS` 帧;8 小节 @128 BPM 是 56.25 帧,所以别写死每场 56 帧,
用 `int(round(...))` 从时间反解(模板的 `render_one` 已经这么做了)。
12 小节 @120 BPM @30fps 正好 60 帧/小节,是整数——这也是推荐 24 秒做宣传片的原因。
**BARS 不必等于场景数**:`scene_plan()` 会把 `SCENES` 循环铺满 BARS(12 小节用 8 个场景类也跑得动,
带 seed 的场景会按小节错开种子)。要自定义多小节结构,在 `scenes.py` 里写
`SEQUENCE = [A, B, B, C, ...]`,长度必须等于 `BARS`。
---
## 三、品牌取色:量,不要猜
**这是整条产线最容易翻车、也最容易做出「专业感」的地方。**
1. **先找本机已有的实测色板**。用户往往已经为某个品牌做过片子,颜色是当时从截图里
聚类采样出来的——比任何猜测都准。搜:
```bash
ls ~/.agents/skills | grep -i <品牌相关词>
grep -rn "#[0-9a-fA-F]\{6\}" ~/.agents/skills/<那个skill>/template/ --include="*.ts*"
```
2. **再核对官网**(官网营销色和产品界面色经常不是同一个绿):
```bash
curl -sL -A "Mozilla/5.0" https://<官网>/ -o /tmp/site.html
grep -o -i '#[0-9a-f]\{6\}' /tmp/site.html | tr 'A-Z' 'a-z' | sort | uniq -c | sort -rn | head -15
```
3. **暗色片怎么用亮色品牌的色板**:暗色版本不是另挑一套色,而是**把品牌色放到曝光另一端**。
底板用「品牌墨色压暗」的深色(例如产品标题墨蓝压成近黑),主色仍是品牌色本体,
再取色板的语义色(信息蓝 / 警告橙 / 危险红)做读数,这样片子立刻就是这个品牌的。
4. **字体挑之前先量**。若要贴近某条参考片,量它定稿字块的**字高 / 字宽比**再选字体,
不要凭眼感(见 `references/design-grammar.md` 里的比例核对法)。
---
## 四、制作流程
```bash
# 1) 一句话起片(engine/ 与 template/ 复制成自包含工程,并把 SPEC 写进 theme.py)
python3 {skill_dir}/scripts/new_reel.py <片子目录> --brief "一句话需求"
# 只想调片长/不想给 brief:--seconds 24 或 --bars 12
cd <片子目录>
# 2) 改 theme.py:品牌、时间网格、色板、文案(牌面要求原生纹理时把 W, H 设成交付尺寸)
# 3) 改 scenes.py:按 SPEC.md 的分镜骨架与运动语法来写(不是照抄历史片)
# 4) 逐场审阅(关键!不要渲完再看)
python3 -m <包名>.build --stills 0 # 一场抽 7 帧拼长图
python3 -m <包名>.build --at 3:1.20 # 某一拍的单帧全分辨率
# 5) 全片
python3 -m <包名>.build
```
### 交付规格已经是 1080p30,不用再调
`template/theme.py` 出厂即:`FPS = 30`、`OUT_W, OUT_H = 1920, 1080`、
`W, H = 1280, 720`(**排版空间**)。布局按 720p 写,出来的是 1080p 文件:
矢量/文字通道在交付尺寸上超采样渲染(所以字是锐的),
只有辉光、颗粒、纸纹这类软遮罩在排版空间生成、入板时重采样一次。
**因此:字号、边距、HUD 尺寸都按 720p 的直觉写就行,不用乘 1.5。**
例外是**靠细纹理吃饭的牌**(丝网印网点、凸版、拼贴、纸艺):网点是细节,
必须原生清晰——这些牌把 `W, H = OUT_W, OUT_H`,直接在交付尺寸上排版,
牌面里 `author_at_delivery` 标了这一条。代价是重采样没了、渲染慢一倍,
其余一切照旧(`gauss(W, H, ...)` 这类调用不用改,W/H 已经是新值)。
### 每场的实现顺序(照这个顺序做,返工最少)
1. **底板 + 环境光**(背景、地平线/纸纹、网格)→ `--at` 渲一帧,先确认**亮度对**
2. **主体**(大字 / 3D / 图形)→ 再看一帧
3. **运动**(入场、缓动、错帧)→ 抽 7 帧看时间轴
4. **HUD / 版式细节** → 最后加,它是最容易喧宾夺主的东西
### 亮度必须对着参考片量,不能靠眼睛
在同尺寸同色调下比较**均值 / 中位数 / p95**,暗场常见偏差是「整体亮了 2~3 倍」:
```bash
ffmpeg -v error -ss <t> -i ref.mp4 -frames:v 1 -f rawvideo -pix_fmt rgb24 - | python3 -c "
import sys, numpy as np
a = np.frombuffer(sys.stdin.buffer.read(), np.uint8).reshape(720,1280,3).astype(np.float32)
bg = a[::6,::6].reshape(-1,3)
print('mean', bg.mean(0).round(1), 'median', np.median(bg,0), 'p95', np.percentile(bg,95,0))"
```
差值大通常不是「调色」问题,而是**管线里多做了一次线性→sRGB 编码**(见 `references/gotchas.md`)。
---
## 五、可选能力(按需读参考文档)
| 要做的效果 | 读哪个 | 引擎入口 |
|---|---|---|
| 类型排版、字号标定、HUD 版式 | `referพูดคุย
ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
ข้อมูลจาก GitHub
- ดาว GitHub
- 202
- ผู้ทำ
- HRuiCcc
- license
- ไม่ระบุสัญญาอนุญาต รีโปนี้ไม่ได้ระบุสัญญาอนุญาต (license) ตามกฎหมายลิขสิทธิ์ถือว่าเจ้าของสงวนสิทธิ์ไว้ ใช้เองได้แต่ควรถามเจ้าของก่อนแจกต่อหรือใช้ในงานขาย
- แก้โค้ดล่าสุด
- 1 พ.ย. 2569
- ไฟล์ SKILL.md ใน repo (นับรวมสำเนาภาษาอื่นและแม่แบบ)
- 1
- topic
- agent-skill, creative-coding, ffmpeg, motion-graphics, point-cloud, procedural-generation, python, risograph