프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

RuiC-motion-reel Skill

저장소 ↗

제작자: HRuiCcc★ 202skill 1개

설치

What it does

一句话 brief 生成动态图形 / 动效宣传片 · Agent Skill。时长按 BPM×小节算(12–60 秒),默认 1920×1080;常规宣传片走 remotion/ 模板,特殊质感走自研引擎:2× 超采样矢量/文字、真 3D 点云、丝网印四色分色、普朗克/薄膜干涉物理配色、代码合成配乐,不用外部美术素材、不用 AE。16 张风格牌为参考库,已做过九种视觉语言(暗色科技 / riso / 纸艺 / 银盐 / 普朗克恒星 / 氰版蓝图 / 紫外光刻 / 品牌暗色 / 品牌亮色),成片见 docs/films/

  • Connects Instruction files the AI reads
  • Account or key No key found in README or SKILL.md
  • Category 코딩
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/hruiccc-ruic-motion-reel.svg)](https://mcp.popnx.com/en/skills/hruiccc-ruic-motion-reel)

함께 쓰기

같은 작업에서 AI를 서비스에 연결하는 MCP

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

제작자: morluto널리 사용됨↓ 38.9만/주★ 46.8만7일 전 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Fallow

Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.

제작자: fallow-rs널리 사용됨↓ 244.1만/주★ 5.4천그저께 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Desktop Commander

MCP server for terminal commands, file operations, and process management

제작자: wonderwhy-er널리 사용됨↓ 74만/주★ 1만어제 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

비슷한 Skill

같은 종류의 작업, Skill 목록과 같은 순서

비슷한 항목과 비교
이 항목
RuiC-motion-reel
reaandrej-karpathy-skillsgraphifyMoneyPrinterTurbo
제작자HRuiCccmorlutomultica-aiGraphify-Labsharry0703
Skill 수11111
GitHub 별202467,235234,125149,873144,332
마지막 코드 변경2026년 11월 1일2026년 11월 18일2026년 4월 20일2026년 11월 18일2026년 11월 18일
라이선스–MIT–Apache-2.0MIT

HRuiCcc의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요

Skill과 MCP의 차이

MCP = 손

AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.

Skill = 안내서

작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.

겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.

쓸 수 있는 앱

Claude Code

제작자 README와 repo 폴더 기준

설치

Is it safe?

  • Who made it

    GitHub account HRuiCcc (person) is only 2 months old: take extra care

  • Use and upkeep

    ★ 202 stars, few users so far · code last changed 2026년 11월 1일

  • Any scripts?

    27 scripts that can run on a computer: scripts/new_reel.py, engine/__init__.py, engine/anim.py, engine/color.py and 23 more

  • Uses the internet?

    Could not check every script (some are too large); read them first

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit bc1ffd2 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

먼저: 어떤 AI를 쓰시나요

쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다

Option 1Upload to claude.ai (web and app)

  1. Download from GitHub

    This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier

    Download from GitHub (whole repo) ↗

    Unzip it, then zip only the ruic-motion-reel folder again. The ZIP must have a ruic-motion-reel folder with SKILL.md at the top level, no loose files

  2. Open Skills on claude.ai and upload

    +Create skillUpload a skillpick ruic-motion-reel.zip

    Open claude.ai/customize/skills ↗

  3. No Upload button? Turn on file creation first

    SettingsCapabilitiesCode execution and file creation

    Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free

Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)

Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)

Checked against official docs 2026년 11월 12일 · Source: support.claude.com, support.claude.com, code.claude.com

Option 1Claude Code에게 설치 맡기기

이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Claude Code를 다시 열고 /RuiC-motion-reel를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

Checked against official docs 2026년 11월 12일 · Source: code.claude.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.claude/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Claude Code를 다시 열고 /RuiC-motion-reel를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

직접 설치한 Skill은 ChatGPT 데스크톱 앱, Codex CLI, IDE의 Codex 확장 프로그램에서 쓸 수 있습니다 · 웹과 모바일의 ChatGPT에서는 직접 설치한 Skill을 쓸 수 없고 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

ChatGPT 데스크톱 앱

ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다

Option 1ChatGPT에게 설치 맡기기

ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2폴더를 직접 넣기

ruic-motion-reel 폴더를 ~/.agents/skills/ruic-motion-reel에 넣으세요

~는 홈 폴더($HOME)입니다

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

설치한 뒤

  • ChatGPT 데스크톱 앱: 사이드바에서 Skills를 열어 Skill이 보이는지 확인하세요
  • 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
  • Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

웹과 모바일의 ChatGPT

직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

Option 1Codex에게 설치 맡기기

이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Codex를 다시 열고 관련 작업을 요청하면 Codex가 skill을 목록에 보여 줘요

Option 1Cursor에게 설치 맡기기

이 문장을 복사해 Cursor 채팅에 붙여 넣으세요

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Cursor Agent 채팅에서 /를 입력하고 RuiC-motion-reel 선택

Checked against official docs 2026년 11월 12일 · Source: cursor.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.cursor/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Cursor Agent 채팅에서 /를 입력하고 RuiC-motion-reel 선택

Option 1Let the AI install it

Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · Copy this sentence into the app’s chat

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.

GitHub에서 보기 ↗

2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인

원본 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
라이선스
라이선스 명시 없음 이 repo에는 라이선스가 없습니다. 기본적으로 제작자가 모든 권리를 가지므로 배포나 상업적 사용 전에 문의하세요.
최근 코드 수정
2026년 11월 1일
repo 안 SKILL.md(번역본과 템플릿 포함)
1
토픽
agent-skill, creative-coding, ffmpeg, motion-graphics, point-cloud, procedural-generation, python, risograph