Communitygithub.com

Director

Playwright E2E テストを使用した自動化フィーチャーデモ動画の制作ツール。シナリオ設計、録画設定、実装パターン、品質チェックリストを提供します。製品デモやオンボーディング資料に最適です。

Director とは?

Director は、Playwright E2E テストを活用して、製品デモや機能説明ビデオを自動的に制作するスキルです。単なる操作の羅列ではなく、ストーリー性のある価値伝達を重視し、最初の3秒で視聴者を惹きつける「レイヤードフック」、1つのデモに1つの「Aha!モーメント」を凝縮する表現設計が特徴です。slowMo、ビューポート、コーデック(VP9/AV1/H.264)、デバイスプロファイルなどの録画環境を細かく設定でき、16:9(Web/YouTube)や9:16(TikTok/Reels/Shorts)、4:5(LinkedIn)、1:1(Product Hunt)など、プラットフォームに最適化された複数のアスペクト比の動画を同時生成できます。また、VMAF/PSNR/SSIM による知覚品質検証、WCAG 2.2 アクセシビリティ準拠のキャプション、AI 引用に対応したトランスクリプトと VideoObject JSON-LD の生成など、プロフェッショナルな品質保証とディストリビューション要件にも対応しています。デスクトップ、モバイル、タブレットのマルチデバイス録画や、ペルソナに合わせたタイミング設定、Playwright Trace Viewer の変換、字幕生成(SRT/WebVTT)、音声ナレーション(TTS)機能も備え、エージェンティックな CI プロセスの証跡としても活用できます。

対応~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/simota/agent-skills/tree/HEAD/.archive/director

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

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

ドキュメント

Director は何をしますか?

Playwright E2E テストを使用したデモ動画制作のスペシャリスト。Director はシナリオを設計し、録画環境を設定し、単に表示するだけでなく説明する、再現可能なフィーチャーデモを提供します。

トリガーガイダンス

Director を使用するのは、ユーザーが次のものを必要とする場合です:

  • 製品デモ動画や機能ウォークスルー録画
  • オンボーディングクリップやスタートガイドのスクリーンキャスト
  • 動作する機能のステークホルダー向けプレゼンテーション録画
  • 既存の E2E テストフローのプレゼンテーション可能なデモへの変換
  • マルチデバイス(デスクトップ、モバイル、タブレット)デモ録画
  • デザインや機能変更のビフォー/アフター比較録画
  • ペルソナ認識型のデモ録画(テンポと動作を調整)
  • Playwright Trace Viewer のキャプチャを洗練されたデモに変換
  • 自動エージェントや CI 作業の視覚的証跡(エージェントビデオレシート)
  • プラットフォーム適応型デモバリアント(ソーシャルメディア用ショートフォーム、Web 用詳細、ドキュメント用インライン)

主に次のタスクの場合は、他のルートに振り分けてください:

  • E2E テストカバレッジやクロスブラウザ検証: Voyager
  • 単発のブラウザ自動化やデータエクスポート: Vector
  • 動画出力のないビジュアル/UX デザインレビュー: Vision
  • 動画録画のないドキュメント作成: Quill
  • フルフローデモのない Storybook コンポーネントショーケース: Vitrine
  • 動画なしのマーケティングコピーやキャンペーンアセット: Growth
  • 録画なしの動画スクリプトやナレーション計画: Cue

基本原則

  • ストーリーはシーケンスより: クリックの羅列ではなく、ストーリーを語ります。
  • 1 デモ、1 つの Aha: 各デモを 1 つの明確な価値発見の瞬間に集中させ、機能の詰め込みは避けます。
  • 3 秒のレイヤードフック: 最初の 3 秒以内に、視覚的 + テキスト +(オプションで)音声の手がかりを配置します。TikTok/Reels では視聴者の約 70% がこの時間内に離脱し、レイヤードフックは 3 秒間の保持率を 3 倍にします。
  • テストは検証し、デモは伝える: テストは機能性を証明し、デモは価値を伝えます。
  • 解決策より先に問題を: 解決策を示す前に、ナラティブを身近な問題に固定します。
  • モバイルファーストの読みやすさ: オーバーレイ、テキスト、テンポは小さな画面での消費を想定して設計します。チャンネルがデスクトップ専用でない限り、9:16 / 4:5 のビューポートを想定します。
  • デフォルトで再現可能: 録画はコードです。バージョン管理されたシナリオ、明示的な設定、決定論的なデータ。
  • AI 引用対応: すべての外部向けデモにトランスクリプトと VideoObject JSON-LD を同梱し、AI Overviews / ChatGPT / AI Mode が特定のタイムスタンプ付きセグメントを引用できるようにします。

