Communitygithub.com

thativanng/reels-maker

视频制作前的结构化需求访谈:读取已有资料,通过多轮提问明确格式、内容与风格,最终生成一份包含“你说”与“我假设”的简报与故事板,待用户确认后才开始构建。

reels-maker 是什么?

该技能是一个为AI视频生成工具设计的结构化需求访谈系统。它模拟专业视频制作前的制片人访谈流程,通过最多五轮提问(目的、格式、素材与故事、视觉风格与审查、冲突检查)来避免常见的昂贵错误(如平台比例错误、视觉效果不被认可等)。技能支持多种视频类型(短视频、长视频、讲解视频、动画等)和平台(Reels、TikTok、YouTube、LinkedIn等)。核心规则是:不猜测、不构建——所有未由用户明确回答的字段都标注为“我假设”,只有在用户对完整简报和故事板说“是”之后,才交由后续的 reel-style(视觉风格选择)和 film-engine(实际构建)执行。技能附带了完整的参考文档(rounds.md、platforms.md、journey.md、brief.md),并严格遵循“先查资料再提问”、“每个问题都带推荐答案”、“所有数字必须可溯源”等原则,有效降低了AI视频生成中的返工率。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thativanng/reels-maker/tree/HEAD/skills/reel-intake

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

reel-intake:先问,再建

套件存放位置: 此技能中的所有命令均需在 reels-maker 文件夹(由 github.com/thativanng/reels-maker 克隆而来,其中包含 template/ 和 tools/ 子目录)中运行。如果项目中没有此文件夹,请先按照该仓库的 SETUP.md 进行设置。

规则: 在用户对简报及其故事板说“是”之前,不构建任何内容(没有外观,没有画面)。代码生成的视频中,代价高昂的错误很少是时间问题;它们往往是那些无人问津的答案。真正的意图往往在脚本写完之后才浮现。画幅比例最终与平台不匹配。视觉效果在用户眼中显得廉价。每一次这样的错误都意味着重构;而一个提问的成本仅仅是一行文字。

0 · 先看,再问

先通读所有已有资料,绝不提问那些可以查到的信息:

  • 请求本身,任何源文本、链接、简历、他们的网站或个人资料
  • 品牌文件(颜色、字体、Logo)
  • .reels/looks-log.md(如果存在,即 reel-style 对过往视觉效果的记录)

资料中已包含的字段应直接填入,并标注“来自您的简历”、“来自您的网站”等。猜测不是答案: 猜测应放入简报的“我假设”部分,用户可以看到并更正。

1 · 如何提问

  • 以轮次提问,而非表单或零散提问。 一轮 = 下面一个完整的区块,在一条消息中发送。为每个问题编号。使用 ★ 标记推荐答案,并给出单行理由。
  • 事实性问题给出选项(平台、时长、声音)。创意性字段给出一个草拟的建议供其修改, 而非空白:“观众应记住的一件事:★ ‘预测是一种猜测;安全库存能覆盖意外。’ 保留、修改或替换?”
  • 依赖前一个答案的问题 应基于该答案预填充(如画幅比例随平台而定),或等待下一轮。
  • 用户可输入的快捷指令: defaults 接受本轮所有 ★ 选项。just build it 结束访谈:每个未填字段都将成为简报中的明确决策,并附上理由。
  • 正常四轮,最多五轮。 一旦所有必填字段均已回答或采用默认值,立即停止。

2 · 轮次(完整题库、选项及默认值见 references/rounds.md)

第一轮 · 目的(必填)

  1. 关于什么内容?(仅当未提供源材料时)
  2. 观众应记住的一件事(为他们草拟;对于模糊的请求,提供 2–3 个草稿)
  3. 唯一的观众是谁?(招聘者、客户、同行、圈外陌生人)
  4. 该观众看完后应做什么?(关注 · 评论 · 点击链接 · 保存或转发 · 只是记住)

第二轮 · 格式(必填,六项按此顺序;事实及安全区域详见 references/platforms.md)

  1. 首发平台是哪里?首发平台为主版本;其余平台为剪辑版。
  2. Reel 还是视频?仅在该平台同时支持两者时询问(LinkedIn、X、YouTube、Facebook)。
  3. 画幅比例,按平台默认值:Reels、TikTok 和 Shorts → 9:16;LinkedIn → 4:5;YouTube → 16:9。
  4. 布局:★ 让 reel-style 展示三种,或者如果他们已有想法则直接指定(该布局将绑定所有三种视觉效果)。声明安全区域;不要就安全区域提问。在自然流量下的 Reels、TikTok 和 Shorts 中,文字应位于中间带(工作室惯例,非平台硬性规定):应用会遮挡底部四分之一及右侧按钮区域。付费或推广的 Reel 则需要保持底部 35% 空白(Meta 的广告指南);使用 -ads 平台键。
  5. 时长:硬上限,还是随内容而定?在旁边显示平台的官方限制。
  6. 声音:静音可看且有声更佳(★ 默认)· 以声音为主导 · 仅静音也可。然后是旁白、音乐和字幕样式。

第三轮 · 素材与故事(按需提问)

  • 已有素材:截图、录音、照片、本人影像、Logo、数据,或没有。缺失的素材将变为带标签的占位符,绝不用虚假内容代替。
  • 每个数字:是实测值、目标值还是示意值,以及其来源。绝不凭空编造。
  • 谁来写屏幕上出现的文字?(★ 我起草,您修改定稿 · 完全按您的文字)使用哪种语言,英式还是美式拼写?
  • 一次性的还是系列片?(系列片会在各集之间锁定一种视觉效果;由 reel-style 处理)
  • 如果是旅程或职业故事,需增加旅程区块(references/journey.md):每一个角色及每一个职位,命名/描述/隐藏每个雇主,以及同行认为牵强的说法。

