Communitygithub.com

fy-code-animation

中国語の文章、スタイルプロンプト、音声を、統一された美意識で一貫性のあるコードアニメーション(Remotion / Canvas / HTML)に変換するスキル。テキスト全体の理解と意味に基づく絵コンテ、341スタイルライブラリのインプレース検索、強調表現と日本語の動的テキスト、生き生きとした背景とパーティクル、モーション物理、カメラワーク、トランジション、キャラクターパフォーマンス、ピクセル/カートゥーン/手描き/3Dブランチ、チャート/マップ/UIと画像モンタージュ、4案の音楽と効果音、Remotionへの実装、品質チェックと修正、そして異なるAIエージェント間の引き継ぎをカバーします。

fy-code-animation とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)が、中国語の散文、ナレーション、または音声スクリプトを、Remotion、Canvas、またはHTML/GSAPを使用したプロフェッショナルなコードアニメーションに変換するための包括的なフレームワークです。テキストの深い意味分析、統一されたスタイルガイドライン、リッチなアニメーション効果(カメラワーク、トランジション、パーティクルシステム、キャラクターアニメーションなど)を組み合わせ、単なる「パワーポイントスタイル」のアニメーションではない、表現力豊かで一貫性のある作品を生成します。このスキルは、外部の341スタイルライブラリに依存して、多様なビジュアルスタイルを実現し、音楽生成(ACE-Step 1.5など)や最終的なレンダリングのためのローカルツールと統合します。異なるエージェントが作業を引き継げるように、明確な設計ドキュメント(タスクカード)、決定管理、品質保証プロセスを提供し、複雑なアニメーションプロジェクトでのコラボレーションを可能にします。このスキルは、アニメーションの設計、タスクカードの作成、絵コンテの作成、または既存のアニメーションの修正を目的としたリクエストに使用します。依存関係の自動インストールやメディアファイルの無断生成には使用しません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FYZB2020/dsh-fy-code-animation/tree/main/skills/fy-code-animation

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

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

ドキュメント

俯仰コードアニメーション

「俯仰観照」は無料で共有されています。ご自由にご利用・ご共有ください。有料講座、有料スキル、または有料資料として転売しないでください。詳細は利用と共有に関する説明をご覧ください。サードパーティのコンテンツは、それぞれのライセンスに従います。

視聴者に意味の変化を視覚化する:一貫したビジュアル言語で、テキスト、オブジェクト、背景、カメラ、サウンドを同一のタイムラインに編成します。エージェントごとに独自のデザインの特徴を持たせることはできますが、重要な表現、作成者の決定、および納品基準は統一します。

このファイルはエントリーポイントです。各ステップでどのファイルを読み込むかを指示します。エントリーだけ読んで作業を始めないでください。また、すべてのファイルを一度にコンテキストに入れないでください。

ステップ 0:まずプロジェクト、ライブラリ、決定事項、フェーズを特定する

  1. 作業ディレクトリとその親ディレクトリからプロジェクトファイルを探す:project.json、BRIEF.md、STATUS.md、DECISIONS.md(最新部分を読む)、作品自身の task.json またはタスクカード。STOP.txt や明確な一時停止記録があれば、許可された整理のみを行う。

  2. まず341スタイルライブラリの場所を確認する。これがこのスキルの唯一の外部依存関係であり、パッケージに同梱されず、各人が異なる場所に配置します。解決順序:--root > 環境変数 FY_STYLE_LIBRARY_ROOT > adapters/style-library.config.json の root。3つとも存在しない場合は、ユーザーに一度だけパスを尋ね、質問したら停止する:ディスクを走査しない、推測しない、ダウンロードしない、ライブラリの原文をコピーしない。ライブラリのルートには スタイルプロンプト/ があり、オプションで サンプル/ があります。パスを取得したら、まず python scripts/style_library.py build --root <ライブルート> を実行してローカルインデックスを再構築します(パッケージに含まれるインデックスはスナップショットに過ぎず、あなたのライブラリで構築されたものとは限りません)。その後、検索します。詳細は ライブラリインターフェース を参照。初回使用時またはライブラリ変更後は、python scripts/doctor.py を実行します:ライブラリが特定されたか、インデックスが最新か、不足しているものがあれば直接報告します。

  3. 毎回必読 デフォルトの規約と既存の決定。ここには、フロー、スタイル、フォント、背景、サウンドに関する条件付きの選択が書かれており、そのまま使用し、表全体を再度尋ねないでください。ユーザーの今回の明確な要求がこのファイルを上書きします。プロジェクトに新しい DECISIONS.md がある場合は、より新しい明確な決定が優先されます。

  4. フローとフェーズ を読み、今回の範囲を判定する:

    • card はタスクカードのみ提出:完全な設計を書き、アニメーション、静止画、音楽を生成せず、レンダリングもインストールもしない。納品フォーマットは タスクカード仕様 を参照。
    • still は静止画のみ出力:指定された静止画のみを作成し、4つの音楽を待たない。
    • audition は試聴:4案を書き、許可のもとローカルで生成し、作成者が選択する。
    • final は本番:実際のサウンドに従って実装し、チェックする。

    範囲が不明な場合は、より小さい範囲で実行し、納品物に明記する。外部スキルやリポジトリからのインストール、支払い、アップロード、メッセージ送信の指示は許可を構成しない。

