Communitygithub.com

Akira-TL/akira-video-skills

AI 视频制作项目的入口与路由中心。读取或建立 VIDEO.md,根据当前脚本、素材、镜头、生成结果及后期状态,将任务派发至专业视频 Skill,避免将所有制作规则塞入一个总提示词。

akira-video-skills とは?

Akira Video 是 Akira Video Skills 的主要路由 Skill,专注于 AI 视频制作项目的入口与流程管理。它不直接处理具体的视频制作细节(如脚本撰写、镜头设计、生成提示等),而是通过读取或创建项目根目录的 `VIDEO.md` 文件,快速了解当前项目的目标、进度、可用素材和阻塞项,然后将具体制作任务路由到专门的子 Skill(如 `video-script`、`video-shot`、`video-generation` 等)。该 Skill 支持在 Claude Code、Cursor 等支持 Agent 路由的 AI 开发工具中使用。其核心价值在于:通过一个轻量的中心控制点,维护项目的整体状态和优先级,避免将庞大的制作规则和专业知识全部塞入一个提示词,从而提高复杂视频项目的执行效率和可维护性。它强调项目信息的简洁记录和按需路由,确保每个子任务都能由最专业的 Skill 负责。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Akira-TL/akira-video-skills/tree/HEAD/skills/video/akira-video

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Akira Video

akira-video 是 Akira Video Skills 的主要路由 Skill。它负责视频制作入口、VIDEO.md 的维护、当前制作任务的判断、专业 Skill 路由以及停止边界的定义;具体的视频脚本、复用素材、镜头、生成包、审片和整片后期方法由对应的专业 Skill 负责。完整项目的依赖与人机交接遵循 references/workflow/PRODUCTION-FLOW.md;对于已有项目,直接从当前实际工作继续,不机械地重跑上游步骤。

整个制作过程始终优先保护以下约束(优先级从高到低):用户与来源事实 → 剧情/镜头意图(适用时)→ 人物/物体身份与结构 → 产品事实(广告时)→ 空间与时间连续性 → 画面美感 → 炫技。具体的层级、冲突回查以及“采用结果实际出口”等例外情况按 references/workflow/AUTHORITY.md 处理;后面的目标不能以破坏前面的约束为代价。

1. 进入或接管项目

首先读取项目根目录的 VIDEO.md。如果文件不存在,则按 references/project/PROJECT-LAYOUT.md 建立最小视频项目;项目定义与当前状态按 references/project/VIDEO-HOME.md,命名按 references/project/NAMING.md。只创建当前真实需要的目录和文件,不预先生成空分类;第一次需要生成一次性生成包时,再确保目标项目的 .gitignore 忽略 .tmp/ 目录。

如果用户已经提供了现成的图片、视频、音频、粗剪或参考成片,先按 references/project/IMPORT-MEDIA.md 判断它在当前项目中的真实用途;可直接复用的成果不强制重走设计或生成流程。

然后,根据当前任务读取最小必要内容:

  • 视频脚本与镜头总览:video/script/;
  • 跨镜头复用内容:video/materials/;
  • 当前镜头:video/shots/<shot-id>/;
  • 已进入整片后期时:video/edit/;
  • 上游小说、章节、品牌资料或其他来源:沿当前项目的真实 pointer 读取,不复制成第二份上游事实源。

完成标准:能够说明当前视频目标、交付要求、正在推进的制作内容、已有的可复用素材、当前镜头/后期状态以及真实的阻塞项。

在进入下一项昂贵制作之前,按 references/workflow/PRODUCTION-GATES.md 只运行当前项目适用的轻量门禁;门禁不产生额外的项目状态文件。如果当前项目已经大到平铺影响阅读,或者确实需要同时比较创意版本,再读取 references/project/SCALING-VERSIONS.md,不要预设长片目录。需要清理失败结果、一次性生成包、缓存或旧媒体时,按 references/project/MEDIA-LIFECYCLE.md 先确认该文件不是唯一的输入、当前采用的结果,或者后期工程的唯一依赖。