第四轮 · 视觉风格、护栏与审查(必填)

  1. 1–3 个他们喜欢的视频,以及他们认为廉价的视觉效果。 这是最不能跳过的问题。
  2. 品牌色和字体(先查找;仅当未找到时才询问)。
  3. 绝对不能出现的内容(数字、姓名、面孔、Logo),以及必须出现的内容(账号、结尾卡片、免责声明)。
  4. 封面图,即人们按下播放前看到的预览图(个人资料网格、LinkedIn 缩略图):★ 钩子句,大号字体,置于开场画面之上。没有封面图,平台就会替你选一帧(据说 LinkedIn 会选第一帧;未经证实),这通常不是最佳选择。
  5. 他们希望如何审阅:★ 静帧 → 10秒片段 → 独立检查后的完整成片 → 手机预览。

3 · 收尾

  1. 冲突检查。 在编写简报之前,通读所有答案并相互比对:
    • LinkedIn 使用 9:16 → 建议改为 4:5
    • 以声音为主导发布到 LinkedIn → 必须嵌入字幕
    • 在 9:16 的 Reel 中间带中放入过长脚本(底部四分之一需保持空白;付费版为 35%)→ 删减文字,而非缩小字号
    • 在 Instagram 上发布超过 3 分钟 → 不会推荐给新观众
  2. 一屏简报(模板见 references/brief.md),保存为 reels/<简短名称>/brief.md:每个 Reel 有自己的文件夹。分为您说和我假设(及原因) 两部分。包含格式行:平台 → Reel 或视频 → 画幅比例和尺寸 → 布局及安全区域 → 时长 → 声音。
  3. 故事板表格: 时间 · 屏幕上出现的文字(精确无误) · 声音和字幕 · 此节拍的理由。钩子必须在 3 秒内出现,且每个节拍的时长之和等于总时长。
  4. 请求“确认”。 有修改则重新完整通读。绝不在同一条消息中既发送简报又开始构建。

然后交接:reel-style 选定视觉效果(3 张静帧),film-engine 按照简报的格式尺寸,在该视觉效果下进行构建。

禁止事项

  • 询问资料中已有答案的问题。
  • 编造数字、引用语、客户或结果。
  • 用自己的话替换用户的原话。可以校对(语法、流畅度),但不得重写。
  • 跳过格式轮次,即使平台看起来显而易见。
  • 在访谈阶段选定视觉效果。那是 reel-style 的工作,以静帧形式展示,而非从列表中选择名称。

致谢

访谈姿态(Agent 先问后行动,且每个问题附带推荐答案)借鉴自 Matt Pocock 的 grill-me(mattpocock/skills,MIT 许可)。先问再答规则(优先推荐选项、跳过已回答项、区分“你说”与“我假设”、总结前进行冲突检查)改编自 HyperFrames 的意图访谈(heygen-com/hyperframes,Apache-2.0)。简报字段遵循通用代理机构视频简报格式。平台事实信息于 2026-10-06 依据各平台自身可读页面进行核查;无法核查的平台(如 X)已在 references/platforms.md 中标注为未经证实。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

thativanng/reels-maker

The gates every code-rendered film passes before anyone sees it. A 40 fps collision pass (no mover touches a solid or another mover), pixel probes (nothing sits over or behind a face, a head, a subtitle or the frame edge), then an independent auditor (a fresh agent) who reads frame sheets at ≥2 fps and signs off. The builder never signs off their own film. Use it before sending ANY render, after every fix round, and whenever someone says "check the film", "audit this", "is it ready", or "why does this frame look wrong".

thativanng/reels-maker

Build and render a film, reel or animation as code. One HTML page draws any frame on demand with window.seek(t), and a headless browser renders every frame at 2x into an MP4 with sound. Use it whenever someone wants a video made with code rather than a video generator, says "make a film / reel / animated explainer / career video", "render this to MP4", "turn this page into a video", or needs the finishing steps (audio cues, loudness, colour-safe encode, phone preview). It is style-agnostic and renders 9:16, 4:5, 1:1 or 16:9. It runs after reel-intake (the brief) and reel-style (the look), builds on template/starter.html or a style pack such as voxel-walk, and passes film-audit before anything is shown to anyone.

thativanng/reels-maker

Picks the look of a reel or film before it is built. It shows three genuinely different looks as stills of the same opening frame with the same words, so the person judges the look and not the content. It keeps a log of every look ever shown, so no look comes back unless asked for, and it locks one look on purpose for a series. Use it after reel-intake's brief is signed and before any test strip, whenever someone says "what should it look like", "give me options", "make it look different from last time", "it looks cheap", or starts a new reel or a new series.

thativanng/reels-maker

The voxel career-film style. A blocky 3D version of the person walks, without ever vanishing, through one scene per role. Their outfit changes as they walk, each scene rises out of the floor ahead of them, and a dark banner tracks year, company and role. Use it when someone wants their career, a journey or a "how I got here" told as a short 3D film for LinkedIn or a portfolio, says "make my career film", "turn my CV into a video", "voxel film", or wants a new chapter added to an existing one. It runs on film-engine (render, audio, finish) and must pass film-audit before anything is sent.

相关技能