Communitygithub.com

shorts-director

指导一部无脸竖屏短视频从创意到成品文件的全流程,并在每次运行中不断改进。支持系列剧、编剧室、制作、音效、后期、对比评测、特效及学习改进等多种模式,可根据用户请求自动触发或手动切换。

shorts-director 是什么?

shorts-director 是一个用于导演无脸竖屏短视频的全链路 AI 技能,覆盖从创意构思到最终文件交付的每个环节。它通过一个类似“编剧室”的流程生成三个前提并由用户判断选择,然后编写剧本、配音、制作动画分镜,再逐拍决定如何呈现:使用 Remotion 代码绘制、从生成图片中剪辑、生成视频片段,或使用已有引擎轨道。该技能支持“系列”模式建立角色/频道圣经,提供编剧室、制作、音效、后期、对比赛道、特效库及每部短片后的学习改进循环。目前已验证的格式包括角色对话短片(配有同步口型)和带数据来源的写实迷你纪录片。用户可通过“make a short”、“next episode”、“make a video about X”等指令触发,但不会响应纯代码绘制的解释性视频(应使用 make-short)或拼贴视频(应使用 make-vox)。关键质量控制体现在多个关键评审节点(前提、配音、动画分镜、花费、粗剪),每次生成前会明确显示成本,确保作品在每个环节都经过严格把控。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gbax316/shorts-director/tree/main/.claude/skills/shorts-director

在你喜欢的 AI 中提问

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

文档

Shorts 导演

一条短视频在两秒内就会被观众审视,而观众对它没有任何义务。这个技能的一切设计,都是为了让你交付的第一版剪辑就是创作者愿意发布的版本:从三个创意中选出的主题,屏幕上既能看清也能听清的文字,画面中没有任何你比创作者更晚发现的瑕疵,以及一条在手机上也能听清的音轨。质量优先。每次花费前都会显示成本,但成本永远不会成为上限。

该技能负责“导演”;仓库中的引擎负责执行。引擎轨道(Remotion 工具包、片段和图片工具、专业库、拼贴相机)以及后来添加的工具(mouth_sync、共享卡片、字幕分段器、检查器)都是该技能在逐拍中抉择的渲染路径,而不是每部视频固定使用一条轨道。

开始之前:读取配置和圣经

风格定位存在于配置中,绝不在技能中。读取仓库根目录下的 director.config.json 以获取品牌标识、角标、影片中可能提及的人物、链接标签、内部规则、供应商及其价格以及最终制作目标。视觉标识(颜色、字体、标志)位于 remotion/src/brand.ts 和 remotion/src/fonts.ts。如果这部短片属于某个系列,在写作之前先阅读 ai-shorts/series/<series>/BIBLE.md 中的圣经;如果是新频道或新阵容,系列模式会先写一本圣经。然后阅读 RUNS.md 和 LESSONS.md 的最后几条记录,因为上次运行的缺陷是本次运行最容易避免的问题。

模式

模式职责阅读文档
series为重复出现的阵容或频道风格编写圣经modes/series.md
writers-room生成三个不同的前提,由用户像买家一样评判,然后编写剧本modes/writers-room.md
produce配音、动画分镜、静态图片、视频片段、口型、合成modes/produce.md
sound背景音乐、音效、混音和母带制作modes/sound.md
finish最终版本、手机版本、文字检查、发布包modes/finish.md
bakeoff在模型之间进行对比测试,以确定默认使用的模型modes/bakeoff.md
effects/effects <name>:预览一个特效,将其放置到一个节拍上,或者构建一个新特效加入库中modes/effects.md
improve每部短片完成后:对运行进行评分,记录经验教训,提出技能改进建议modes/improve.md

一个新短片按顺序运行这些模式:series(仅当圣经缺失时)、writers-room、produce、sound、finish、improve。创作者可以按名称进入任意模式,而明确属于某个模式的请求(如重新配音、修正字幕、新的开头)将直接进入该模式。

快速通道。 当系列圣经存在时,格式已确认且引擎已知,不跳过任何步骤但缩短流程:只需一次前提评估而不是长篇评估,并尽可能重复使用系列中的静态图片。评审节点和检查保持不变;只有轮次减少。

每次运行都必须经过的评审节点

以下是创作者需要关注的关键节点,按顺序排列,在此处修改成本最低,之后修改成本将急剧上升。

  1. 前提。 三个前提,从买家角度编写和评判,并标明选择及理由。在选定一个之前,不进行任何配音。
  2. 配音。 对创作者提供的台词,按其原话录制。对于混杂皮钦语或本地名称的内容,由创作者通过试听选择(references/voice.md)。选定的录音将被精确定位,绝不重新生成。
  3. 动画分镜。 在真实配音时间线上放置静态图片,包括代码绘制的笑点、字幕以及视频片段位置的红色标记。在动画分镜获得批准之前,不生成任何视频片段。
  4. 花费。 每次生成步骤都会先说明其积分或美元成本(references/stills-and-clips.md),并在完成后报告总花费。
  5. 剪辑。 创作者在母带制作前观看粗剪,在最终文件发布前观看完成版。