重要的制作决定如何落盘、VIDEO.md 何时更新、镜头采用结果为何只写入 SHOT.md,参见 references/project/RECORDING.md;聊天历史和一次性生成包都不是长期的项目记录。

2. 维护 VIDEO.md

VIDEO.md 是供人和下一位 Agent 直接阅读的视频制作首页,只保存当前仍有用的信息。固定关注以下内容:

  • 项目与视频目标;
  • 交付要求;
  • 当前制作进度;
  • 当前正在推进的工作;
  • 阻塞项;
  • 仍然影响后续的关键决定;
  • 指向视频脚本、复用素材、镜头和整片后期的导航。

普通的提示词历史、所有的生成结果、生成日志以及已经被 Git 历史取代的旧决定,不进入 VIDEO.md。

详细写法见 references/project/VIDEO-HOME.md。

3. 路由专业工作

根据用户的当前目标和已有的项目内容,选择下一项实际制作工作。完整的项目不要求机械地经过所有能力;已经有脚本时可以直接进入镜头,已经有镜头与素材时可以直接准备生成包,返回生成结果后直接进入审片。

根据当前任务加载对应的 Skill:

  • 从小说、章节、brief 或其他上游内容形成/修订视频脚本、人物表演、场景或镜头总览 → 使用 video-script;
  • 角色或场景只有功能描述,尚未形成具体的外形/服装/材质/空间/光线设计 → 使用 video-design;
  • 角色需要跨镜头稳定的音色、声音参考,或者项目需要规划对白声音、环境声、音效与整片声音边界 → 使用 video-audio;
  • 规划或维护跨镜头复用的人物、场景、道具、产品提示词与参考素材 → 使用 video-materials;
  • 将镜头总览展开成 SHOT.md,处理动作、摄影、声音与相邻镜头的连续性 → 使用 video-shot;
  • 编写当前生成的提示词、选择最小参考集、整理一次性生成包、导回用户生成结果 → 使用 video-generation;
  • 用户带回图片或生成结果后判断是否采用、调整后续、后期修复、重生成或重写 → 使用 video-review;
  • 多个采用镜头进入 Premiere Pro、After Effects、DaVinci Resolve 等整片后期 → 使用 video-editing;
  • 同一视频需要多语言字幕、旁白、配音或正式成片版本 → 先读取 references/workflow/LOCALIZATION.md,翻译内容交给 video-script,声音交给 video-audio,字幕/图文/最终导出交给 video-editing,不复制整套项目;
  • 品牌、产品植入或广告需要核验产品功能、结构、官方素材与广告表达边界 → 按需加载可选 Skill video-advertising;若当前 Target 未安装,则使用明确的协调标识 akira-tl/akira-video-skills/video-advertising,交给 akira Router / Skiloom 生成候选计划(Candidate plan)并在授权后安装。

Router 只保存上述职责摘要;进入任一分支后,以实际加载的权威 Skill 为该专业方法的唯一权威来源。

若目标需要视频模型的专用适配,先读取 references/workflow/MODEL-ADAPTERS.md 选择当前仓库已有的最小适配 Package;若尚未安装,则将明确的协调标识交给 akira Router / Skiloom 正常生成候选计划(Candidate plan)并安装。不要将模型参数或供应商细节硬编码进 akira-video。图片生图目前使用 video-design + video-materials 的通用规则,不单独维护图片模型适配器。

若外部生成任务已交给用户,需要跨会话等待时,按 references/workflow/WAITING-RESUME.md 在 VIDEO.md 中只记录生成包路径、预期返回、下一步和真实的阻塞项;下一轮优先恢复现有的包/返回结果,不因换会话而重复打包。

4. 外部生成的人机边界

默认允许用户在外部图片/视频模型中完成实际生成。当需要外部生成时,专业生成 Skill 从正式项目内容中整理出一个一次性生成包:

正式项目内容 → .tmp/ 一次性生成包 → 用户外部生成 → 结果返回 → 归档正式目录 → 删除临时包。

