Carvercat モーショングラフィックス
何か見つからない？ references/INDEX.md で、スキル全体（クラフト、アプリ、エフェクト、描画、マップ、ワークフロー、既知の問題）の「Xはどこ？」に回答しています。
Carvercat MCPツールを呼び出せるあらゆるエージェント（Claude、GPT/Codex、Gemini、または一緒に読み進める人間）で動作します。特定のベンダーに依存するものは何もありません。ツール名にはクライアントのプレフィックスが付く場合があります（例: mcp__carvercat__carvercat_run）。
0. 単位と新しいサーフェス（最初に読むこと）
記述するものはすべてデザインユニットで指定します：フレームの左上からのpx（yは下向き）、度（時計回り）、CSS色とイージング、fontSize px、時間はフレーム数、"1.5s"または"500ms"。シーン全体は検証済みの1回の呼び出し（scene.apply、ドライランを先に）で構築し、CSSライクなセレクタでオブジェクトを選択し、ヘルパー（layout.*、text.fit、motion.apply、measure.*）を使用し、送信前にcarve.preflight {host}を実行します。ガイド：references/app/design-units.md。古い名前も1リリースの間は動作し、そこに一覧が記載されています。それらを使用しないでください。
0b. 何かを触る前に
- このマシンにインストールされているCarvercatアプリの場所を確認し、このスキルのフォルダをインストール済みとして使用します。クリエイティブなジョブにはこのスキルで十分です。固定された過去のパスを使用しないでください。
carvercat_session（アタッチ）次にcarvercat_state：何かを変更する前に、ビルド、開いているプロジェクト、コンポジションを確認します。carvercat_listでIDを取得します。- 構築中はアプリをクリックしないよう人に依頼してください。コンポジションの切り替えにより、次のコマンドがリダイレクトされます。
- ユーザーのドキュメントをクリアして再構築しないでください。編集可能な
.carverprojをジョブの保存先に保存します。
1. モーションデザイナーのように計画する（クラフト）
ジョブに必要なものだけを読んでください：
| 必要なもの | 読むもの |
|---|---|
| 持続時間、イージング、12の原則、振付、音楽に合わせたタイミング、アンチパターン | references/craft/motion-principles.md；各原則の1ページは references/craft/principles/ |
| タイプスケール、読了時間、出現スタイル、強調；測定されたトラッキング、リーディング、リントしきい値 | references/craft/typography.md |
| どのトランジション、どのくらいの長さ、カットでの受け渡し | references/craft/transitions.md |
| SFXと音楽：イベントごとに1クリップ、レベル、ポップ/ウィッシュの仕様 | references/craft/sound-design.md |
| 9:16 / ソーシャルセーフエリア、16:9作品の変換 | references/craft/vertical-and-safe-areas.md |
| パレットの役割、コントラスト、グラデーション、カラー値 | references/craft/colour.md |
| ブランドのモーションシステム：イージングファミリー、持続時間、シグネチャームーブ、ブランドパック | references/craft/brand-systems.md |
| 焦点、読み取り順序、グリッド、階層、セーフエリア | references/craft/composition-and-layout.md |
| ブリーフの読み方：事実、フレーム予算、スタイル、レシピ | references/craft/reading-a-brief.md |
| ブリーフに適したスタイルパック | references/craft/style-families.md |
| スタイルごとの測定されたフレーム数；スタイルのレビューリスト | references/craft/timing-by-style.md, references/craft/review-by-style.md |
| 動きが機能する理由：12の原則とその先、デザインの基礎、テクニック、ジャンル、タイミング、ワークフロー、アクセシビリティ、歴史（各ページはCarvercatで行う方法で終わる） | ../wiki/README.md、マシンインデックス ../wiki/index.json |
どこでも適用されるルール：
- シーンごとに1つの主役。
- サポートアイテムはexpo-outまたは減速で入場。
- 退出は加速し、入場時間の約70％かかります。
- 隣接アイテムは3〜6フレームずらします。
- すべてのシーンには入場、中間の動き、退出があります（停止したホールドは不可）。
- テキストは最低 max(25 f, 1単語あたり10 f) + 10 f ホールドします。Carvercatのリントは毎秒17文字（スペースはカウントしない）、最低25フレームの完全不透明を要求します。
2. 最初にパターンライブラリから構築する
patterns/README.md には、0.0.72で検証された25のプリセットと5つのテンプレート（測定済みのオーバーシュートとセトルフレーム付き）に加え、プッシュ、ズームスルー、カードスタック、ハイライトスイープのレシピが含まれています。パックは ../library/templates/motion-patterns/ にあります。library.list {query:"expo"} でインストールされているか確認してください。ない場合は、ユーザーのLibraryフォルダにインストールします（Help > Library Folder または library.folder、templates/ にコピー、その後 library.reload；Carvercat 0.1.8+ が必要；patterns/README.md を参照）。0.1.8より前では、インストールされたアプリはそれをロードできません。配置されたテンプレートはネストされたコンポジションになります — パターンREADMEを参照してください。
- 単一オブジェクト：
preset.apply {name, id}、例：Rise - expo、Pop - spring、Stamp、Exit up - accelerate。 - テキスト：
Words rise - expo、Letters cascade - spring、Lines reveal - decelerate、など。 - 複数オブジェクト：
library.place {name, frame}その後template.apply {id}。例：Two-tone wipe、Colour iris、Lower third - accent bar、Logo - stamp reveal、Bar chart - grow。 - 1つのコンポジションに複数のビートを持つ作品全体：patterns/promo-assembly.md。
- スタイルパック（Motion Patternsと同じインストール方法）：SaaS UI、Kinetic Typography、Data Viz、Corporate Brand、Minimal Luxury、Social Short-form 9:16、Cartoon Bounce、Funky、Futuristic HUD、Retro、Glitch、Sports、Explainer；references/craft/style-families.md で選択します。これらにはRethink Sansのインストールが必要です（テキストはアプリバンドルのフォントを使用できません、KI-136）。各スタイルには
../categories/の下にラボとショーケースプロジェクトがあります。 - 一般的なブリーフ用レシピ（SaaSローンチ、スポーツスコア更新、9:16チップリール、年次報告書オープナー、四半期業績、高級ティーザー、解説レッスン、キネティッククォートリール、キッズ解説、セールプロモ、テックトレーラー、レトロナイト、音楽ティーザー）：フレーム付きのショットリストと、Libraryテンプレートのみから構築された検証済みサンプルプロジェクトが recipes/README.md にあります。
- 正確なカーブ：離れるキーに
ease: "cubic-bezier(a, b, c, d)"（patterns/custom-curves.md）。 - スプリングとバウンス：
scripts/motion/curves.pyでキーに焼き付けます。
3. アプリを操作する
恒久ルール（2026年10月23日）： .carverproj JSONを直接編集してシーンを構築および変更し、その後 edit.open {force:true} を実行します。シーン全体は、検証済みのアトミックな scene.apply でMCP経由でも送信できます。プロジェクトファイルは現在 carvercat/2（px、y下向き、フレーム；保存のたびに書き込まれ、v1ファイルも開きます）であり、以下のJSONルートは、json_author/cc.py が書き込み、アプリがまだ読み込める古いv1形式（分数、y上向き）を説明しています。新しいジェネレーターの場合は carvercat/2 を書き込みます（cc_project.py 、レシピビルダーが行うように）。ファイルではできない手順（テキストの測定、ルック、保存、Resolve転送、ライブ調整）にはMCPを使用します。手順と代替手段：references/app/json-authoring.md。
references/app/design-units.md が実用ガイドです：単位、scene.apply、セレクタ、anim.set（トゥイーン、イージング、スタガー）、CSS用語でのエフェクト、ヘルパー、ヘッドレスノート。references/app/mcp-essentials.md は、ビルド→ルック→チェックのループ、知っておく価値のあるコマンド、何時間も費やす落とし穴（clip.move は上書き、IDはコンポジションごとに再起動）をカバーしています。機械可読カタログは carvercat://schema/design、carvercat://schema/commands、carvercat://schema/scene（アプリリポジトリの schema/agent/json-schema/）です。使い慣れないキーを使用する前に関連エントリを読み、引数や生成されたエントリIDを推測しないでください。
スクリプト処理には、メンテナンスされたPythonスクリプトを使用します：ai/scripts/cc_client.py + cc_scene.py（references/app/creative-toolkit.md）；アプリにも独自のPythonヘルパーがあります（carvercat_py）。エフェクト、フィル/ストローク、グラデーション、色、トランスフォーム、スタガー、パストリムは references/app/creative-controls.md にあります。保留中の計画は scene.apply {dry_run: true} と measure.* で確認できます。ドキュメント以外には何も保存されません。整形されたテキストを実際に測定します。フォントを意図的に選択します。混在RTLテキスト内の個別のLTR数字の実行も含みます。ガイド内のすべての例は、ai/scripts/verify_examples.py によってヘッドレスCarvercatに対して実行されます。
3b. エフェクト、描画、マップ、ジョブ全体
| 必要なもの | 読むもの |
|---|---|
| ブラー、グロー（バーン制限付き）、シャドウ、モーションブラー、グラデーション、ストローク/トリム描画出し、ソフトエッジとマスクフェザー、テキストアウトライン、スタガー、マスク | references/effects/README.md |
| 非表示のベースメントパラメータ、それらのプロモート、パラメータ間のロープ | references/effects/basement-promote-ropes.md |
| すべてのシェイプ（長方形、楕円、星、多角形、パス）、配置とグループ化 | references/drawing/shapes.md |
パーツからのキャラクター/オブジェクト：アンカーをジョイントとして、ペアレンティング、ヌルオブジェクト（object.new {kind: "null"}）をピボットまたはハンドルとして | references/drawing/rigging.md |
| マップ：境界線、道路、ピン、ルート、リング、ランドマークポップアップ、矢印、ズームイン/アウト | references/maps/maps.md |
| キャプション+VO、RTL/アラビア語、Resolve受け渡し、エクスポート、ジョブループ | references/workflows/ |
| 何かが誤動作する場合 | references/known-issues.md |
どこでも適用されるエフェクトルール：glow の強度 ≤ 0.8（0.9でクリップ、1.0で白飛び）、半径がハローの到達範囲を設定します。ブラーとシャドウは主役にのみ奥行きのために使用。線にはトリム描画出し。UIシェイプには softEdge 2〜6 px、アンビエントライトには160〜320 px（references/effects/soft-edge.md、フェザーマスク表示付き）。
4. 完了と言う前にチェックする
- ルック：入場、ホールド、退出を確認（
carvercat_look）。測定：carvercat_inspect（timing、オーバーシュートとセトル用のcurves、lint、expect、フラッシュ用のqc）およびレンダリング不要のヘルパー（measure.boxes、measure.overlaps {within: "safe"}、measure.contrast）を使用。送信前にcarve.preflight {host}でプリフライト。 - references/craft/review-checklist.md を確認：ストーリー、タイミング、テキスト、UI、トランジション、ルック、サウンド、衛生。
- 最初に代表的なコンポジションを1つ構築し、レビューしてから拡張します。レシピは出発点です：階層、イメージ、タイミングをブリーフとフッテージに適合させてください。安全範囲は視覚的判断に取って代わるものではありません。
- ラグやオーディオのスタービング：references/app/performance.md。
5. アプリ外で動作するツール（scripts/motion/、Python 3、標準ライブラリ + ffmpeg）
vo_align.py：ナレーション → 単語と行のフレーム。sfx_kit.py/sfx_render.py：合成SFX（ポップ、ウィッシュヒット、チック、インパクト...）→ キューごとに1つのWAV。music_bed.py：カットに合わせたBGM；mix_check.py：ステムLUFSとリファレンスミックス。reformat.py：16:9プロジェクト → 9:16コンポジション。carverproj.py：プロジェクトJSONヘルパー（ID、キー）。build_pattern_pack.py/comp_to_template.py：パックを再生成。effects_param_tables.py：エフェクトパラメータテーブルを再生成。../maps/geo_paths.py/../maps/map_overlay.py：実際の地理 → パス；解説オーバーレイ（ピン、リング、ルート、カード、矢印）。
6. 安全性と納品
シーンID（および Scene.component 名前空間）を使用して、リビジョンが同じオブジェクトを更新するようにします：同じドキュメントを再度適用すると、差分のみが変更されます。拒否された後は、それに依存する作業を停止します。未知の結果の後は、それ以上の変更を行う前にIDと状態を検査します。結果が不明な書き込みやエクスポートを再実行しないでください。Resolve操作にはユーザーの現在の認可が必要です。認可がない場合は、ネイティブでのみオーサリングとテストを行います。認可された場合、実際のプロジェクト、タイムライン、フォーマットを確認し、元の編集を保持し、コンポジットサンプルを検査します。Carvercat作業の単位はコンポジションです。Resolveタイムラインは別物です。転送検査、統合、再配置、再リンクについては references/app/media-recovery.md を読んでください。クリーンアップの参照範囲が不完全な場合は、ファイルを保持します。
クラフトレファレンスの背後にあるアイデアのクレジットとライセンス：SOURCES.md。