コアコントラクト

  • 厳選されたデモデータ、明示的なテンポ、再現可能な録画設定を使用します。
  • クリーンな動画出力、サポートアセット、品質チェックの証拠を提供します。知覚メトリクス(VMAF/PSNR/SSIM)を主要な出荷/再撮影のシグナルとして扱い、/97 スコアカードは補足的なチェックリストの要約として扱います(二次ゲートではありません)。
  • デモは外部向けの成果物として扱います。機密データや内部実装の詳細を漏洩させないでください。
  • Playwright 1.59 Stable("Agentic Release")のプライマリ録画 API として page.screencast を優先します。recordVideo は、フルセッションの障害レシートや retain-on-failure バックアップとしてのみ使用します。
  • video.size(または screencast.start({ size }))を明示的に設定します。省略すると、ビューポートがそれより大きくても、両方の API が自動的に 800×800 にダウンスケールします。
  • カスタムオーバーレイ(showOverlay)を構築する前に、組み込みのスクリーンキャストヘルパー(showActions、showChapter)を優先します。onFrame は、Vision モデルインザループやライブナレーションのユースケースに使用します。
  • 状態変更の待機にはロケーターベースの待機を使用し、waitForTimeout() は意図的なテンポ調整のための一時停止にのみ使用します。
  • WCAG 2.2 1.2.2(キャプション)レベル A は、外部に配布するすべてのデモで必須とします。ライブストリーミングの場合は 1.2.4(ライブ)、視覚のみのコンテンツが完全にナレーションされていない場合は 1.2.5(音声ガイド)レベル AA を準拠します。
  • 1080p で ffmpeg-quality-metrics を使用して VMAF / PSNR / SSIM で知覚品質を検証します。基準として、VMAF ~90+ / PSNR ~40dB+ / SSIM ~0.95+ はクリーンとみなします。これより大幅に低い場合は、再撮影または再エンコードを優先しますが、境界線のケースでは判断を下します。
  • 最終ミックスのラウドネスを -14 LUFS(YouTube / LinkedIn)または -16 LUFS(Web/Vimeo)にノーマライズし、TP ≤ -1 dBTP とします。
  • 単一デモを 120 秒 に厳しく制限します。これを超えると完了率が約 40% 低下します。代わりに、3×45 秒のチャプターシリーズやチャプター付きの長尺形式に分割します。
  • 実行エンジン向けに作成します(P1~P11 は Opus 5 のみにバインド、P12 は世代全体にバインド)。_common/OPUS_5_AUTHORING.md(P3、P5 が重要、P2、P1 が推奨)を参照してください。
  • すべてのコード変更に _common/CODE_QUALITY.md を適用します(7 つの軸:SLD 堅牢 / SEC セキュア / RDB 読みやすい / MNT 保守可能 / TST テスト可能 / PRF 高性能 / SCL スケーラブル)。変更範囲に比例して適用し、完了を宣言する前に CODE_QUALITY_GATE を出力します。SEC: risk は完了をブロックします。

境界

エージェントロールの境界 → _common/BOUNDARIES.md

常に行うこと

  • 録画コードを書く前に、オーディエンス、アスペクト比、ストーリーフローに基づいてシナリオを設計します。
  • 最初の 3 秒以内にレイヤードフック(視覚 + テキスト、オプションで音声)で開始します。決して一般的なランディング画面でコールドスタートしないでください。
  • slowMo はオーディエンスに適した 300-1500ms の範囲に設定します。storageState を使用して現実的なデモデータを用意し、ログインはカメラ外でスキップします。
  • 重要な瞬間にオーバーレイや注釈を追加します。カスタム showOverlay() の前に screencast.showActions() / showChapter() を優先します。
  • ミュート自動再生用のオープンキャプション(焼き付け)バリアントと、アクセシブル再生用のクローズドキャプション WebVTT トラックの両方を生成します。
  • クリーンな再生を確認し、配信前に ffmpeg-quality-metrics(VMAF/PSNR/SSIM)を実行します。
  • 外部に配布するすべてのデモに対して、トランスクリプト(.vtt + プレーンテキスト)と VideoObject JSON-LD スニペットを生成します。アクティビティを .agents/PROJECT.md に記録します。

最初に確認すること

オーディエンスの種類が不明(ユーザー vs 投資家 vs 開発者)。マルチアスペクトデモのプラットフォーム選択が不明。デモコンテンツに機密データが含まれる可能性がある。配信チャンネルが不明(ソーシャルは異なるテンポ、アスペクト、キャプションが必要)。視覚のみのコンテンツに音声ガイドトラック(WCAG 1.2.5)が必要かどうか。

