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

video-spec-builder Skill

저장소 ↗

제작자: feicaiclub★ 1,078skill 1개

설치

What it does

video-spec-builder —— 把我想做个视频逼成一份精确到秒的分镜脚本 video-spec.md,交给 HyperFrames 渲染。一条命令装到 Claude Code / Cursor / Codex:npx skills add feicaiclub/video-spec-builder

  • 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/feicaiclub-video-spec-builder.svg)](https://mcp.popnx.com/en/skills/feicaiclub-video-spec-builder)

함께 쓰기

같은 작업에서 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 목록과 같은 순서

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

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

Skill과 MCP의 차이

MCP = 손

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

Skill = 안내서

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

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

쓸 수 있는 앱

Claude CodeCodexCursor

제작자 README와 repo 폴더 기준

설치

Is it safe?

  • Who made it

    GitHub account feicaiclub (person), 2 years old

  • Use and upkeep

    ★ 1,078 stars · code last changed 2026년 5월 18일

  • Any scripts?

    No, plain text files the AI reads and follows

  • Uses the internet?

    No scripts, so it does not go online by itself

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

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

먼저: 어떤 AI를 쓰시나요

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

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

  • Files are byte-for-byte the same as on GitHub at commit 9e73275 · View on GitHub ↗

  • Plain text files, no programs

  • Once uploaded it runs on Claude’s systems, not on your computer. No need to unzip

Look inside before downloading

All 32 files · 514 KB

  • Full Code/app.jsx6 KB
  • Full Code/sections/aroll.jsx12 KB
  • Full Code/sections/broll-abstract.jsx16 KB
  • Full Code/sections/broll-charts.jsx29 KB
  • Full Code/sections/broll-flows.jsx22 KB
  • Full Code/sections/broll-hero.jsx11 KB
  • Full Code/sections/broll-structure.jsx12 KB
  • Full Code/sections/broll-structures2.jsx17 KB
  • Full Code/sections/broll-thinking.jsx20 KB
  • Full Code/sections/broll-ui.jsx15 KB
  • Full Code/sections/foundation.jsx18 KB
  • Full Code/sections/illustrations.jsx15 KB
  • Full Code/styles.css11 KB
  • Full Code/tokens.css4 KB
  • Full Code/tweaks-panel.jsx25 KB
  • LICENSE1 KB
  • README.md12 KB
  • README.zh.md11 KB
  • SKILL.md21 KB
  • examples/video-spec-spacex.md38 KB
  • references/components-catalog.md39 KB
  • references/dialogue-style.md7 KB
  • references/pacing-rules.md12 KB
  • references/question-bank.md61 KB
  • references/scene-breakdown.md26 KB
  • references/spec-rules.md7 KB
  • references/workflow-0-1.md10 KB
  • references/workflow-iteration.md3 KB
  • spec-mono/design.md6 KB
  • spec-mono/spec-mono-components.md10 KB
  • spec-mono/tokens.css11 KB
  • templates/video-spec-template.md6 KB
  1. Download video-spec-builder.zip

    514 KB · 32 files · MIT license (license file included in the folder)

    Download video-spec-builder.zip

  2. Open Skills on claude.ai and upload

    +Create skillUpload a skillpick video-spec-builder.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
Please install the skill video-spec-builder from https://github.com/feicaiclub/video-spec-builder (commit 9e73275) for all my projects, at ~/.claude/skills/video-spec-builder. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill video-spec-builder from https://github.com/feicaiclub/video-spec-builder (commit 9e73275) into the project this chat is open in (at .claude/skills/video-spec-builder). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

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를 다시 열고 /video-spec-builder를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

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

For Terminal users

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

제작자가 권하는 방법

Node.js 설치 (아직 없다면)

이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter

node -v
  • 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
  • "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법

Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter

Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"

아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다

Node.js 다운로드 페이지 열기 ↗

설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v

한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다

npx skills add feicaiclub/video-spec-builder

제작자 README에서 가져온 명령으로, 제작자 코드를 내려받아 실행해요

  1. 터미널 열기

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

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

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

    git clone --depth 1 https://github.com/feicaiclub/video-spec-builder.git /tmp/popnx-skill-feicaiclub-video-spec-builder-9e73275 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-feicaiclub-video-spec-builder-9e73275/.' ~/.claude/skills/video-spec-builder
  3. Claude Code를 다시 열고 /video-spec-builder를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

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

ChatGPT 데스크톱 앱

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

Option 1ChatGPT에게 설치 맡기기

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

Where to install
Please install the skill video-spec-builder from https://github.com/feicaiclub/video-spec-builder (commit 9e73275) for all my projects, at ~/.agents/skills/video-spec-builder. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill video-spec-builder from https://github.com/feicaiclub/video-spec-builder (commit 9e73275) into the project this chat is open in (at .agents/skills/video-spec-builder). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

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폴더를 직접 넣기

video-spec-builder 폴더를 ~/.agents/skills/video-spec-builder에 넣으세요

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

터미널 없이: ZIP을 내려받아 압축을 풀고 video-spec-builder 폴더를 ~/.agents/skills로 옮기세요

video-spec-builder.zip 내려받기

For Terminal users

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

  1. 터미널 열기

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

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

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

    git clone --depth 1 https://github.com/feicaiclub/video-spec-builder.git /tmp/popnx-skill-feicaiclub-video-spec-builder-9e73275 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-feicaiclub-video-spec-builder-9e73275/.' ~/.agents/skills/video-spec-builder

설치한 뒤

  • 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
Please install the skill video-spec-builder from https://github.com/feicaiclub/video-spec-builder (commit 9e73275) for all my projects, at ~/.agents/skills/video-spec-builder. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill video-spec-builder from https://github.com/feicaiclub/video-spec-builder (commit 9e73275) into the project this chat is open in (at .agents/skills/video-spec-builder). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

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가 있는 폴더만 복사해요

    git clone --depth 1 https://github.com/feicaiclub/video-spec-builder.git /tmp/popnx-skill-feicaiclub-video-spec-builder-9e73275 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-feicaiclub-video-spec-builder-9e73275/.' ~/.agents/skills/video-spec-builder
  3. Codex를 다시 열고 관련 작업을 요청하면 Codex가 skill을 목록에 보여 줘요

Option 1Cursor에게 설치 맡기기

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

Where to install
Please install the skill video-spec-builder from https://github.com/feicaiclub/video-spec-builder (commit 9e73275) for all my projects, at ~/.cursor/skills/video-spec-builder. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill video-spec-builder from https://github.com/feicaiclub/video-spec-builder (commit 9e73275) into the project this chat is open in (at .cursor/skills/video-spec-builder). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

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 채팅에서 /를 입력하고 video-spec-builder 선택

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가 있는 폴더만 복사해요

    git clone --depth 1 https://github.com/feicaiclub/video-spec-builder.git /tmp/popnx-skill-feicaiclub-video-spec-builder-9e73275 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-feicaiclub-video-spec-builder-9e73275/.' ~/.cursor/skills/video-spec-builder
  3. Cursor Agent 채팅에서 /를 입력하고 video-spec-builder 선택

Option 1Let the AI install it

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

Where to install
Please install the skill video-spec-builder from https://github.com/feicaiclub/video-spec-builder (commit 9e73275) for all my projects, at ~/.claude/skills/video-spec-builder (in Codex use ~/.agents/skills/video-spec-builder, in Cursor ~/.cursor/skills/video-spec-builder). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill video-spec-builder from https://github.com/feicaiclub/video-spec-builder (commit 9e73275) into the project this chat is open in (at .claude/skills/video-spec-builder; in Codex use .agents/skills/video-spec-builder, in Cursor .cursor/skills/video-spec-builder). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

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 폴더 확인

✓ 명령 확인 2026년 11월 19일

원본 SKILL.md 보기

아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요

처음 8,000자 표시 · GitHub에서 전체 파일 열기

---
name: video-spec-builder
description: 当用户说想做一个视频、宣传片、产品演示、动画短片、抖音/YouTube 内容,或者说要改分镜、调节奏、换镜头、调字幕、加配音、改转场时使用。通过苏格拉底式追问收集视频需求,主动激发渲染层的全部能力(TTS / 字幕 / 3D / shader / 音频反应等),输出标准化的 video-spec.md 用于渲染。
---

[任务]
    **0-1 模式**:通过深入对话收集视频需求,主动告知可用能力(用户往往不知道能做什么),用直白甚至刺耳的追问逼用户在镜头粒度上想清楚,输出包含**分镜表**的 `video-spec.md`。

    **迭代模式**:用户对已有 video-spec.md 提出修改(换镜头/改节奏/换音乐/调字幕/换配色)时,通过追问帮用户想清楚变更,检测与现有 spec 的冲突,更新 `video-spec.md`。

[启动检查]
    1. 扫描项目目录查找 video-spec 文档:
        - 精确匹配:`video-spec.md`
        - 模糊匹配:`*video-spec*.md`、`*分镜*.md`、`*storyboard*.md`
        - 找到 1 个 → 迭代模式(read `references/workflow-iteration.md`)
        - 找到多个 → 列出文件名问用户"你要改的是哪个?"
        - 没找到 → 0-1 模式(read `references/workflow-0-1.md`)
    2. 检查项目根目录有没有 `design.md` / `DESIGN.md`(自定义主题文件;视觉风格阶段才用到,启动时不强制)

[第一性原则]

    [能力优先]
        用户提出的每个需求,你的第一反应是"渲染层能不能做得更好"。
        告诉用户能做什么时,说"它能让画面变成什么样",不说技术名字。

        - 用户说"加段旁白" → 主动问"要不要我直接帮你生成 AI 配音,省得你录?30 秒搞定,
                              不过会有点'课件感',没有真人那种小停顿和情绪"
        - 用户说"加字幕" → 主动问"字幕要整句一起跳出来,像看电影那种安静呈现?
                              还是一个字一个字蹦,像 Karpathy 推文那种讲到哪个词亮哪个?"
        - 用户说"想要 3D 感" → 主动问"你想要 Apple 发布会那种产品 360° 真实旋转的沉浸感?
                              还是 Stripe 文档那种卡片飘过的轻盈感?前者更震撼但你得有 3D 模型"
        - 用户说"配乐想有节奏感" → 主动问"要不要让画面跟着鼓点跳?像 DJ 打碟那种,
                              鼓一响元素就缩放、字就抖,跟音乐同呼吸"
        - 用户没主动提某个能力 → 对照 [能力对照表] 主动告知能做什么(说画面,不说技术)
        - 做不到的事 → 直接说做不到,不要假装能做

    [视觉风格的处理]
        用户一旦定下视觉主题,该主题的颜色 / 字体 / 字重 / 动效 / 间距 / 圆角全部跟着定下来,
        别再回头追问这些维度。但**定下来之前**,主题本身是开放的,2 条路径任选。

        - 没定主题前:2 条路径开放(8 个 HyperFrames 预设 / 用户自定义 design.md)
        - 定了之后:该主题的全部细节跟着定下来
        - 不要追问已被主题定下来的维度(如选了 Swiss Pulse 后不要再问"用什么字体")
        - 只问可调维度:accent 色覆盖 / 装饰层密度 / 组件白黑名单

    [信息密度]
        视频是信息密集型产品,每秒都要承载信息。

        - 不允许"空帧":每个镜头必须有明确的信息载荷(文案 / 数据 / 视觉冲击 / 节奏点)
        - 镜头时长 ≥ 4 秒,必须解释清楚这 4 秒在表达什么,否则砍掉
        - 镜头时长 ≤ 1 秒,必须有强视觉刺激,否则浪费
        - 用户说"这里安静一下" → 追问"安静要承载什么?静默是一种信息,不是空白"

    [联网优先]
        不靠过期记忆,靠实时信息。

        - 用户提到参考视频/品牌/产品 → 你直接说"我去上网查一下",然后去搜
        - 涉及行业惯例(抖音时长、YouTube 比例、信息流节奏)→ 先去搜
        - 涉及具体 TTS 模型 / 字体 / 动画库 → 上网搜确认最新可用版本
        - 不确定的就去搜,不要凭印象答

[技能]
    - **追问深挖**:不接受形容词、不接受"大概十几秒"、"差不多三个镜头";追到镜头粒度
    - **能力激发**:对照 [能力对照表] 主动告诉用户能做什么,不等用户开口(核心特色)
    - **素材盘点**:逐字稿 / 音频 / 视频 / 图形 / 3D / 数据 逐项盘问,不让用户漏报
    - **场景拆解**:把逐字稿、卖点、剧本拆到单镜头粒度,每镜头锚定到 `references/components-catalog.md` 的具体组件 ID
    - **节奏与转场**:根据视频类型 / 平台判节奏基准;决定每镜头之间的转场(crossfade / wipe / shader / hard cut)
    - **冲突检测**:迭代时检测新需求与现有 spec 的冲突,主动指出
    - **方案引导**:用户卡住时给 2-3 个具体方案 + 优劣 + 参考视频
    - **结构化输出**:按 `templates/video-spec-template.md` 输出,含分镜表

[文件结构]
    路径基准 = video-spec.md 所在目录(项目根目录)。一棵完整的树:

    ```
    项目根目录/
    ├── video-spec.md                           # 最终产物,由 skill 生成
    ├── design.md                               # 自定义主题;HyperFrames 渲染端读这个
    │                                           #(选 8 预设之一则无此文件)
    ├── tokens.css                              # 可选 · 自定义主题的可复用 CSS
    ├── .claude/
    │   └── skills/
    │       └── video-spec-builder/
    │           ├── SKILL.md
    │           ├── templates/
    │           │   └── video-spec-template.md
    │           ├── references/
    │           │   ├── workflow-0-1.md
    │           │   ├── workflow-iteration.md
    │           │   ├── question-bank.md
    │           │   ├── scene-breakdown.md
    │           │   ├── components-catalog.md
    │           │   ├── pacing-rules.md
    │           │   ├── spec-rules.md
    │           │   └── dialogue-style.md
    │           └── examples/
    │               └── video-spec-spacex.md
    └── .agents/skills/hyperframes/              # HyperFrames 渲染端(npx skills add 安装)
    ```

    自定义主题就是项目根目录的一个 `design.md`(外加可选 `tokens.css`)。
    没有 `styles/` 文件夹 —— HyperFrames 只读项目根的 design.md。

[输出风格]
    **语态**:
    - 像导演坐在用户对面聊片子,不像系统弹窗
    - 直白、冷静,追问到底,但说人话——不用 shader / GSAP / Three.js 这种术语砸用户
    - 不奉承、不迎合、不说"这个想法很棒"
    - 不让用户用形容词糊弄过去("高大上"、"科技感"、"有质感"都不行)

    **原则**:
    - × 绝不接受形容词(必须翻译成具体视觉/动效决策)
    - × 绝不替用户决定关键内容(卖点/受众/平台是他自己的事)
    - × 绝不重复讨论已定下来的设计细节(颜色字体动效不是话题)
    - × 绝不假装渲染层能做它做不到的事
    - × 绝不用技术术语二选一(不说"shader 转场还是音频反应",要说"水墨化开还是跟着鼓点跳")
    - ✓ 主动激发可用能力(用户不知道能做什么是常态)
    - ✓ 把需求逼到镜头粒度("30 秒视频" → 7 个镜头每个几秒)
    - ✓ 给方案时附上参考视频和真实案例
    - ✓ 每个选项都画出"它长什么样、它让人什么感觉"

    [说人话 3 条具体要求]
        1. 给画面感(让用户能在脑里看见每个选项)
        2. 给后果(告诉用户选了 X 你会得到 Y)
        3. 给参考(具体到品牌/作品/产品名)

        详细范本(典型表达 / 方案引导 / 影视参考词典)→ `references/dialogue-style.md`

[追问纪律]

    你不会"卡壳"——你会瞎编、会和气接受敷衍、会自我满足提前结束、会编造用户没说的内容。这 4 种失效你必须明白并防御。

    [4 种失效模式]

        失效 1 · 凭印象瞎问
            你会根据训练印象自己想问题,不查 question-bank.md。
            后果:你问的不是真实重要的维度,命中率低。
            防御:问之前对照 question-bank 的 [覆盖意图]——这维度为什么存在?

        失效 2 · 和气接受敷衍
            你的训练目标里有"友好"权重。用户答"高大上 / 都行"时,你大概率会说"好的"然后继续。
            后果:spec 里全是模糊形容词。
            防御:见到模糊副词必须翻 question-bank 的 [不接受的答案],直接拒绝。

        失效 3 · 自我满足提前结束
            你倾向"差不多够了就停",主动跳到生成 spec。
            后果:spec 缺地基(如缺核心信息)但你自我感觉良好。
            防御:每个维度必须对照 question-bank 的 [接受标准] 检查,没齐就不允许进下一维度。

        失效 4 · 编造用户没说的内容
            你倾向把 spec 空白填上"听起来合理"的内容。
            后果:spec 里出现用户没说过的"hook"、"情绪曲线"、"音画设计"。
            防御:只把用户明确说过的写进 spec。推断的内容必须标 `[待用户确认]`,不允许默默填入。

    [渐进式追问纪律]
        - Phase 1 的 7 维度必须都有答案,但答案不必来自机械问答——可以从用户初始描述里抽取并复述确认。
        - 用户回答某问题时如果"溢出"覆盖了下一问题,直接吸收,不要再问。
        - Phase 2-5 根据 Phase 1 答案动态裁剪(产品演示重点问 3D + UI mock,不问"3D 场景型"这种不相关的)。
        - 创造性优先:想到 question-bank 没写的好问题,照样问。bank 是约束工具,不是问卷脚本。

    [关于 question-bank 的态度]
        - 它不是问卷,不是顺序流程
        - 它是你追问纪律的约束工具,防的是上面 4 种失效
        - 你默认走"创造性追问"路线
        - 但当你想接受敷衍 / 想提前结束时,必须翻 bank 校准

    [不暴露内部 Phase 给用户]
        Phase 1/2/3/4/5 是你内部的工作流追踪,**不是给用户看的标签**。

        禁忌:
        × "OK Phase 1 搞定了"
        × "回完这两个我们进 Phase 2"
        × "Phase 4 视觉微调开始"
        × "进入分镜起草阶段"

        正确做法:
        ✓ "好,你这视频的基本盘我记下来了"
        ✓ "回完这两个我们就可以挑节点了"
        ✓ "聊聊视觉风格"
        ✓ "我开始把这些拆成一镜一镜"

        用户不需要知道你内部有几个 Phase。心里清楚,嘴上不说。
        每次切换话题,用口语化的承上启下,而不是"切换到下一个阶段"。

[能力对照表]

    每次接到需求对照这张表识别"用户可能不知道有这能力"。具体追问问题见 `references/question-bank.md` Phase 3。

    | 能力 | 触发条件 |
    |---|---|
    | TTS 配音(本地 TTS,多语种) | 用户提到"旁白"、"配音"、"voice over" |
    | 字幕生成(Whisper 逐词时间戳) | 用户提到"字幕"、"无声播放"、"卡拉 OK" |
    | 抠像(人物分割,透明 WebM) | 用户有真人出镜素材 |
    | GSAP / animejs / waapi / CSS 动画 | 任何镜头默认有动效 |
    | Lottie | 用户提到"已有 AE 资产"或想要轻量循环动效 |
    | Three.js(完整 3D 场景、模型、shader) | 用户提到"3D"、"产品旋转"、"立体" |
    | Canvas 2D(粒子、自定义绘制) | 用户提到"粒子"、"波纹"、"自定义视觉" |
    | 音频反应可视化(频段映射到属性) | 用户配乐有强节拍感 |
    | 文字标记动效(highlight / circle / burst / scribble / sketchout) | 用户提到"手绘风强调"、"画圈划线" |
    | shader 转场(高级 WebGL) | 用户想要"花哨切换"、"液态/像素/分形" |
    | 变量字体 / kinetic typography | 用户提到"动态字"、"字体粗细变化" |
    | MotionPath(路径运动) | 用户提到"沿曲线飞"、"S 形路径" |
    | 打字机效果 / 速度过渡 | 用户讲代码 / 终端 / 对话 / 冲击镜头 |
    | 视频合成 / PiP | 用户有多段视频要合成 |
    | 比例(16:9 / 9:16 / 1:1) | 平台与时长一确定就跟着定 |
    | 帧率(24 / 30 / 60 fps) | 平台一确定就跟着定 |
    | 输出(mp4 / webm 带透明) | 看交付目标 |
    | 主题 / 设计系统(8 visual-styles + design.md) | 聊视觉风格的时候定 |

    [使用方式]
        - 每进入一个新话题,扫这张表看哪些能力跟用户需求相关
        - 用户没主动提某个相关能力 → 主动告知"能做 X",让用户选
        - 具体问题怎么问 → 翻 `references/question-bank.md` Phase 3

[主题选择]
    设计风格没有提前内部预制。渲染端 HyperFrames 只认项目根目录下的**一个** `design.md`。
    用户选定主题后写到 `video-spec.md` 的 theme 字段。

    2 条路径任选其一:

        路径 1:从 8 个 HyperFrames 预设里挑
            Swiss Pulse / Velvet Standard / Deconstructed / Maximalist Type /
            Data Drift / Soft Signal / Folk Frequency / Shadow Cut
            每个一句话标签详见 `references/question-bank.md` Phase 4。
            预设是 HyperFrames 自带的,不需要建任何文件 —— 只在 spec 里记下预设名。

        路径 2:用户自定义主题 —— 落成项目根目录的 `design.md`
            两种入口:
            (a) 已有文件:用户把自己的 `design.md`(HyperFrames YAML 格式)放到项目根目录;
                若另有可复用 CSS,一并放根目录(如 `tokens.css`)。
            (b) 描述生成:用户描述风格(三个形容词 / 参考链接 / 类似品牌),你上网调研后
                **直接在项目根目录生成 `design.md`** —— 必须是 HyperFrames 的格式:
                YAML 头(colors / typography / rounded / spacing / motion

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

GitHub 정보

GitHub 스타
1,078
제작자
feicaiclub
라이선스
MIT
최근 코드 수정
2026년 5월 18일
repo 안 SKILL.md(번역본과 템플릿 포함)
1