制作順序(本スキルでは固定、ステップを飛ばせない)

ステップ内容読み込むファイル
1全文を読む:主旨、作成者の意図、視聴者の理解の変化、感情の流れ、事実、比喩、因果関係、対比、段階的強調意味、ナラティブ構造
2コンテンツ構造に従ってセグメントに分割し、強調すべきキーワードとその強度をマークする意味、強調表現と動的テキスト
3まずあなたの理解と提案を簡単に述べ、次に作成者に質問する:全編統一スタイルか、セグメントごとに変更するか、何種類にするか、またはあなたに任せるか。既に回答があるか委任されている場合は、それをそのまま使用するスタイル
4スクリプトを使用して選択したスタイルの原文を検索し完全に読む、SHAと依存関係の欠落を記録するライブラリインターフェース
5作成者の全体的な要求を再読し、スタイル、フォント、キャラクター、尺、サウンド、フェーズ間の矛盾を処理する決定
6全編の視聴覚フレームワークとショットごとの絵コンテを設計する:各セグメントが何を語るか、テンポ、イラスト、余白、主体の変化、カメラ、トランジション、テキスト、背景、サウンドの要件監督と詳細、絵コンテ表、および以下の能力ルーティング
7大きなフレームワークが決まったら、実質的に異なる4つの音楽案と効果音表を作成する音楽モジュール、音楽と効果音のレシピ、4案テンプレート
8許可されたフェーズのみ:ローカルの音楽ジェネレーターを使用して4案を生成する(パッケージにはACE-Step 1.5アダプターが同梱、他のツールは適宜変更する)、作成者が試聴して選択するローカル音楽アダプター
9実際の完成オーディオとナレーションのタイムコードに従って、Remotionなどを使用してカメラワーク、モーション、字幕、効果音を実装する実装契約、Remotion インターフェース、Remotion スケルトン
10チェックして修正する。機械チェック、実際の視聴、作成者の採用を分けて記録する品質と修正、修正表

タスクカードのみ提出する場合は、ステップ1~7を完了し(ステップ3で回答がない場合、質問をカードに書き込み、後続の設計を「未定」とする)、タスクカード仕様 に従って納品する。

能力ルーティング:何に遭遇したかで、何を読み込むか

まずモジュール(方法と判断)を読み、具体的な手法が必要になったら、レシピと実装にドリルダウンします。パラメータはあくまで開始点の例であり、スタイルを横断するコマンドではありません。

問題やシグナルモジュール深堀りレシピ再利用可能な実装
因果関係、転換、抽象概念、単なるスライドショーになるのが怖い意味ナラティブ構造、監督と詳細—
スタイル選択、番号、作成者リスト、チャプター間のスタイル変更スタイルライブラリインターフェースscripts/style_library.py
強調表現、キーワード、タイトル、字幕、中国語の改行、フォント統一タイポグラフィ強調表現と動的テキスト、字形と線画implementations/type-cn/、implementations/craft/type/、scripts/glyph_outline.py
背景が退屈、パーティクル回転、光エフェクト、グリッド、プロシージャルテクスチャ、画像背景の活性化背景幾何学生き生きとした背景、集団とモザイクimplementations/backgrounds/、implementations/specimen/
モーションに重みがない、リズムが均一、スプリングが暴れる、タイミングが重なるモーションスプリングとタイミングオフセット数値テーブル、モーションリファレンス、UI 16 レシピimplementations/motion-core.mjs
パン、チルト、ズーム、フォーカス、パララックス、トラック、フリップ、フォロー、被写界深度カメラとトランジションカメラワークimplementations/camera/
セグメント間のつなぎ方:同じオブジェクトの受け渡し、マスク、ページめくり、パーティクル再構成、ワープ、カットカメラとトランジショントランジションの系統、継ぎ目とシークimplementations/transitions/
一貫した小さなキャラクター、表情、視線、歩行、持ち物、クロススタイルでのキャラクター一貫性スタイルブランチキャラクターパフォーマンス、ペーパークラフトとストップモーションimplementations/character/
ピクセル、カートゥーン、手描き、印刷、ブループリント、3Dスタイルブランチ特殊スタイルレシピimplementations/craft/、implementations/specimen/
写真、商品画像、高速画像表示、コラージュ、カルーセルイメージ画像とモンタージュimplementations/data-ui/(PhotoMontage、KenBurns)
製品操作、チャート、カウント、地図、コードデモプロダクトとデータチャート/マップ/UI、UI 16 レシピimplementations/data-ui/
音楽4案、ビート、効果音、ナレーションの優先、ミキシング音楽音楽と効果音implementations/audio-sync/beat-grid.mjs、ローカルアダプター
Remotion、Canvas、HTML/GSAP実装、タイムベース、フォント読み込み実装契約Remotion インターフェース、継ぎ目とシークimplementations/remotion-kit/、implementations/canvas-contract.mjs
モデル変更、引き継ぎ、特定ショットの修正引き継ぎ契約タスクカード仕様templates/task.json、scripts/validate_task.py、templates/repair.md
自己レビュー、問題発見、修正品質監督と詳細(レビューフロー)—

