Communitygithub.com

atmirrr/persian-motion-director

プロフェッショナルなモーションデザイン(プロモーション・ローンチフィルム、キネティックタイポグラフィ、アニメーション解説、ソーシャルクリップ、タイトルシークエンス)を、正しいペルシア語/ファルシー語と右から左へのタイポグラフィで、Remotion またはプレーンなウェブコードで制作・演出します。

persian-motion-director とは?

このスキルは、ペルシア語(ファルシー語)やアラビア文字、RTL(右横書き)テキストを含む動画やアニメーションを制作する際に、プロフェッショナルなモーションデザインを実現するための総合的なツールです。スライドショーのような「見た目がデフォルト」なアニメーションや、途切れたペルシア語の文字表示といった、AIが生成する動画にありがちな二つの問題を解決します。 本スキルは、「アンチスライドショー手法」(カメラをシーン間で移動させる、オブジェクトを継承させる、音楽に合わせたビートロック)と、ペルシア語特有の正しいタイポグラフィ(文字の結合、点の扱い、カシダ伸張など)を両立します。 Remotionとブラウザベースの両方の開発環境に対応しており、8つの実用的なテクニック(ワンカメラ、マッチカット、ビートカットなど)と、HarfBuzzを使った文字・点単位のアニメーション、ペルシア語のリンティングツールを提供します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add atmirrr/persian-motion-director

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

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

ドキュメント

Persian Motion Director(ペルシア語モーションディレクター)

あなたはアニメーションさせるだけでなく、演出を行っています。生成されたモーションのほとんどは、二つの予測可能な方法で失敗します。それは、スライドショーのように再生されること(シーンが互いにフェードインし、すべてに同じイーズイン/イーズアウトが適用され、すべてが同時に到着する)、そしてペルシア語が壊れていること(文字が分割され、点がクリップされ、アラビア文字や数字が使われ、半角スペースが不足し、左から右への表示になる)です。このスキルはその両方を修正します。この手法は、プロのモーションデザイナーがX(旧Twitter)で自身の作品を説明する方法に基づいており、ペルシア語のルールはW3Cの「Arabic & Persian Layout Requirements」から引用され、RemotionのレンダリングエンジンであるChromeで検証されています。

ディレクターのループ

この順序で作業を進めてください。各ステップは、それを省略することで作品がデフォルトのように見えてしまうため、存在します。

  1. ブリーフを読み、本当に不足している情報だけを補完する。 テキスト(ペルシア語とラテン語)、尺、アスペクト比、ブランドカラーとフォント、公開場所、音楽をコピーします。ブランドが存在する場合は、新しいものを考案する代わりに、そのパレットとフォントを使用します。
  2. 構築する前に方向性を示す。 モーションは主観的であり、やり直しにはコストがかかります。下記のテクニックライブラリからブリーフに合う6~10個を選び、assets/sketches/gallery.html を開くかクリップをレンダリングして、ユーザーに選択してもらいます。フルビルド後の作り直しは、選択リストを提示するよりも10倍のコストがかかります。
  3. まず音楽を決める。 アニメーションを開始する前に、トラックとそのテンポをロックします。ビートマップを作成します。各セクションがどの小節に配置されるかを決めます。トラックがない場合は、作曲するか(assets/music/compose_shur_pulse.py は beats.json を書き出す実用的な例です)、依頼します。120BPMの場合、1拍は0.5秒、1小節は2秒です。60fpsの場合、1拍は30フレームです。
  4. ビートグリッド上にショットリストを書く。(テンプレートは references/workflow.md にあります。)すべてのセクションの切り替わりはダウンビートに合わせ、すべてのカットはビートまたはその2フレーム前に合わせます。
  5. スタイルフレーム。 4~6枚の静止画をレンダリングし(assets/remotion/render-stills.mjs)、すべてをアニメーション化する前に承認を得ます。
  6. Remotionで構築する。 1つのカメラコンテナと共有オブジェクトを使用します(完全な実例は assets/remotion/src/intro/Intro.tsx を参照)。
  7. チェックし、その後レンダリングする。 すべてのテキストに対して scripts/lint_persian.py を実行し、静止画をフルサイズで確認して点のクリップや文字の結合切れがないかチェックし、すべてのカットをビートに合わせてスクラブし、ループを正確にします(クリップの長さ = ループ回数の整数倍)。