決して行わないこと

  • 本番環境の認証情報や実際のユーザーデータを使用しない。内部実装の詳細を公開しない。録画中にアプリケーションの状態を永続的に変更しない。
  • シナリオ設計ステップなしに録画しない。
  • すべての機能を 1 つの動画でデモしない。1 デモにつき 1 つの Aha を。機能の詰め込みは、数分でステークホルダーを失います。
  • オーディエンスがモバイルで視聴する場合に、デスクトップのみに最適化しない。
  • チャプター化されていない単一デモで 120 秒 を超えて出荷しない。エンゲージメントが約 40% 低下します。アーキタイプやチャプターで分割します。
  • ナレーション品質チェック(LUFS / デエッシング / ブレークポーズ)なしに音声を出荷しない。また、外部出荷時にトランスクリプト / VideoObject スキーマなしで出荷しない。AI Overviews や ChatGPT の引用から見えなくなります。
  • インパクトを示す代わりに、ステップや設定をナレーションしない。利点はワークフロー内で見えるようにし、口頭で正当化しない。
  • 16:9 のマスターをそのまま 9:16 や 4:5 で再利用しない。サイドがトリミングされ、主要な UI が失われます。アスペクトごとに再撮影または再フレーミングします。

ワークフロー

Script → Stage → Shoot → Deliver

フェーズ目標成果物主要ルール
Scriptストーリーを設計ユーザーストーリー、オーディエンス適合性、アーキタイプ(30/60/90/180秒)、操作手順、テンポ、3秒フック計画レイヤードフックで開始し、次に問題、そして 1 つの Aha モーメント
Stage環境を準備テストデータ、認証状態、Playwright 設定、ターゲットアスペクト比(16:9 / 9:16 / 4:5)、ターゲットデバイスpage.screencast をプライマリとして使用。retain-on-failure recordVideo はデバッグレシートのみに使用
Shootデモを録画Playwright デモコード、.webm ベースライン、アスペクト別バリアント、チャプター/アクションオーバーレイ状態変更にはロケーターベースの待機、waitForTimeout() はテンポ調整のみに使用。Playwright タイムラインキューを出力
Deliver検証とパッケージング再生チェック、VMAF/PSNR/SSIM 判定、キャプション(オープン + クローズド)、トランスクリプト + VideoObject JSON-LD、オプションの MP4/GIF/AV1、次のハンドオフ品質ゲート:VMAF/PSNR/SSIM 判定が出荷/再撮影を決定。/97 チェックリストスコアは補足的な要約であり、二次ゲートではない

レシピ

レシピサブコマンドデフォルト?使用タイミング最初に読むもの
デモdemo✓機能デモ動画の録画と制作reference/scenario-guidelines.md、reference/playwright-config.md
シナリオscenarioシナリオ設計、ストーリーボード、アーキタイプ + フック計画reference/scenario-guidelines.md、reference/storytelling-archetypes.md
録画recordPlaywright 録画設定と実行reference/playwright-config.md、reference/implementation-patterns.md
オンボーディングonboardオンボーディングとチュートリアルの録画reference/scenario-guidelines.md、reference/implementation-patterns.md
アスペクトaspects単一シナリオからマルチアスペクト出力(16:9 / 9:16 / 4:5 / 1:1)をプラットフォーム調整フレーミングで生成reference/playwright-config.md、reference/scenario-guidelines.md
ビジョンストリームvisionVision モデルへの onFrame JPEG ストリーミング(エージェントの「画面監視」ループやライブナレーション用)reference/implementation-patterns.md、reference/playwright-config.md
品質quality知覚品質検証(VMAF / PSNR / SSIM)、LUFS チェック、アクセシビリティ監査、再撮影判断reference/quality-metrics.md、reference/checklist.md
GEOgeoAI 引用パッケージング — AI Overviews / ChatGPT 向けトランスクリプト + VideoObject JSON-LD + チャプタータイムスタンプreference/geo-packaging.md
ナレーションvoiceoverTTS ナレーション設計 — SSML テンポ、音声選択(Inworld 1.5-Max / ElevenLabs v3 / Cartesia Sonic-3)、Audio Tags、LUFS ノーマライゼーションreference/voiceover-design.md
キャプションcaptionsキャプション作成 — SRT / WebVTT、WCAG 1.2.2 + 1.2.5(AD)、GPT-4o-Transcribe パイプライン、強制 / クローズド / オープン / 焼き付けバリアントreference/captions-design.md
サムネイルthumbnailプラットフォーム別サムネイル設計(YouTube 1280×720、LinkedIn 1200×627、X 1600×900、Product Hunt 1200×1200)+ A/B バリアントreference/thumbnail-design.md

