Communitygithub.com

release-film

エージェントが「リリースフィルム」を計画、構築、またはカットする方法を示し、具体的な出力がショット単位で弁明可能な動画になるようにします。この手順は「リリースフィルム:何が変わったか、変化を見せる」から始まり、0 — このリリースにフィルムはあるか?、1 — 質問して待つ、と続きます。新しいアサインがこのクラフトを必要とするときに使用します。

release-film とは?

リリースフィルム(release-film)は、ソフトウェアリリースのUIや機能の変更点を、短い「what's new」動画として制作するためのAIエージェントスキルです。このスキルは、Claude CodeやCursorなどの開発ツールで動作し、指定されたリリースタグのソースコードから変更された画面をベクターで再現し、実際のカーソルとショートカットを使用してその場で変化する様子をアニメーション化します。主な目的は、リリースノート、ドキュメントページ、ニュースレター、ソーシャル投稿向けの動画クリップを生成することです。汎用的なプロモーション動画(site-promo-film)とは異なり、各リリースの差分に焦点を当て、最大3つの変更点をフィーチャーし、残りはチェンジログとして表示します。このスキルは、ユーザーが明示的にリリース動画の作成を依頼した場合のみ機能し、リリースプロセスの一部として自動提案されることはありません。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/gfazioli/manovella/tree/HEAD/plugins/manovella/skills/release-film

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

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

ドキュメント

リリースフィルム:何が変わったか、変化を見せる

プロモーションは製品を売るものですが、リリースフィルムは、製品をすでに知っている人々に向けて1つのリリースの差分を示すものです。同じエンジン、異なる役割:前の状態が重要であり、すべての主張はタグに紐づけられ、フィルムはシリーズの1エピソードです。

このスキルは、兄弟ディレクトリ ../site-promo-film/ にある site-promo-film を拡張します。最初にそのSKILL.mdを読んでください:方向性、ルック、禁止事項、ビルドルール、キャンバスの注意点、レンダリング前の静止画、レンダリングと検証はすべてそのまま適用されます。このファイルには、リリースが追加する内容のみが記載されています。

ファイル説明
template/release.htmlエンジンに加えて16秒のリリースデモ:バージョンカード → 以前のアプリ → ツールバーに新しいコントロールが現れてクリックされる(リストが並べ替えられ、行が浮き上がる) → キーキャップのショートカットで新しい画面が開く(パネルに展開するピル) → 残りのチェンジログ → ガラスメニューで更新パスがクリックされる → バージョンカードに戻る。1つのファイルからワイドとスクエアの両方のレイアウトに対応。各フィーチャー変更は独自のライトを持てます。
../site-promo-film/template/film.jsステージ(サブフレームごとのサブピクセルジッター:スロームーブで段差やちらつきなし)、アイコンとシンボル用のFILM.draw、長尺フィルム用のタイムライン、エフェクト。テンプレートが読み込みます。ファイル先頭とsite-promo-film §5にドキュメントがあります。
../site-promo-film/template/parts.jsベクターパーツ:ウィンドウ、ブラウザ、ターミナル、デバイス、キーキャップ、スイッチ、リング。
../site-promo-film/template/fx.jsルック — 背景、ライト、グレイン、ガラス、クリックリップル — プロモーションテンプレートと共有され、そちらにドキュメントがあります(§4)。
../site-promo-film/scripts/render.mjs、contact.mjs、beats.mjsレンダラー、コンタクトシート、サウンドトラックのビート(site-promo-film §7、The beat)。そのまま使用します:PAGE=release.html node render.mjs …。
../site-promo-film/scripts/clickcheck.mjsすべてのクリックが見えるか確認(§3b):カメラが静止し、カーソルが各ページのCLICKSで停止していること。node clickcheck.mjs release.html、誰も見られないクリックがあるとexit 1。
../site-promo-film/scripts/deliver.mjs完成したフィルムとそのカバーを専用フォルダに移動し、キットが安全になったらワークフォルダをゴミ箱に移動(site-promo-film §8)。