プロのモーションとスライドショーの違い

スライドショーの習慣代わりに行うこと
フェードトランジションで繋がれたシーン1つのカメラがシーン間を移動するか、1つのオブジェクトが次のシーンに引き継がれる。シーン間で fade() を使用しないこと。
すべてに同じイーズイン/イーズアウト各動作に独自のカーブを設定。出現:bezier(.16,1,.3,1) で約20フレーム。退出:bezier(.7,0,.84,0) で約8フレーム、移動距離は約70%のみ。
すべてが一緒に、等間隔で到着する1つのリード要素を決め、残りは2~4フレーム遅らせて、等間隔ではなくカーブに沿って配置する。
Remotionのデフォルトのバウンドする spring()(オーバーシュート約16%)UIでは2%未満、テキストでは0%のオーバーシュート:stiffness 100 / damping 16 で約1.5%に。
最後に音楽を重ねる音楽を先に決め、ビートに合わせてカット、サウンドアタックを視覚的なヒットに合わせる。
グラデーションの中央揃えテキスト、最後にロゴ最初の10秒で実際の製品が実際のタスクを行っている様子を見せる。
停止しない、または動きが止まらないモーション読むのに十分な長さで静止する。カメラだけが動く(ズーム1.00 → 1.04 をシーンごとに)。
仕上げとしてのグレイン、ハーフトーン、ASCII物理的な理由(紙、印刷、光)がある場合のみテクスチャを使用。これらの仕上げは今やAIのデフォルトです。

より詳細な数値とそのソースについては、references/anti-slideshow.md を参照してください。

ペルシア語の譲れないポイント

フレームにペルシア語を書き込む前に references/persian-typography.md を読んでください。簡易版は以下の通りです:

  1. ペルシア文字を個別のボックスに入れないこと。 inline-block スパン、フレックス子要素(Remotionの <AbsoluteFill> の直接の子を含む。これはフレックスボックスです)、および文字ごとのトランスフォームは、各文字を孤立形で描画します。単語または行全体をアニメーション化してください。文字単位や点単位のモーションが本当に必要な場合のみ、シェイプアウトライン(scripts/shape_persian.py)またはゼロ幅接合子分割(scripts/split_fa.js)を使用してください。
  2. 単語をフェードさせるのであって、文字をフェードさせないこと。 結合された文字は重なっています。文字ごとの不透明度や透過テキストカラーは、接合部に継ぎ目を残します。
  3. マスクには余裕を持たせること。 ペルシア語はラテン語よりも上下に大きくはみ出します。クリップマスクの上下に約0.5emのパディングを追加し、行の高さを1.6以上(ナスタアリーク体の場合は2.4以上)に設定します。そうしないと、点やگ の上部が切り取られます。
  4. 書字方向。 すべてのペルシア語ブロックに dir="rtl" lang="fa" を設定します。ラテン語の名前や数字は <bdi>(またはFSI/PDI)で囲みます。そうしないと行が乱れます。リビールやスタガーは右から開始し、カメラの進行は左に進み、「次へ」矢印は左を指します。再生ボタン、時計、数字はミラーリングしません。
  5. 文字。 ペルシア語の ی(U+06CC)と ک(U+06A9)を使用し、アラビア語の ي/ك は使用しません。ペルシア数字 ۰–۹(U+06F0–06F9)を使用し、アラビア・インド数字 ٠–٩ は使用しません。半角スペース(ZWNJ、U+200C)を می‌、‑ها、‑تر/‑ترین で使用します。句読点は 、؛ ؟ « » を使用します。scripts/lint_persian.py がこれらを検出します。
  6. 文字間隔(レタースペーシング)を使用しないこと。 Chrome(バージョン137以降)はペルシア語の単語内でこれを無視し、他のツールは結合を壊します。代わりにカシダ(kashida)を使用して伸張します。ただし、前方向に結合する文字の後にのみ、単語ごとに最大1つまでとします。
  7. フォントを毎回読み込むこと。 ペルシア語フォント(またはそのアラビア文字サブセット)が読み込まれていない場合、Chromeは自動的にシステムフォントにフォールバックします。Remotionでは FontFace + delayRender を使用します(assets/remotion/src/fonts.ts 参照)。
  8. コピー。 一貫した文体で自然なペルシア語を書きましょう。単語単位で英語の慣用句を翻訳しないでください。レンダリング前に、ネイティブスピーカーが各行を承認します(references/persian-copy.md)。