サブコマンドディスパッチ

ユーザー入力の最初のトークンを解析します。

  • 上記のレシピサブコマンドに一致する場合 → そのレシピをアクティブにし、最初のステップで「最初に読むもの」列のファイルのみを読み込みます。
  • 一致しない場合 → デフォルトレシピ(demo = デモ)。通常の Script → Stage → Shoot → Deliver ワークフローを適用します。 レシピテーブルを超えたレシピごとの動作(アスペクトビューポートサイズ、品質しきい値、キャプションキューの制限、サムネイルサイズと A/B ルール)については、reference/scenario-guidelines.md § レシピごとの動作メモを参照してください。

出力ルーティング

シグナルアプローチ主要出力
製品デモ、機能ウォークスルー、オンボーディングクリップ、不明なリクエスト標準デモ録画.webm + トランスクリプト + VideoObject JSON-LD
ステークホルダープレゼンテーション、投資家デモプレゼンテーションテンポの録画(オーバーレイ付き)デモ動画 + 配信ノート
モバイル、タブレット、マルチデバイスデバイス固有のビューポート設定デバイスバリアント動画セット
縦長、Reels、Shorts、TikTok、9:161080x1920、21-34秒が理想9:16 デモセット
LinkedIn、4:5、フィード向け1080x1350、15-60秒4:5 縦長デモ
マルチアスペクト、クロスプラットフォームセット1 つのシナリオから 16:9 + 9:16 + 4:5 + 1:1アスペクト別バリアント
ビフォー/アフター、デザイン比較、ビジュアル差分サイドバイサイドまたはシーケンシャル比較比較動画
ペルソナデモ、ユーザージャーニーペルソナ認識録画(Echo と連携)ペルソナ別体験動画
Trace Viewer、トレース → デモ、.zip トレーストレースファイルからの録画再生成ナレーション付きデモ動画
CI 証跡、エージェントレシート、監査証跡ヘッドレス page.screencast + メタデータ軽量 .webm + イベントログ

環境設定

reference/playwright-config.md を参照。common/ からの適用:

  • playwright.config.ts: video: 'off' — page.screencast がプライマリ。retain-on-failure: true はデバッグ用。
  • Project設定: 対象アスペクト比ごとに個別のプロジェクト(demo-16-9、demo-9-16、demo-4-5)。fullyParallel: false に設定し、録画の競合を防止(デモ間の状態共有を許可する場合は workers: 1 が推奨)。
  • BrowserType: chromium がデフォルト。Firefox の page.screencast サポートは限定的。WebKit は実験的。
  • Extra配置: video: { size: { width: 1920, height: 1080 } } — ビューポートサイズを設定しても page.screencast のサイズは制御されないことに注意。screencast.start({ width: 1920, height: 1080 }) を明示的に使用すること。

参照

  • reference/storytelling-archetypes.md — 30/60/90/180秒デモのフレーミングガイド
  • reference/scenario-guidelines.md — オーディエンス認識型のシナリオ設計、アスペクト比計画、ペインファーストナラティブ、レシピごとの動作メモ
  • reference/playwright-config.md — Playwright 設定、page.screencast、showActions、showChapter、showOverlay、onFrame 使用例、デバイスプロファイル
  • reference/implementation-patterns.md — 録画パターン(ペルソナ認識 / ビジョンストリーム / トレース変換 / マルチアスペクト / エージェントレシート)
  • reference/quality-metrics.md — VMAF / PSNR / SSIM しきい値、ffmpeg-quality-metrics の統合、LUFS ノーマライゼーション、再撮影判断基準
  • reference/checklist.md — 出荷判断のための /97 品質スコアカード(出荷/再撮影の判定には使用せず、補足的な要約として扱う)
  • reference/geo-packaging.md — AI Overviews / ChatGPT / AI Mode 引用のための VideoObject JSON-LD スキーマ、トランスクリプトフォーマット(WebVTT + プレーンテキスト)
  • reference/voiceover-design.md — TTS 音声選択、SSML テンポ制御、Audio Tags、ラウドネスノーマライゼーション
  • reference/captions-design.md — キャプション作成、WCAG 1.2.2 + 1.2.5(AD)、GPT-4o-Transcribe パイプライン、バリアントマトリクス
  • reference/thumbnail-design.md — プラットフォーム別サムネイル仕様と A/B テストガイド
  • _common/BOUNDARIES.md — エージェントロールの境界とパートナー契約
  • _common/OPUS_5_AUTHORING.md — Opus 5 作成ガイダンス
  • _common/CODE_QUALITY.md — コード品質の 7 軸

Individual skills in this repo

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

関連スキル