テンプレート(または製品のキット、§5)、film.js、parts.js、fx.js(および設定するフォントでtype.jsスタイルの見出し用のtype.js)と4つのスクリプトをワークフォルダのsrc/、~/Downloads/<product>-<version>-whats-new-work/src/(~/Downloadsがワークルート。設定で別途指定がない限り。site-promo-film、Studioセクション参照)にコピーし、そこでnpm i playwright-coreを実行します。デモは8ワーカー、16サブフレームで69秒、ディザールック(night)で171秒でレンダリングされます(ワイドで計測)。

? または help で呼び出された場合、または会話にリリースが明示されていない状態で何も指定せずに呼び出された場合:ガイドモード、../site-promo-film/guide.md。どのバージョンかを尋ね、ブリーフを進めます。このモードでは何もレンダリングされません。Studio(site-promo-film、Studio)もリリースブリーフを作成します:kind: release、release.tagにバージョン。§1の質問に答えます。

0 — このリリースにフィルムはあるか?

ユーザーがフィルムを依頼した後にのみ質問されます。リリースコマンドがこれを提起することはなく、ここから自発的に提案されることもありません。レンダリングはsite-promo-film §7のサーマルデフォルトに従います。

  • リストはタグから構築し、決して記憶から作成しない:git log --oneline <prev-tag>..<ref>、マージされたPR、ドラフトリリースノート。「これが含まれていると思う」から作られたフィルムは、スリップした機能や前のリリースの機能を示すことになります。
  • 人が見たり行ったりする何かが異なる状態で出荷される場合に該当します:新しい画面、新しいコントロール、リデザイン、新しいショートカット。修正、速度、内部処理は該当しません。その場合は1行で伝えて停止します。表示するものがないリリースのフィルムは、番号だけのタイトルカードになります。
  • 最大3つの変更をフィーチャーします。残りはチェンジログロールに、ノートからそのまま、またはどこにも入れません。5つのフィーチャー変更はそれぞれ3秒ずつになり、スライドショーになります。

1 — 質問して、待つ

最初に確認:製品の過去のフィルム(そのキット、§5)、プロジェクトのリリースメディアの保存場所に関する指示、およびそのデモモードまたはフィクスチャ。キットにもタグのソースにも保持されていないアセット(アイコンのマスター、ロゴのベクター)は、同じメッセージで要求され、決して作り上げられません(site-promo-film §1)。次に、1つのメッセージでそれぞれにデフォルトを付けて質問します:

  1. リリースとフィルム化するref(デフォルト:タグ。まだタグが打たれていない場合はmain、その後タグで再確認)。
  2. フィーチャー変更(デフォルト:ログからの私の選択、それぞれがなぜうまく表示されるかの1行)。
  3. 長さ(デフォルト:フィーチャー変更あたり約6~8秒+バージョンカードの約3秒、15~30秒。見るべきクリックがある場合はその2倍、§3b)。30秒以上でYouTubeにアップロードされるフィルムにはチャプターが付きます(§6)。それより短いものは付きません。YouTubeは3つのチャプターを要求し、最初は0:00、それぞれ最低10秒です。
  4. フォーマット:16:9マスター(デフォルト)、および2番目のレイアウトとしてスクエアカット。
  5. ルック(デフォルト:キットのもの。最初のフィルムの場合は、site-promo-film §4のように、実際のフレーム1枚のルックシート)。
  6. 保存先(デフォルト:<product>-<version>-whats-new/、site-promo-film §8の通りに配信。完成したフィルムとカバーのみを保持し、-workフォルダはワークルート(デフォルトでは~/Downloads)に残ります。プロジェクトの指示に特定の場所がある場合はその場所)。
  7. 音楽:デフォルトではなし。リリースクリップはミュートで自動再生されるため、テキストがすべてを伝えます。

その後、製品にキットがある場合はビートグリッド上に1つのストーリーボード(スタイルは確定しており、内容のみが選択肢)、これが最初のフィルムの場合は3つ。GOが出るまで待ちます。