在评审节点之间,按照 references/qa.md 中的描述自行检查工作,让创作者的精力只用于品味判断,而不用去发现任何可以通过扫描检查捕获的缺陷。

格式

每种格式都有其自己的语法(节拍如何运行)、自己的视觉世界和自己的默认渲染路径。目前已验证的格式各有参考文档:

  • references/formats/skit.md:对话式重复阵容(已通过 Akpos 和 Segs 的第一、二集验证)
  • references/formats/documentary.md:带有数据来源的写实场景加旁白(已通过 Qodeup 迷你纪录片1验证)

引擎格式也仍然可用:通过 make-short 和 vidtsx-2d-generator 的代码绘制讲解视频,通过 make-vox 的拼贴视频。导演可以将整部短片路由到其中一种格式,或从一种格式借用某个节拍。

当请求的格式尚未验证时

如果创作者要求的短片类型不属于任何已有格式(例如列表视频、前后对比视频、物体说话视频、新闻回顾视频),应明确说明,而不是强行塞入最接近的格式;用短剧语法制作新闻回顾视频会产生一种创作者会明显感觉不对劲的效果。提供两条路径。第一条是正确建立:将其作为验证运行,一旦发布,通过 os-skillify 从运行中学习并编写 references/formats/<name>.md,以便下一次从语法而非猜测开始。第二条是仅此一次:使用最接近的格式作为框架制作,并明确指出差距,然后不保存任何内容。如果同一种新格式再次出现,则走第一条路径;一种总是临时凑合的格式永远不会拥有自己的语法,技能会在不知不觉中限制创作者能够请求的内容。

如何不断改进

每部短片都以改进模式结束。它根据 references/outcomes.md 中的结果对运行进行评分,记录到 RUNS.md,将学到的经验写入 LESSONS.md,并且当某个缺陷已出现两次或某项技术已被证明有效时,以 diff 的形式向技能提出修改建议,由创作者批准。Git 是回退的保障。

参考文档

  • references/outcomes.md:技能必须产出的内容及其指标、检查方法以及改进循环
  • references/render-routing.md:逐拍选择代码绘制、图片剪辑、生成片段和引擎轨道
  • references/voice.md:配音、选角、试音、皮钦语和名称处理、固定已选录音
  • references/stills-and-clips.md:生成静态图片和视频片段、保持身份一致的提示、重新生成、价格
  • references/mouths.md:使用 mouth_sync 在生成片段上重绘口型,包括每镜头的设置
  • references/facts.md:屏幕上任何声称事实的内容的事实核查关卡
  • references/effects.md:节拍可执行的任务、对应特效以及避免短片变成技术展示的限制规则
  • references/qa.md:评审节点之间的检查项以及每项检查曾捕获的问题
  • references/formats/:每种已验证格式的参考文件

相关技能

  • make-short、vidtsx-2d-generator:代码绘制讲解视频轨道及其崩溃规则,用作渲染路径
  • make-vox:拼贴视频轨道
  • make-ai-short:生成式视频轨道,本技能继承其片段纪律
  • suggest-sfx:音效试听,从音效模式调用
  • os-writing(Personal OS):发布用的钩子和字幕,从后期模式调用
  • os-skillify(Personal OS):在验证运行后编写新格式参考

Individual skills in this repo

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

gbax316/make-ai-short

Build a GENERATIVE-pixels vertical short (1080×1920, ~35-40s) end-to-end — a recurring locked character animated by a fal video model (Seedance 1.5 Pro default) under a philosophical/story VO, composited in Remotion with word-synced captions, SFX audition, seamless frame-0==last-frame loop. Use when the user wants to "make an AI video short", "make an ai short", "make a blue-man video", or any short where the pixels come from a VIDEO MODEL — not TSX animation (that is make-short) and not layered collage (that is make-vox). Defers model choice re-litigating to ai-shorts/IDEAS.md, TSX crash rules to vidtsx-2d-generator, SFX taste to suggest-sfx + brand §7. For a NEW short (writers' room, dialogue skits, documentaries, mixed render paths), start with shorts-director, which calls this track as an engine.

gbax316/vidtsx-2d-generator

Generate production-ready 2D TSX video files for VidTSX (Remotion-based) from a shot, scene, or video description. Use whenever the user wants to create or generate a VidTSX video, a 2D TSX shot or scene, an animated clip, title card, or rendered motion graphic — including when they describe a visual animation they want built, or say "make a shot", "build this scene", "generate the TSX", or "turn this into a video". Covers the mandatory file structure and composition config, dimension presets (horizontal/vertical/square), six style presets (minimalist, memphis, neo-brutalism, glassmorphism, neon, corporate), and the hard rules that keep renders from crashing, covering frame-based animation only (no useState/useEffect/setTimeout), strictly monotonic interpolate ranges, Easing.bezier not wrapper syntax, and the chroma-js and @remotion/paths import gotchas. Not for 3D/three.js compositions, general React work, or editing video files.

相关技能