persian-motion-director Skill 技能

技能简介 persian-motion-director 是一款面向 Claude 的"波斯语专业动态设计"技能，专门解决 AI 生成短片的两个老毛病：节奏像幻灯片、波斯字母动起来散架。它教 Claude 像导演一样工作——先给方向、再锁音乐、cut 打在 beat、只让一个镜头动、把波斯文按波斯读者习惯排。包含 8 种实战动效技法、逐字母 / 逐点波斯动画工具、波斯文 copy 与代码 lint。所有 sketch 是纯 JavaScript 时间函数，浏览器实时播放与 Remotion 帧精确渲染跑同一份代码。

核心能力

1. 8 种实战技法：单镜头无 cut / 一个形状串走全场 / 真 UI 导演版 / cut 打在 beat / 双帧 + 线条抖动 / 纸质剪贴字母 / 点字后置 / Kashida 而非字距——每个都附 recipe / 数值 / X 推文引用。
2. 反幻灯片规则：曲线、弹簧、stagger、hold、motion blur、节奏——有数据有出处。
3. 波斯文字体规范：letter joining、mask、bidi、字符、Kashida、字体、review checklist 全覆盖。
4. 自然波斯文 copy：常见机器翻译错误清单，避免"看起来像波斯语、读起来像机翻"。
5. 逐字母 / 逐点动画：HarfBuzz 形变 → SVG 轮廓 → 拆出 letter body / dot / joined group，按 RTL 顺序逐元素动起来。
6. 字面 lint：lint_persian.py 检查 copy（ي/ك、数字、半空格、标点、Kashida）与代码（letter box、letter-spacing、fade）。
7. 音乐先锁作曲与节拍图：compose_shur_pulse.py 写 120 BPM Dastgah Shur 风原创曲，含 beat map。
8. 多端渲染：浏览器实时预览 + Remotion 帧精确编码同一份代码——npx remotion studio src/index.ts 看全部 composition，render-clips.mjs out 出 8 段技术演示片与 82 秒 intro。
9. RTL 实战：3D RTL 界面、cursor on arcs、focus pull 等真实 UI 场景全覆盖。

安装配置

1. 作为个人 skill 安装：git clone https://github.com/atmirrr/persian-motion-director ~/.claude/skills/persian-motion-director。
2. 或放到项目的 .claude/skills/ 目录里，Claude 检测到 Persian / RTL 关键词即触发。
3. 安装 Python 工具链：pip install uharfbuzz fonttools，运行 python3 scripts/lint_persian.py copy copy.txt 自检。
4. 启动示例：浏览器端 cd assets/sketches && python3 -m http.server 8000；Remotion 端 cd assets/remotion && npm install && npx remotion studio src/index.ts。

使用步骤

1. 在 Claude Code 中用自然语言触发，例如："做一份 30 秒波斯语 app teaser，要 Remotion，cut 跟音乐"。
2. skill 走"工作流 → 方向 → 音乐先锁 → bar grid 上的分镜表 → 风格静帧 → 构建 → 检查"7 步。
3. 交付前调用 python3 scripts/lint_persian.py copy copy.txt 与 lint_persian.py code src/ 自检。
4. 用 npx remotion studio src/index.ts 浏览全部 composition，render-clips.mjs out 出 8 段技术演示片与 82 秒 intro。

适用场景

• 波斯语 / 阿拉伯语市场 app 的 launch teaser
• RTL 语言视频短片（波斯语、阿拉伯语、希伯来语、乌尔都语）
• 设计师 / 工作室要交付"不像 AI 生成"的高端短片
• 音乐人 / 视频博主做波斯 / 阿拉伯语 MV
• 想把"AI 一键动画"提升到"动效设计师口吻"的运营团队

适用人群

• 面向中东、伊朗、阿富汗市场的产品 / 营销团队
• 波斯语 / 阿拉伯语区博主、UP 主、内容创作者
• 设计师与工作室接到 RTL 项目时的高质量工具
• 学习波斯语 / 阿拉伯语 UI 与排版的开发者

工作原理 skill 由 SKILL.md 主导循环（anti-slideshow 规则 + 波斯文非妥协清单）+ references/（工作流、反幻灯片规则、波斯文 typography 规范、copy 清单、8 个技法详解）+ scripts/（shape_persian.py 形变 + split_fa.js 拆字母 + lint_persian.py 检查）+ assets/（sketches 8 个动效 + Remotion 适配器 + 原创音乐）构成。SKILL 代码是纯 JavaScript 时间函数；Remotion 在浏览器实时播放与帧精确渲染之间共用代码。

官方链接

• 仓库：https://github.com/atmirrr/persian-motion-director
• 文档：仓库 SKILL.md、references/
• 字体许可：Vazirmatn (SIL OFL)
• 许可证：MIT