motionable: make
あなたは製品に関する事実(それぞれにソースあり)、ユーザーからの回答、画像パス、色、そしてその製品の個性に関するメモを持ってここに来ました。あなたの仕事は、この製品らしく、スタジオ内の他のどのフィルムとも異なる、完成したフィルムを作ることです。
ROOT は motionable のルートです: ${CLAUDE_PLUGIN_ROOT}。これが展開されない場合は、このファイルの実際のパス (realpath) から2階層上のフォルダを使用してください。そのフォルダには 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> "<製品名>"を実行します。これによりエンジンがフィルム内にコピーされ、テンプレートが書き込まれます。 - アセット: 画像を
<film>/assets/に明確な名前(logo.png、screen-home.png...)でコピーします。ユーザーが持っている場合は、ブランドフォントファイルをassets/fonts/に配置します。
2. プランモード(内部用: コマンドなし、スタイルメニューなし)
PLAN.md を最初から最後まで実行します:
- 証拠ボードと個性。
- ストーリー: 約束、特徴的な瞬間、3つのフック → 1つに。
- すべてのダイヤル設定、それぞれに理由を添えて。
- スタジオ内での独自性: 他のフィルムの
DIRECTION.md› フィンガープリント を読んでください。v0.2より前に作られたフィルムにはフィンガープリントがありません。その場合は、120 BPMのAマイナーハウスで、左揃えの見出しがカードの上に配置されているものとして扱います。 - 選択したテンポで DIRECTION.md と SCRIPT.md を書きます。
ユーザーにスタイルを選ばせないでください。方向性は証拠から導き出されます。
3. 一度の承認
4行のトリートメント(フィール・サウンド・ルック・特徴的な瞬間)と、コンパクトなビートグリッド(時間・映像・言葉・結合)を表示します。その後、AskUserQuestion が利用可能であればそれを使用して(そうでなければチャットで)、以下のことを尋ねます:
- 計画: 承認するか、何か変更するか。
- イラスト: 「このフィルム用にイラストを描くべきですか?」 はい、イラストを描く / 少しだけアクセント / いいえ、スクリーンショットとタイプのみ。理由を添えて一つを推奨します(PLAN.md §5)。
- イラストを描くことは無料です: Claude がSVGを書きます。
- セッションに画像生成ツールが接続されている場合のみ、それをオプションとして追加し、費用がかかる可能性があることを伝えてください。
承認前にはシーンコードを書かないでください。ここでの変更はコストが低いです。
4. ビルド
- イラスト(はいの場合): ブランドカラーと一貫した線の太さで(ENGINE.md › 描画イラスト)、SVGを
assets/drawn/に書き込みます。それぞれがシート上でどのようにレンダリングされるか確認し、ぎこちないものは描き直します。 scenes/Film.swift: スケルトンを完全に置き換えます。すべての値は DIRECTION.md と SCRIPT.md から取得します:- 時間は
enum Tに格納します; - クリップと結合は
Reelに格納します; - スクリーンはフレーミング呼び出しを通過させます(固定ボックスにクリップしない);
- 特徴的な瞬間は、実際のUIと全く同じようにアニメーションするように再描画します。まずその位置を測定します:
bash ROOT/scripts/inspect.sh <スクリーンショット> find <その色>(またはrow、column、pixel)で正確なリング、バー、テキストの端がわかります。 - 方向性に必要なカスタム要素は、独自の
scenes/*.swiftファイルに配置します。
- 時間は
- サウンド: 方向性の
Recipe+Sectionをs.composeで、さらにすべての画像イベントにs.cueを、特徴的なサウンドを使用して追加します。 - ビルドを確認:
bash ROOT/scripts/run.sh <film> sheet(時間指定なし:フィルム全体とすべての結合を確認)。コンパイルエラーを修正します(ENGINE.md › 注意点)。
5. ドラフト、修正、そしてユーザーに表示
ドラフト単位で作業し、無限ループしないでください:
- ドラフト1 は最初の完全なビルドです: シーン、音楽、すべてのキュー。フィルム自体からレビューします(以下のステップ);そのためにビデオファイルは必要ありません。(
run.sh <film> draftは、ユーザーが早期に確認したい場合に、小さくて高速なMP4をレンダリングします。) - 自己レビュー: 1回のパスですべてのチェックを実行。
run.sh <film> check: すべての ✗ は必須修正です。ラインを長く保つ、早く開始する、言葉を削る、またはラインを削除します。タイプされたラインには、タイピング時間 プラス 読み取り時間が必要です。⚠ のアドバイスにも従ってください(フレーム1、リズム)。ただし、DIRECTION.md にそうしない理由が記載されている場合は除きます。run.sh <film> sheet: checklist.md のすべてのカテゴリを採点し、8未満のものを修正します。フック、特徴的な瞬間、エンドカードのフルサイズstillsを確認します: UIは判読可能か、何か衝突していないか、フレームのすべての隅が何かをしているか、意図的に空になっているか。- 視聴者が罰するもの(RESEARCH.md › コミュニティチェック): 読みにくいほど小さいUI、大きなもののバウンス、同じ長さのショット、ストック音楽のようなサウンド、遅いロゴの瞬間。
run.sh <film> audioを実行し、次にbash ROOT/scripts/compare.sh <film>: 別のフィルムと類似しすぎている場合は、理由を持ってレシピを変更します。- フィルム全体をステップ実行:
run.sh <film> sheet $(seq 0.5 1 <長さ>)(1秒に1フレーム)。単一の静止画では隠れてしまうものを探します: 空になるシーン、動きのないビート、不快な結合、シーンが去る直前に現れるライン。
- ドラフト2. 見つかったすべての問題を1つのバッチで修正し、
checkとsheetを再度実行します。- それでも不合格の場合は、最大であと1回の修正パスを許可します。
- それでも不合格の場合は、続行せずに、残っている問題とその理由をユーザーに伝えます。
- SCRIPT.md に簡潔な批評ログを残します: 何が変更されたか、その理由。
- 実際のファイルをレンダリング:
run.sh <film> video、30秒のフィルムで約45秒かかります。 - それを表示して質問する(AskUserQuestion が利用可能な場合)。MP4、4行のトリートメント、批評ログを送信し、このカットに関する3~4の的を絞った質問をします。各質問には推奨オプションが必要で、「その他」でユーザーが自由に発言できるようにします:
- ペーシング: ちょうど良い / 遅め、少ないライン / 速め、よりパンチを。
- サウンド: このまま / よりエネルギッシュに / より落ち着いて / 別の楽器。
- フック: このまま、またはプランモードからの他の2つのフック候補の中で最も強いもの(名前付き)。
- エンディング: このまま / ローンチセーフなエンディング(例:アプリ公開前にダウンロードバッジを表示しない) / 価格を追加。
- 回答のラウンドごとに1回改訂し、
check、audio、compareを再実行してから、新しいカットを表示します。ユーザーによる2回のラウンド後、停止するか続行するかを提案します。ユーザーが決定します。
6. バッジを保存する(製品が公開されている場合のみ)
- App Store 公開済みでユーザーがバッジを希望する場合: Apple の公式バッジ(約11 KB、黒、英語のSVG;URL は rules.md に記載)をダウンロードして
assets/に配置する許可を求めます。drawAppStoreBadgeで描画します。静止画でアニメーションは禁止。強調はglowRingで行います。- ユーザーがバッジのアニメーションを主張する場合は、Apple のルールを一度説明します。それでも希望する場合は、それを別の、明確に名前が付けられたバリアントとして作成します。
- Google Play: アプリがそこで公開されており、ユーザーがダウンロードを承認した場合のみ、そのバッジを使用します。それ以外の場合は、最大でプレーンテキストの行のみ、そしてそれが真実である場合に限ります。
7. 納品
表示するすべてのカットに、以下を含めます:
- 数行のトリートメント;
- 自己レビューで修正した内容;
- compare の結果と
checkの判定; - 投稿前に検証すべきクレーム;
- 変更方法: SCRIPT.md または DIRECTION.md を編集するか、単に伝える。
ユーザーが満足した後、次に役立つものを提案します:
- 15秒のカット、または別のフォーマット(1:1、16:9);
- A/Bテスト用のフックバリアント: 同じフィルムをプランモードからの他の2つのフック候補で開始;
- ローンチセーフなエンディング(アプリ公開前に「ダウンロード」を表示しない);
- エフェクトのみのバージョン(
run.sh <film> video effects)、プラットフォームのサウンドやライセンスされたトラックと一緒に投稿する場合。