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:
- 证据板与个性。
- 故事: 承诺、标志性时刻、3 个钩子 → 1 个。
- 每个参数的设定及其理由。
- 相对于工作室的独特性: 阅读其他影片的
DIRECTION.md› Fingerprint。v0.2 之前制作的影片没有 Fingerprint;将它们视为 120 BPM A 小调 House 风格,左对齐标题位于卡片上方。 - 编写 DIRECTION.md 和 SCRIPT.md,使用选定的节奏。
不要要求用户选择样式。方向来自证据。
3. 一次审批
展示 4 行治疗(感觉 · 声音 · 外观 · 标志性时刻)和一个紧凑的节拍网格(时间 · 画面 · 文字 · 转场)。然后询问,如果可用则使用 AskUserQuestion(否则在聊天中询问):
- 计划: 批准,或修改某些内容。
- 插图: “我应该为此影片绘制插图吗?” 是的,请绘制插图 / 少量点缀 / 不用,只需截图和文字。推荐一个并说明理由(PLAN.md §5)。
- 绘制插图是免费的:Claude 会编写 SVG。
- 只有当会话连接了图像生成工具时,才将其作为选项添加,并说明可能需要收费。
在审批之前不要编写任何场景代码。此时的修改成本很低。
4. 构建
- 插图(如果选择“是”):将 SVG 写入
assets/drawn/,使用品牌颜色和统一的线条粗细(ENGINE.md › Drawn illustrations)。在一个页面上查看每个 SVG 的渲染效果,重新绘制任何笨拙的部分。 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文件中。
- 时间放入
- 声音: 通过
s.compose使用方向的Recipe+Section,并为每个画面事件添加s.cue,使用标志性声音。 - 检查构建:
bash ROOT/scripts/run.sh <film> sheet(无时间:整个影片加上所有转场)。修复编译错误(ENGINE.md › Gotchas)。
5. 草稿、修复,然后展示给用户
以草稿形式工作,切勿无休止循环:
- 草稿 1 是第一次完整构建:场景、音乐和每个提示。从影片本身(以下步骤)审阅它;不需要视频文件。(如果用户想提前查看,
run.sh <film> draft会渲染一个小的快速 MP4。) - 自我审查:一次通读,全部检查。
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>)(每秒一帧)。寻找单张静止图像中隐藏的问题:场景变空、节拍无动作、转场不协调、线条在场景离开时才出现。
- 草稿 2。 一次性修复所有发现的问题,然后再次运行
check和sheet。- 如果仍有问题,最多允许再做一次修复。
- 如果之后仍未通过,则不要继续:告诉用户遗留的问题及其原因。
- 在 SCRIPT.md 中保留简短的评论日志:更改了什么以及为什么。
- 渲染真实文件:
run.sh <film> video,30 秒的影片大约需要 45 秒。 - 展示它并询问(如果可用则使用 AskUserQuestion)。发送 MP4、4 行治疗和评论日志,然后针对这个版本提出 3–4 个针对性问题。每个问题都需要一个推荐选项,而“其他”让用户可以说任何内容:
- 节奏: 感觉合适 / 更慢,更少文字 / 更快,更有冲击力。
- 声音: 保持原样 / 更有活力 / 更舒缓 / 使用不同的乐器。
- 钩子: 保持现状,或者从规划模式中的其他两个钩子候选中选择最强的一个,并命名。
- 结尾: 保持现状 / 一个适合发布的结尾(例如,在应用上线前不显示下载徽章)/ 添加价格。
- 每轮回答修订一次,重新运行
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),用于配合平台声音或授权曲目发布。