2 — ソース:アプリ、指定されたref

  • ワーキングツリーではなく、refのコードを読む:git show <ref>:<path>。コードビューは文字列、シンボル、スペーシング、色を提供します。プロジェクトのスクリプト化されたスクリーンショット(デモモード、フィクスチャ)は比率を提供します。実際のデータが入ったキャプチャは決して使用しません。
  • 変更前の状態は前のタグのソースから取得します。記憶から再現すると、リリースが変更したまさにその詳細で間違っています。
  • 画面上のすべての文字列はrefに存在する:git grep -nF -- '<string>' <ref> はヒットする必要があります(UIテキスト、メニュー項目、キーキャップのショートカットについては、バインディングをgrepし、ドキュメントはgrepしません)。ソース言語でフィルムを作成します。
  • 見出しはリリースノートのベネフィット行、数語:PRタイトルではなく、リリースが行わないことは含みません。これらは公開された主張です。
  • デフォルトでオフになっている変更には、画面上にそのスイッチが必要です。そうでなければ、フィルムは視聴者が見つけられないものを宣伝することになります。

3 — ストーリーボードのパターン

  • バージョンカードで開いて閉じる:アイコン、名前、「X.Yの新機能」、アクセントカラーのバージョン。フレーム0かつ最後のフレームで、ループポイントの両側に約1.5秒。
  • その場で変更。画面を1ビートそのまま表示し、その上で変更を発生させます:ツールバーにコントロールが現れる、リストが並べ替えられる、パネルにセクションが追加される。before/afterラベルや分割画面はなし:トランジション自体が説明です。変更が着地するときにカメラをズームインし、使用されるときにズームアウトします。
  • 新しい画面はそれを開くものから成長する:クリック、メニュー項目、ショートカット。ショートカットは見出しスロットのキーキャップに表示され、画面が応答するビートで押されます。
  • 1つのフィーチャー変更、1つの見出し、1つのインタラクション。見出しは変更が着地するときに入り、それ以前ではありません:視聴者がそれを見てから、それが何であったかを読みます。
  • チャプターは独自の色を持てます。ライトのあるルックでは、ルックのkeysが各フィーチャー変更の着地時に色を変え、デモのようにバージョンカードのために最初の色に戻します。製品の色に意味がある場合(アカウント、状態)は省略します。
  • 残りのチェンジログは見出しスロットの短いロールとして、「X.Yでも」というラベルとノートからそのままの3~5行を1ビートごとに。残りに名前を付ける価値がある場合のみ。
  • 更新パスで閉じ、実際にクリックされる:製品自身の新しいバージョンへのルート(更新を確認…メニュー項目、ストアボタン、サイトのURL)。その後、UIはアイコンに折りたたまれます。メニューでは、ハイライトされた行はその瞬間にカーソルの下にあるもので、カーソル自身のトラックから計算されるため、行の上を通過すると実際のメニューのように点灯します。
  • プログレスバー、チャプターカウンター、「NEW」バッジはなし:見出しの変更がチャプターの区切りです。
  • その場で変更がフォーマットですが、唯一のものではありません。キットの最後のフィルムですでにそれを行っている場合は、バリエーションを加えます:ノートが説明する画面に開く、変更された画面を3D深度で、同じフレームでのbefore/after wipe、新しいフローのチュートリアル。site-promo-film §2にカタログがあります。リリースフィルムは1つを選び、ストーリーボードでそれを指定します。
  • メジャーリリースは長尺フィルムに対応できます(1~3分、フィーチャー変更ごとに1チャプター、ループなし)、site-promo-film §2bのタイムラインを使用し、ソーシャル投稿用の短いクリップと並行して。

3b — すべてのクリックが見える