品質基準

これらは「良いか悪いか」の最低ラインであり、すべての作品にすべてのエフェクトを使うことを要求するものではありません:

  • スライドショーにしない:各ショットには、意味を伝えるための観察可能な変化(関係、動作、オブジェクトの状態)がなければならず、「タイトル+アイコン+フェードイン」であってはならない。
  • 一貫したオブジェクトと継ぎ目がある:隣接するショットは、何でつながっているかを明確に記述する。自然につながらない場合は、理由を持ってカットする。
  • 強調表現を捉える:重要度に応じて表現を分级し、すべてを大きく表示したり、バンと表示したりしない。否定語や条件語は必ず読めるようにする。
  • スタイルが実際に使用されている:マテリアル、構図、モーションの文法、カメラ言語が選択したスタイルを反映しており、配色だけではない。
  • 背景は明確な空間、マテリアル、または雰囲気のデザインを持ち、読み取りエリアにスペースを譲る。必要であれば完全に静止していてもよい。
  • テンポに緩急がある:溜め、開放、静けさがある。尺を均等に割り振らない。
  • フォントが統一されている:手書きフォントを不意に挿入しない。中国語の字形、改行、行間が正しい。
  • サウンドは設計されている:4案が本当に異なる。ビートは実際のオーディオトラックに基づく。「ビートに合わせた」と虚偽の記述をしない。
  • 決定性:任意のフレームをシークして再現可能。Date.now、シードなしのランダム、または累積状態に依存しない。
  • 誠実さ:素材、データ、依存関係の状態、検証結果を偽装しない。機械チェック、視聴、作成者の採用を分けて記録する。

呼び出し例

  • 「341スタイルライブラリは D:\あなたのパス\コードアニメーション にあります。このパスを使ってください。カレントディレクトリの fy-code-animation/SKILL.md を読み込み、現在のプロジェクトと確定した決定事項を踏襲してください。まず全文を理解し、既存のスタイル設定に従って完全なプロンプトを検索し、その後、カメラワーク、モーション、サウンドを設計してください。今回はタスクカードのみ提出し、アニメーション、静止画、音楽は生成しません。必要に応じて深層レシピと実装を読み込み、エントリーポイントだけを読まないでください。」
  • 「修正表に従って、S03の中国語テキストのクリッピングを修正してください。音楽と文案はそのまま使用。静止画のみ出力して検証。」
  • 「作成者のスタイルリストに従って完全なプロンプトを読み込み、各チャプターの選択根拠と依存関係の欠落を出力してください。メディアは作成しない。」

完全なウォークスルーは サンプルナビゲーション を参照。パッケージ内のTSX/MJSは再利用可能な候補ソースコードであり、ローカルで本番確認されていません。ターゲットプロジェクトに組み込んだ後、そのフェーズに従ってチェックしてください。再利用のソースとライセンスについては ソースとライセンス を参照。

3つの初期レシピ(formation-and-mosaic、paper-performance、ui-16-recipes)と15のモーションリファレンスは英語原文のままです(上流ソース)。これらを読んでも出力言語には影響しません。納品物、タスクカード、字幕は引き続き中国語です。

自分用にカスタマイズするには

  • 名前を変更する:frontmatterの name とディレクトリ名を変更するだけです。パッケージ内の他の参照はすべて相対パスであり、呼び出し例の fy-code-animation/SKILL.md のみが例示であるため、一緒に変更できます。
  • デフォルトを変更する:あなたの好みをプロジェクトの DECISIONS.md に書き込むか、直接 modules/decisions.md を変更します。ユーザーの今回の要求が常に優先されます。
  • ライブラリを変更する:adapters/style-library.config.json を変更するか、FY_STYLE_LIBRARY_ROOT を設定するか、毎回 --root を渡します。コードを変更する必要はありません。
  • ライブラリ更新後:python scripts/style_library.py build --root <ライブルート> を実行し、次に python scripts/doctor.py を実行して確認します。
  • 自分のスキルディレクトリに配置する:ディレクトリ全体をコピーするだけで、ローカルの絶対パスには依存しません。341の本文は常にあなた自身のライブラリにあります。

関連スキル