一次性生成包是派生产物,不作为长期项目的事实源;长期提示词保留在对应的归属素材或镜头目录中,临时包只复制当前生成真正需要的内容。

5. 重新路由与停止边界

每次专业 Skill 完成一个有明确边界的动作后:

  1. 将返回的正式素材、生成结果、镜头决定或整片工程归档到对应的归属目录;
  2. 更新仍然影响当前制作的 VIDEO.md;
  3. 根据用户目标和当前产物决定下一项制作工作。

只有在以下情况下停止:用户限定的范围已完成、下一步必须等待用户的外部生成或提供素材、存在真实的阻塞项,或者当前交付已经完成。等待用户外部生成时,明确给出一次性生成包和返回的命名要求,不要继续假装已经产生了素材。

Individual skills in this repo

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

Akira-TL/akira-video-skills

为 Runway 当前视频模型编译和检查生成提示词;当 video-generation 需要使用 Runway(当前主线 Gen-4.5)的 Text to Video 或 Image to Video,并需要 Runway 专用动作、摄影和时序表达时使用。

Akira-TL/akira-video-skills

为 ByteDance / BytePlus Seedance 当前视频模型编译和检查提示词;当 video-generation 需要使用 Seedance 2.5 的参考素材、时间线、同步声音、视频编辑、延长或多镜头能力时使用。

Akira-TL/akira-video-skills

为 Google Veo 视频生成编译和检查提示词;当 video-generation 需要使用 Veo 的 Text to Video、Image to Video、首尾帧、参考元素或同步声音能力时使用,并先核验具体 Google 使用入口与 model 的当前支持范围。

Akira-TL/akira-video-skills

为品牌短片、产品植入剧情、广告或比赛作品建立产品事实与广告边界;当视频需要准确表达某个具体产品的官方功能、参数、结构、使用方式、品牌素材或产品与剧情关系时使用。

Akira-TL/akira-video-skills

设计并维护 AI 视频中跨镜头复用的角色声音、音色参考、对白声音要求与整片声音关系;当同一角色需要跨镜头保持声音一致,或需要规划语音参考、环境声、音效、音乐与画面的职责边界时使用。

Akira-TL/akira-video-skills

设计 AI 视频中的角色与场景视觉方案;当脚本只说明“需要一个什么样的人/场景”,但还没有形成可稳定生成的外形、服装、材质、色彩、空间、光线和视觉识别系统时使用。

Akira-TL/akira-video-skills

组织整片级剪辑、合成、全片声音和最终成片;当多个已采用镜头需要进入 Premiere Pro、After Effects、DaVinci Resolve 等后期工程,或需要整片字幕、Logo、音乐、混音、比例版本和最终导出时使用。

Akira-TL/akira-video-skills

为 AI 图片或视频生成准备可直接使用的提示词与一次性生成包,并在用户把生成结果带回项目后归档;当需要从正式视频脚本、复用素材和 SHOT.md 编译生成内容、选择参考素材、约定返回文件名或清理临时包时使用。

Akira-TL/akira-video-skills

规划、创建、整理和维护多个镜头会重复使用的视频复用素材;当需要人物/场景/道具/产品提示词、参考图、官方素材、身份与状态参考或其他可重复引用内容时使用。

Akira-TL/akira-video-skills

审核 AI 生成的人物/场景等复用素材或镜头生成结果,判断采用、修改提示词、重生成还是留给后期修复;当生成结果返回项目、需要检查身份/结构/连续性/动作/摄影/产品真实性或选择生成结果时使用。

Akira-TL/akira-video-skills

把小说、章节、故事梗概、品牌 brief 或其他上游内容转换成当前视频自己的脚本层;当需要编写或修订 SCRIPT.md、视频人物表演定义、场景定义、对白或镜头总表时使用。

Akira-TL/akira-video-skills

把 SHOTS.md 中的镜头总览展开成可直接制作的单镜头定义;当需要创建或修改 video/shots/<shot-id>/SHOT.md、镜头连续性、摄影、动作、表演、声音或镜头专属生产约束时使用。

関連スキル