リリースフィルムはほとんどがクリックであり、クリックは視聴者が着地を見なければならないビートです。30秒のカットは、動きが速すぎて一部のクリックが欠落している状態で再生されました。測定結果:2つのクリックがフレームが1255および1414 px/sで動いている間に落ち、ほとんどのクリックはターゲットから20~45ptの静止カーソルに着地しました。以下のルールに従って計時された60秒のカットでは、すべてのクリックが2 px/s未満かつ1 pt未満で測定されました。

  • カメラはクリックの前に到着している。フレーミングするクリックの少なくとも約1.3秒前からカメラの移動を開始し、UIが応答するまで移動しません。
  • カーソルは押す前に休止する:各移動に約2秒のスロースプリング(横f 0.85、縦0.75。短いホップはより速くても可)を与え、0.5秒間静止させます。
  • プレス中も留まり、見えるのに十分な時間押し続けます(ダウン0.05秒、アップ0.14秒後)、より大きなリングを伴います。次の移動はプレスの0.3秒後以降に開始します。
  • クリックで開くものは、クリックされたものを決して覆わない:パネルは項目の下からドロップダウン、ウィンドウは通知の横から成長、シートはボタンが押された0.15~0.2秒後に閉じます。最初の60秒マスターでは、シェルがプレスの瞬間にクリックされた項目の上に成長して隠してしまい、正確な時間の静止画ではそれが決して表示されず、mp4から抽出されたフレームも同様でした。
  • 確認:GOの前にnode clickcheck.mjs release.htmlを実行(クリックされたポイント上のカメラ、プレスの前と最中の移動を測定。両方のテンプレートがパスします)、レンダリング後はすべてのクリック時刻でmp4からフレームを抽出します(site-promo-film §7)。
  • iPhoneまたはiPadの場合(ブリーフのframe、site-promo-film §0)、クリックはタップです:矢印は描画されず、タップ中のみ指が表示されます(押すソフトディスク、ルックのリップル付き)。ページは依然としてCLICKSを宣言し、curX(t) / curY(t) は指の位置です。タップ間で次のタップポイントにジャンプし、各タップの前後でその位置に留まるため、clickcheck.mjsはタップをクリックとまったく同じように測定し、CLICKSのないページでもexit 2します。上記のルールは適用され、カメラはすべての上にあります。

4 — レイアウト:スロットと自由領域

テンプレートは手動調整ではなく、カメラを計算します。fit(rect, head) は、ワールド矩形を自由領域(ワイドでは見出しスロットの横、スクエアではその下、見出しがない場合はフレーム全体)に合わせるカメラを返し、zmaxで上限が設定されます。3つのルールは、デモの構築中に計測されました:

  • 見出しが表示されている場合、クローズアップはスロット側の画面の端まで戻る(toEdge)。詳細のみを合わせ、ウィンドウの残りは見出しの下にスライドし、見出しは半分がキャンバス上、半分が暗いウィンドウ上に配置されます。
  • スクエアでは、クローズアップは画面の全幅を維持する。そうしないと、行ラベルがフレームの両端で切れます。
  • 離れるタイトルは変形する形状の下に描画されるため、ウィンドウがその上に成長します。上に描画すると、そのフェードする文字が0.5秒間ウィンドウ全体に印刷されます。

2番目のアスペクト比は2番目のレイアウトであり、最初のレイアウトのクロップではありません。ページはlocation.hashを読み取り、PAGE='release.html#square'はrender.mjsにハッシュを渡します。ハッシュはルックも受け取り、&で結合します:PAGE='release.html#square&look=night'。

5 — キット:製品のすべてのフィルムは1つのショーのように見える

製品の最初のフィルム(またはそのサイトプロモーションフィルム)はキットを生成します:フォント、カラートークン、ベクターのアイコン、バージョンカード、ウィンドウクローム、カメラ言語、ルック(プリセットとオーバーライド:1行のFX.look)。製品と共に、その指示に従ってコミットします(指示がない場合は場所を提案、今のところscripts/film/)。ワークフォルダが破棄される前に行い、次のリリースがテンプレートではなくキットから始められるようにします:1つのストーリーボード、内容のみが変更され、シリーズが認識可能になります。バージョンカードでは番号のみが変わります。

キットが保持するのはページであり、エンジンではありません。 エンジンはスキルのものであり、すべてのフィルムで再度コピーされます。ページは成果物です:製品の画面をベクターで、すべての文字列はタグで取得、レビューラウンドを生き延びたタイミング、およびそれらのラウンドが教えたことのREADME(各モデルの能力の制限など)です。

…

[翻訳のため省略]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル