Communitygithub.com

デモビデオ

ソフトウェア作業に関する、証拠を優先した短いビデオを計画・作成します。1つの変更の完了ビデオ、スプリントデモ、「これまでのあらすじ」、研究結果、リリース、コンセプト映像、チュートリアル、バグ再現などに対応する青写真です。

デモビデオ とは?

これは、ソフトウェア開発作業の完了を伝えるための、証拠第一主義のビデオ作成手法を定義したスキルです。「make a done video」、「sprint demo video」、「previously on」、「recap video」などのプロンプトで利用できます。計画立案からレビューまでのワークフローを、証拠テーブル、ストーリーボード、ブランディング、レビューといった要素に分解して提供します。このスキルは特定のレンダラーやツールに依存せず、あらゆるHTML-to-videoレンダラー(HyperFrames、Remotion、Motion Canvasなど)と連携可能なブループリントとして設計されています。重要なのは、アートよりも証拠を優先し、実際のUI、実際の出力、実際のソースページを表示することです。すべての映像は、モバイルで読みやすく、結果が詳細の前に伝わるようにタイミングが調整されなければなりません。このスキルは、ビデオの公開やアップロードを自動的に行うものではなく、明示的な権限が必要です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jernejk/jkstack/tree/HEAD/blueprints/demo-video

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

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

ドキュメント

デモビデオ は何をしますか?

ここでのビデオは、第一に証拠であり、第二に映像作品です。すべてのフレームは、何か本物のものを表示し、それが何であるかをラベル付けし、スマートフォンで読み取り可能であり、詳細が伝わる前に結果が届くようにタイミングが調整されています。

これはブループリントであり、インストール可能なスキルではありません。実際の映像作品を生み出してきた手法を説明していますが、レンダラー、レコーダー、チェッカーはバンドルされていません。お手持ちのツールを使用してください。拡張機能では、構築する価値のあるツールについて説明しています。参照パスは、このスキルフォルダからの相対パスで解決してください。

1. モードを選び、ブリーフを書く

モード使用目的長さ構成
done1つのマージされた変更またはバグ修正15~30秒イントロカード → 実際のUIでの変更 → 課題またはPRを含むエンドカード
sprint-demoステークホルダー向けスプリントレビュー2~4分スプリントゴール → 3~5の完了したビート(最も価値の高いものから) → 未完了 → 次へ
previously-on進行中のプロジェクトのエピソード1~3分最後の未解決スレッド → 各パート:質問 → 結果 → 変更点 → 次のスレッド
research実験、スパイク、リサーチナイト1~2.5分質問 → 1枚の画像で示す方法 → 分母付きの結果 → 驚き → 決定
release出荷されたものと次の予定1~2.5分マージ済み→リリース済み→ステージング→本番の状態を反映した要約形式
conceptフィーチャーフィルム、モックアップ、提案45~95秒結果で惹きつける → 1つの実例 → 証明 → 正直な限界 → 見返り
walkthrough1つのタスクの実行方法30~90秒完了した結果 → 実際のUIでの手順 → 再度完了した結果
reproバグ報告10~30秒環境 → 手順 → 保持された障害 → テキストでの期待結果

モードごとの詳細: modes。レトロスペクティブ、記念日、別れのビデオは、拡張機能のジャーニー拡張機能です。

キャプチャを開始する前に、フィルムフォルダにBRIEF.mdを作成してください。モード、視聴者、1つの要点、表示幅(デフォルト:スマートフォン、844px 横向き、390px 縦向きプレーヤー)、ブランドプロファイル、各シーンの証拠クラス、締め切り、出力物を含めます。リクエストやソースから推測できないことのみを尋ねてください。