テクニックライブラリ

各テクニックのライブコードは assets/sketches/sketches.js(プレーンなJS、時間の純粋関数)にあり、ブラウザページと SketchPlayer を介したRemotionの両方で実行できます。詳細、数値、各テクニックの元となったXの投稿は references/techniques/ にあります。

#テクニック使用場面スケッチID
01ワンカメラ、カットなしフィルムの背骨:1つのストリップ上のシーン、モーションブラーとパララックスを伴うウィップパンoner
021つのシェイプがストーリーを運ぶトランジション:終止符がチャットバブルに成長し、次の終止符へと移るmatch
03実際のUIを演出する製品の見せ場:3Dの実際のインターフェース、円弧上のカーソル、フォーカスプルui
04ビートに合わせてカット機能説明とキネティックタイポグラフィ:すべてのビートでのハードカット、パンチイン、反転フレームbeat
052コマ打ち、ラインボイル付きクリーンなUIの上に手描きのレイヤー:図形は2フレーム保持、線は12回/秒で震えるboil
06ペーパーカットアウトレター温かみのあるタイトルカード:結合された文字グループはそれぞれ1つの硬い紙片cutout
07点は最後にワードマークとリビール:まず文字本体、次に点が落ちてくるnuqta
08文字間隔ではなくカシダ保持された音符の強調:結合ストロークを伸ばす、書道の点で測定kashida

目新しさではなくブリーフに基づいて選択してください。一貫して使用される1つまたは2つの特徴的なテクニックはシステムとして読まれますが、8つすべてを一度に使用するとリールのように見えます。

このスキルに含まれるツール

  • scripts/shape_persian.py — HarfBuzzでペルシア語をシェイピングし、文字本体、点、結合文字グループに分割されたSVGアウトラインをエクスポートします(pip install uharfbuzz fonttools)。これにより、スクリプトを壊すことなく、文字単位、点単位、カシダアニメーションが可能になります。
  • scripts/split_fa.js — ペルシア語の単語を、結合形を保持した文字に分割します(ゼロ幅接合子)。アウトラインが過剰な場合に使用します。
  • scripts/lint_persian.py — コピー(アラビア文字と数字、不足している半角スペース、英語の句読点、誤った位置のカシダ)とコード(文字間隔、文字単位のボックス、dir の欠落)をチェックします。
  • assets/sketches/ — モーションエンジン(engine.js)、8つのスケッチ、シェイプされたグリフデータ、スタイル、および gallery.html(任意の静的サーバーでフォルダを提供)。
  • assets/remotion/ — SketchPlayer(フレーム番号からスケッチを駆動)、テクニックごとの1つのクリップコンポジション、実例としての完全なイントロフィルム、およびクリップと静止画をレンダリングするためのスクリプト。
  • assets/music/compose_shur_pulse.py — ダストガー・シュール(Dastgah Shur)で書かれたオリジナルの120BPMトラック(ビートマップ付き)。編集を音楽にロックする方法を示します。

ユーザーが簡単な作品だけを望む場合

それでも、コストのかからない2つの譲れないポイントは守ってください。ペルシア語の文字単位のボックスを使用しないこと、そしてシーン間のフェードを使用しないことです。1つのテクニックを適切に使用し、タイミングをビートグリッドに設定し、フルレンダリング前に静止画をレンダリングしてペルシア語を確認してください。

関連スキル