REA
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
video-spec-builder —— 把我想做个视频逼成一份精确到秒的分镜脚本 video-spec.md,交给 HyperFrames 渲染。一条命令装到 Claude Code / Cursor / Codex:npx skills add feicaiclub/video-spec-builder
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/skills/feicaiclub-video-spec-builder)在同一工作中把 AI 连到服务的 MCP
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
MCP server for terminal commands, file operations, and process management
同类工作,排序与 Skill 列表相同
| 本项 video-spec-builder | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| 作者 | feicaiclub | morluto | multica-ai | Graphify-Labs | harry0703 |
| Skill 数 | 1 | 1 | 1 | 1 | 1 |
| GitHub 星标 | 1,078 | 468,733 | 234,332 | 150,287 | 144,566 |
| 最近代码更新 | 2026年5月18日 | 2026年11月19日 | 2026年4月20日 | 2026年11月18日 | 2026年11月18日 |
| 许可证 | MIT | MIT | – | Apache-2.0 | MIT |
feicaiclub 提供的 1 个 Skill(指令集),AI 读取后照做 · 不是 MCP server
MCP = 手
把 AI 连到外部服务或数据,例如读取 Notion 或开发票。需要有程序或服务器在运行。
Skill = 手册
教 AI 怎么做某项工作的文本文件,不连接任何服务。
有些会重叠:少数 Skill 带有调用工具的脚本,少数 MCP 只提供知识。请从你想完成的工作出发。
Claude CodeCodexCursor
依据开发者 README 和 repo 中的文件夹
GitHub account feicaiclub (person), 2 years old
★ 1,078 stars · code last changed 2026年5月18日
No, plain text files the AI reads and follows
No scripts, so it does not go online by itself
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?
选择你用的应用,本页只显示该应用的安装方法
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
All 32 files · 514 KB
Full Code/app.jsx6 KBFull Code/sections/aroll.jsx12 KBFull Code/sections/broll-abstract.jsx16 KBFull Code/sections/broll-charts.jsx29 KBFull Code/sections/broll-flows.jsx22 KBFull Code/sections/broll-hero.jsx11 KBFull Code/sections/broll-structure.jsx12 KBFull Code/sections/broll-structures2.jsx17 KBFull Code/sections/broll-thinking.jsx20 KBFull Code/sections/broll-ui.jsx15 KBFull Code/sections/foundation.jsx18 KBFull Code/sections/illustrations.jsx15 KBFull Code/styles.css11 KBFull Code/tokens.css4 KBFull Code/tweaks-panel.jsx25 KBLICENSE1 KBREADME.md12 KBREADME.zh.md11 KBSKILL.md21 KBexamples/video-spec-spacex.md38 KBreferences/components-catalog.md39 KBreferences/dialogue-style.md7 KBreferences/pacing-rules.md12 KBreferences/question-bank.md61 KBreferences/scene-breakdown.md26 KBreferences/spec-rules.md7 KBreferences/workflow-0-1.md10 KBreferences/workflow-iteration.md3 KBspec-mono/design.md6 KBspec-mono/spec-mono-components.md10 KBspec-mono/tokens.css11 KBtemplates/video-spec-template.md6 KB+Create skillUpload a skillpick video-spec-builder.zip
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
复制这句话,粘贴到 Claude Code 的对话中
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
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
node -vMac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令
装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v
安装一次,所有需要 Node.js 的工具都能用
npx skills add feicaiclub/video-spec-builder摘自开发者 README,会下载并运行开发者的代码
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
这条命令把 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-builderChatGPT 桌面应用内置 Codex,Codex 从 ~/.agents/skills 文件夹读取 Skill
在 ChatGPT 桌面应用中打开 Codex,把这句话粘贴到对话中
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
把 video-spec-builder 文件夹放到 ~/.agents/skills/video-spec-builder
~ 是你的主文件夹($HOME)
不用终端:下载 ZIP,解压后把 video-spec-builder 文件夹移到 ~/.agents/skills
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
这条命令把 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-builderChecked against official docs 2026年11月15日 · Source: learn.chatgpt.com
不能使用你自己安装的 Skill,只能使用目录中插件自带的 Skill
想在 ChatGPT 中使用这个 Skill,请按上面的方法使用 ChatGPT 桌面应用
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
复制这句话,粘贴到 Codex 的对话中 · 适用于 ChatGPT 桌面应用中的 Codex、Codex CLI 和 IDE 扩展
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
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
这条命令把 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复制这句话,粘贴到 Cursor 的对话中
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
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
这条命令把 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适用于其他能读取 Skill 的应用。这句话列出了 Claude Code、Codex 和 Cursor 的路径,AI 会按你的应用选择 · Copy this sentence into the app’s chat
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
其他支持 Agent Skills 的应用(如 Gemini CLI、GitHub Copilot)使用不同文件夹,请查看该应用的指南,再把含 SKILL.md 的文件夹复制过去。
已于 2026年11月11日 对照 Claude Code、Codex 和 Cursor 官方指南核实 skill 文件夹
✓ 命令已检查 2026年11月19日
以下文字来自开发者的 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提问、分享技巧或报告无法使用。按“有帮助”数量排序。