2. 絶対条件

  • アートよりも証拠を優先する。 実際のUI、実際に保存された出力、実際のソースページを表示します。実際には発生しなかった状態を描いたり、数値をでっち上げたり、速度、リリース、本番運用を暗示したりしないでください。画面上のすべての事実は、そのシーンが構築される前に、クレームテーブルに行を持ちます(エビデンス)。
  • 画面上に、常に、何であるかをラベル付けする。 カメラの外側にあるレールは、証拠クラスを示します。Local build、Concept demo · sample data、Recorded answer · replayed、Staging、Production。コンセプトやモックアップが、出荷された機能と間違われることは決してあってはなりません。
  • 結果を先に表示する。 要点と1つの主要な数値または目に見える結果は、シーン開始から約1.5秒以内に表示され、カットまで留まります。シーンの長さ ≥ 1秒 + 単語数 ÷ 3 + 1.5秒の保持(ペーシング)。
  • スマートフォンで読み取れるようにする。 1080pで主要テキスト ≥ 80px。視聴者が読む必要のあるものはすべて ≥ 36px。単語が多すぎる場合は、単語を削減するか再構成し、決して縮小しないでください。
  • シャープなUI。 証拠は2倍密度でキャプチャし、1.0以上のスケールで表示するか、拡大して表示します。高密度の1080p画面をアップスケールして、それをクローズアップと呼ぶことは決してしないでください。
  • 承認されたブランドのみ。 個人または会社のブランディングは、ブランドプロファイルとそのブランドの承認されたアセットから取得します(ブランディング)。ロゴを再描画、色変更、近似することは決してしないでください。
  • ライセンスされたサウンド。 音楽と効果音には、検証済みのライセンスと、それが必要とするクレジットが必要です。
  • 完了とは検証されたことを意味する。 技術的なチェック、検査済みフレーム、再生速度での再生、リスニングをそれぞれ報告してください。リクエスターの承認は、それ自体が1つの状態です(レビュー)。

3. ワークループ

  1. ブリーフとクレーム。 BRIEF.mdとクレームテーブル。数値を含む映像の場合、完全なレンダリングの前に、スクリーンショット内のテキストを含む最終的な画面上のテキストを、独立したレビュアー(理想的には異なるモデルファミリーまたは人間)にチェックしてもらいます。
  2. 言葉によるストーリーボード。 シーンごとに1行:時間枠、主要なセリフ、画像、証拠ラベル、音の合図、次のシーンへのつなぎ方。映像が使用する3~5種類のトランジションと、それぞれを引き起こすものを選択します。
  3. キャプチャ(capture)。インタラクティブな映像のためのスクリプト化されたブラウザフロー、ページ自身のアニメーションのための疑似クロックフレームキャプチャ、静止画のための2倍要素スクリーンショット。
  4. コンポーズ(composer)。短いモードはスペック駆動のコンポーザーに適しています。長いモードは、シーンがバーグリッド上にある一時停止されたタイムライン上での手動構築のコンポジションに適しています。
  5. レンダリング前に確認。 すべてのシーンの最初の読み取り可能な瞬間、中間点、後半の保持、および各カットの両側をスナップショットします。衝突、クリップされたテキスト、空のフレーム、および他人が読めないものを修正します。
  6. レンダリング、ミックス、検証。 レンダリング、エンコード、音楽と効果音のミックス、技術チェックの実施、その後、コンタクトシート、カットストリップ、フォンシートを自分自身で読みます(モーションとサウンド)。
  7. 納品。 無音版、音楽版、ウェブ版、ポスター、プレーヤーの横に配置する音楽クレジット、およびREVIEW.md:測定されたもの、目視のみで確認されたもの、最も弱いショット。

4. ツールチェーン

フレームを決定的に生成するレンダラーであればどれでも構いません。HyperFrames(Apache-2.0)とFFmpegにパイプされたフレームキャプチャスクリプトは、HTMLコンポジションを直接レンダリングします。Remotion(React; 最初に会社のライセンス条項を確認)とMotion Canvas(TypeScriptシーン)は、独自のシーンモデルを持っています。composerのコンポジションコントラクトがそれらに変換されます。Playwrightなどのブラウザ自動化ツールがキャプチャを駆動します。FFmpegがエンコード、ミックス、測定を行います。レンダラーのバージョンを固定し、提供されている場合はテレメトリをオフにしてください。

5. 権限

映像を作成することは、ローカルでのキャプチャ、コンポジション、検証を許可します。アップロード、メッセージ、PRまたはイシューへのコメント、プロダクトの変更、公開は許可しません。サンプルデータまたは承認された架空のデータを使用してください。クライアント、顧客、スタッフの名前を承認なく表示したり、ログイン中のIDを拡大表示したりしないでください。

リファレンス

必要な情報参照先
モードプロファイルとストーリー構成modes
クレーム、ラベル、ステータス状態、ファクトチェックevidence
読了時間、テキストサイズ、スマートフォン幅pacing and phone
モーション、トランジション、音楽、効果音motion and sound
個人および会社のブランドプロファイルbranding
キャプチャテクニックと落とし穴capture
Doneビデオのスペックとコンポジションコントラクトcomposer
レビューステージと納品の提案review and delivery
レコーダー、チェッカー、タイムラインからの要約、ジャーニー映像extensions

関連スキル