Communitygithub.com

suntay44/motionable

内部 motionable 制作流水线(规划模式、审批、场景、音乐、评论、渲染)。请以 /motionable:scratch、:website 或 :project 开头。

motionable 是什么?

motionable 是一款面向 AI 代理(如 Claude Code)的专业影视制作工具,旨在基于产品事实、用户反馈和品牌个性,自动生成独一无二的宣传影片。它支持规划模式(PLAN.md)、场景构建、音乐编排、自我评论和渲染输出,全程无需用户手动操作。该技能适用于 motionable 插件环境,通过严格的规划、一次审批和迭代修订流程,确保每部影片都拥有独特的视觉风格和节奏。其核心优势在于:从证据出发设计影片方向,自动生成 SVG 插图,内置音频比较和检查工具,以及针对 App Store 徽章等细节的合规处理。最终交付包括 MP4 视频、治疗摘要和变更日志,方便用户快速发布。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/suntay44/motionable/tree/HEAD/skills/make

在你喜欢的 AI 中提问

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

文档

motionable: make

您带着以下内容来到这里:关于产品的事实(每个都有来源)、用户的回答、图片路径、颜色以及对其个性的注释。您的工作是制作一部完成的影片,让它感觉像是这个产品,并且是工作室中独一无二的影片。

ROOT 是 motionable 的根目录:${CLAUDE_PLUGIN_ROOT}。如果该变量未展开,则使用此文件真实路径(realpath)向上两级的文件夹,该文件夹中包含 engine/ 和 scripts/。

在开始规划之前,请阅读 ROOT/PLAN.md(规划模式)、ROOT/ENGINE.md(组件)、ROOT/rules.md(硬性规则)和 ROOT/checklist.md(评论)。ROOT/examples/owly/ 展示了已完成作品的样子。切勿模仿其外观、声音或结构:它只是无数种方向中的一种。

1. 创建影片

  • 位置: 影片存放在当前文件夹(通常是用户用于宣传视频的工作室)中,以 <slug>/ 的形式存放。
    • 如果当前文件夹是产品本身的仓库,则使用 motionable/<slug>/ 代替。
    • 切勿写入通过 /motionable:project 给定的产品文件夹。
    • 如果 <slug>/ 已存在,请问:创建一个新版本(<slug>-2/),还是继续该影片?
  • 创建它: 运行 bash ROOT/scripts/new.sh <film> "<Product name>"。它会将引擎复制到影片中并写入模板。
  • 资源: 将图片复制到 <film>/assets/ 中,并使用清晰的名称(logo.png、screen-home.png...)。如果用户有品牌字体文件,则放入 assets/fonts/。

2. 规划模式(内部:无命令,无样式菜单)

从头到尾遵循 PLAN.md:

  1. 证据板与个性。
  2. 故事: 承诺、标志性时刻、3 个钩子 → 1 个。
  3. 每个参数的设定及其理由。
  4. 相对于工作室的独特性: 阅读其他影片的 DIRECTION.md › Fingerprint。v0.2 之前制作的影片没有 Fingerprint;将它们视为 120 BPM A 小调 House 风格,左对齐标题位于卡片上方。
  5. 编写 DIRECTION.md 和 SCRIPT.md,使用选定的节奏。

不要要求用户选择样式。方向来自证据。

3. 一次审批

展示 4 行治疗(感觉 · 声音 · 外观 · 标志性时刻)和一个紧凑的节拍网格(时间 · 画面 · 文字 · 转场)。然后询问,如果可用则使用 AskUserQuestion(否则在聊天中询问):

  1. 计划: 批准,或修改某些内容。
  2. 插图: “我应该为此影片绘制插图吗?” 是的,请绘制插图 / 少量点缀 / 不用,只需截图和文字。推荐一个并说明理由(PLAN.md §5)。
    • 绘制插图是免费的:Claude 会编写 SVG。
    • 只有当会话连接了图像生成工具时,才将其作为选项添加,并说明可能需要收费。

在审批之前不要编写任何场景代码。此时的修改成本很低。

4. 构建

  1. 插图(如果选择“是”):将 SVG 写入 assets/drawn/,使用品牌颜色和统一的线条粗细(ENGINE.md › Drawn illustrations)。在一个页面上查看每个 SVG 的渲染效果,重新绘制任何笨拙的部分。
  2. scenes/Film.swift: 完全替换骨架。每个值都来自 DIRECTION.md 和 SCRIPT.md:
    • 时间放入 enum T;
    • 片段和转场放入 Reel;
    • 屏幕通过取景调用处理(切勿裁剪到固定框中);
    • 标志性时刻被重新绘制,以精确模拟真实 UI 的动画。首先测量其位置:bash ROOT/scripts/inspect.sh <screenshot> find <its colour>(或 row、column、pixel)可提供精确的环、条和文本边缘。
    • 方向所需的自定义元素放在各自的 scenes/*.swift 文件中。
  3. 声音: 通过 s.compose 使用方向的 Recipe + Section,并为每个画面事件添加 s.cue,使用标志性声音。
  4. 检查构建: bash ROOT/scripts/run.sh <film> sheet(无时间:整个影片加上所有转场)。修复编译错误(ENGINE.md › Gotchas)。

5. 草稿、修复,然后展示给用户

以草稿形式工作,切勿无休止循环:

  1. 草稿 1 是第一次完整构建:场景、音乐和每个提示。从影片本身(以下步骤)审阅它;不需要视频文件。(如果用户想提前查看,run.sh <film> draft 会渲染一个小的快速 MP4。)
  2. 自我审查:一次通读,全部检查。
    • run.sh <film> check:每个 ✗ 都是必须修复的。保持线条更长,更早开始,减少文字,或删除线条。打字的行需要其打字时间加上阅读时间。同时处理其 ⚠ 建议(帧 1、节奏),除非 DIRECTION.md 说明为什么不。
    • run.sh <film> sheet:为 checklist.md 中的每个类别评分,并修复任何低于 8 的项目。查看钩子、标志性时刻和结尾卡片的完整尺寸 stills:UI 是否清晰可读?是否有任何碰撞?帧的每个角落是否在做某事还是故意留空?
    • 观众会惩罚什么(RESEARCH.md › community check):UI 太小难以阅读,大物体上的弹跳,长度一致的镜头,听起来像库存的音乐,慢速的 logo 时刻。
    • run.sh <film> audio,然后 bash ROOT/scripts/compare.sh <film>:如果另一部影片过于相似,请有理由地更改 recipe。
    • 逐步浏览整个影片:run.sh <film> sheet $(seq 0.5 1 <length>)(每秒一帧)。寻找单张静止图像中隐藏的问题:场景变空、节拍无动作、转场不协调、线条在场景离开时才出现。
  3. 草稿 2。 一次性修复所有发现的问题,然后再次运行 check 和 sheet。
    • 如果仍有问题,最多允许再做一次修复。
    • 如果之后仍未通过,则不要继续:告诉用户遗留的问题及其原因。
    • 在 SCRIPT.md 中保留简短的评论日志:更改了什么以及为什么。
  4. 渲染真实文件: run.sh <film> video,30 秒的影片大约需要 45 秒。
  5. 展示它并询问(如果可用则使用 AskUserQuestion)。发送 MP4、4 行治疗和评论日志,然后针对这个版本提出 3–4 个针对性问题。每个问题都需要一个推荐选项,而“其他”让用户可以说任何内容:
    • 节奏: 感觉合适 / 更慢,更少文字 / 更快,更有冲击力。
    • 声音: 保持原样 / 更有活力 / 更舒缓 / 使用不同的乐器。
    • 钩子: 保持现状,或者从规划模式中的其他两个钩子候选中选择最强的一个,并命名。
    • 结尾: 保持现状 / 一个适合发布的结尾(例如,在应用上线前不显示下载徽章)/ 添加价格。
  6. 每轮回答修订一次,重新运行 check、audio 和 compare,然后展示新版。经过两轮用户反馈后,提供停止或继续的选项;由用户决定。

6. 存储徽章(仅当产品已上线时)

  • App Store 已上线且用户想要徽章: 请求权限,将苹果官方徽章(约 11 KB,黑色,英语 SVG;URL 在 rules.md 中)下载到 assets/。
    • 使用 drawAppStoreBadge 绘制它,保持静态且永不动画;强调效果来自 glowRing。
    • 如果用户坚持要为其添加动画,请解释一次苹果的规则。如果他们仍然想要,则将其制作成一个单独的、名称清晰的变体。
  • Google Play: 仅当应用在该平台上线并且用户同意下载时,才使用其徽章。否则,最多只能使用纯文本行,且仅当情况属实。

7. 交付

在展示的每个版本中,包括:

  • 以几行文字描述的治疗;
  • 自我审查修复了哪些内容;
  • compare 的结果和 check 的判定;
  • 发布前需要验证的声明;
  • 如何修改:编辑 SCRIPT.md 或 DIRECTION.md,或者直接说出需求。

在用户满意后,提供下一个有用的选项:

  • 15 秒版本,或其他格式(1:1、16:9);
  • 钩子变体用于 A/B 测试:使用规划模式中其他两个钩子候选打开的同一部影片;
  • 适合发布的结尾(在应用上线前不显示“下载”);
  • 纯效果版本(run.sh <film> video effects),用于配合平台声音或授权曲目发布。

Individual skills in this repo

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

相关技能