DemoDay は何をしますか?
リポジトリ(GitHubまたはローカルフォルダ)とそのライブWebアプリまたはネイティブmacOSアプリを、45~75秒の1080pデモ動画に変換します。まるでアプリのデザイナー自身が作成したかのような見た目に仕上がります。このツールは、このスキルに同梱されているNode/TS CLIです。あなたはディレクターです。ストーリーボード(plan.json)を作成し、ツールがそれを録画しレンダリングします。APIキーは不要です。
0. ツール(TOOL)を見つけてセットアップする
TOOL は、このスキルのベースディレクトリです(これに package.json が含まれている場合。通常のインストール:リポジトリ全体が ~/.claude/skills/demoday にクローンされます)。そうでない場合は ~/demoday です。どちらも存在しない場合は、処理を停止し、ユーザーをREADMEのインストール手順に誘導してください。
マシンでの初回実行時(TOOL/node_modules がない場合):
node --versionを確認します(バージョン20以上が必要)。不足している場合は、Node.jsをインストールするようユーザーに伝え(brew install nodeまたは nodejs.org)、停止します。TOOLでnpm install && npx playwright install chromiumを実行します。約300MBダウンロードされるので、開始前にユーザーに伝えてください。- Macアプリの場合、
xcrun swiftc --versionも確認します。不足している場合は、xcode-select --installを実行するようユーザーに依頼します。ヘルパーは初回使用時に自動コンパイルされます。
以下のすべてのコマンドは TOOL から実行します。OUT = out/<owner>__<repo> (ツールによって表示されます)。動画は TOOL/out/ 内に保存されるので、ユーザーにフルパスを伝えてください。
1. 情報収集
npx tsx src/cli.ts <owner/repo または github url> [--url <live app url>] --prepare
ライブのWebURLが必要です(--url、指定がない場合はリポジトリのホームページ)。またはネイティブmacOSアプリの場合は、下記「ネイティブMacアプリ」を参照してください。このコマンドはリポジトリを読み取り、アプリを調査し、以下をOUTに書き込みます:
prompt.md(ディレクタールール + README + マニフェスト + ファイルツリー + アクセシビリティスナップショット)、probe.png(最初の画面のスクリーンショット)、probe.aria.yml。
prompt.md を読み、probe.png を確認します。src/schema.ts を読んでください。これは plan.json の正確な形状であり、そのフィールドの説明はルール(単語数制限、各ビートがすべきこと)です。
2. 何かを書く前にストーリーを見つける
動画の成否は、現状の何が悪いのかとこの製品の何が特別なのかという2点にかかっています。
- 現状:ターゲットユーザーが今日この製品なしで行っている具体的なワークフローと、ステップごとの正直な時間コスト。名前付き競合他社については公平な主張のみ。
- 特別:これを可能にしているメカニズム(README/コードから)。形容詞ではありません。「Xだけが…」。
- READMEで過小評価されている機能をコードで確認する:常駐デスクトップアイコンやメニューバーアイコン、グローバルホットキー、オフライン/ローカルストレージ、マスコットなど。これらはしばしば真の差別化要因です。動画に入れる前に、主張するすべての機能をコードで確認してください。
- ユーザーがポジショニング、競合他社、差別化要因を教えてくれた場合は、それを使用します。何が違うのかを明らかにするものが何もない場合は、計画を書く前に短い質問を1つしてください。
3. アプリのスタイルに合わせる(必須)
動画はアプリの一部のように見える必要があります。同じ色、同じフォント、同じマスコットやアイコン、同じトーンです。居心地の良いパステル調のアプリに汎用的なダーク起動テンプレート(またはその逆)は、ブランドから外れていると見なされます。ユーザーはすぐに気づきます。
- コードからアプリのデザイントークンを抽出する:
- SwiftUI/AppKit:
Theme.swift形式のファイル、Assets.xcassets/*.colorset、Color(hex:)呼び出し。 - Web: CSSカスタムプロパティ、
tailwind.config.*、テーマファイル、<meta name="theme-color">。 - 収集するもの:背景、テキスト、カード/パネル、アクセント、および表示/本文フォント。
- フォント: リポジトリにバンドルされているフォントファイルを優先します(
Resources/Fonts/*.ttf、public/fonts、@font-faceソース、next/font/local)。 - マスコット/アイコン: スプライト、アプリアイコン(
AppIcon.icns→sips -s format png … --out icon.png)、またはロゴSVG/favicon。
- SwiftUI/AppKit:
- カテゴリではなく、アプリのUIからムードを選ぶ。UIが明るく、暖かく、遊び心があり、またはミニマルな場合は
mood: "soft"を使用します。アプリ自体がダーク、テクニカル、またはハイコントラストな場合はbold(デフォルトのダーク起動テンプレート)を使用します。 plan.lookを記入する:"look": { "mood": "soft", "paper": "<app bg>", "ink": "<app text>", "surface": "<app card>", "fontFile": "<repo font file>", "bodyFontFile": "<optional>", "motifImage": "<app icon/mascot png/svg>" }product.accentをアプリのアクセントに設定し、paper上で読みやすい色合いにします。ライトモードのアクセントは通常、ソフト向けに適切です。- ミュートされたテキストと線は
paper/inkから自動的に導出されます。 - フォントファイルがない場合は、
display(Inter Tight、Pixelify Sans、Fredoka、Nunito)を使用します。別のGoogleフォントをサポートするには、DISPLAYをremotion/lib.tsとスキーマのenumに追加します。 motif: "loaf"は組み込みのピクセルローフスプライトです(ベーカリーアプリのみ)。それ以外の場合はmotifImageを使用します。- CLIはこれらのファイルを
OUT/brand/にコピーします。パスは絶対パスまたはローカルリポジトリへの相対パスにできます。
- 声を合わせる:キャプションや見出しには、アプリ自身のマイクロコピーとメタファーを借用します(例:ベーカリーアプリの「dough / rising / baked」)。
- デフォルトでミニマルに:
- コピー予算:フック8語以内、古い方法のステップは約3、比較行は3、キャプションは2~5語、必須以外のラベルや統計はなし。
- 単語が多すぎることと、派手な赤い警告スタイルが最も多い不満でした。ソフトな外観はすでにカウンター、ペインラベル、シェイク、スタンプを省略しています。
4. OUT/plan.json を書く
prompt.md の先頭にあるディレクタールールに従ってください。録画ルール(newWay.actions):
- コアループ全体をカバーする。一つの結果への最短パスだけではありません。ユーザーは見出しとなる機能が欠けていると気づきます。10~20アクション(最大20)を目標に、各機能に独自のキャプション付きビートを設定し、古い方法と同じ仕事を行い、ペイオフで終わるようにします。Webの場合:最初のアクションはライブURLへの
gotoです。 - ほぼすべてのアクションにキャプションを付ける。 キャプションのないビートは、ミュートされた視聴者には無音の時間と読まれます。
- カメラ:各アクションのターゲットボックスに押し込まれます。ターゲット指定のない
fill/pressアクションは、フォーカスがあるフィールドを狙います。レコーダーはキー送信後にその位置をログに記録し、タイピングショットはテキストの開始位置に2倍ズームします。キャプションはウィンドウの下の独自のバンドに配置され、アプリを覆い隠すことはありません。ショットが間違ったものをフレーミングしている場合は、ターゲットを修正してください。ボックスを手動編集しないでください。 - セレクタはスナップショットから取得します。
{role, name}をそのままコピーして使用することを推奨します(macOS:id、次にplaceholder、次にrole+name)。コードエディタ内の非表示の入力は問題ありません。レコーダーはその表示可能なコンテナをクリックします。 - より深い画面のスクリプトは、推測ではなく実際のスナップショットから作成する:
- そこに移動し、存在しない
idのクリックで終了する使い捨てスクリプトを作成します。 - 実行します:
mac/.build/macdriver run --app X.app --out <scratch> --script s.json -- --demo <scratch>/data。ファイルは{"actions":[…]}です。Webの場合:--from planを実行します。 <scratch>/events.jsonのfailures[].ariaを読みます。
- そこに移動し、存在しない
- タイピング:80文字を超える
fill値はペーストされます。それより短いものは可視タイピングされます。現実的なデータを使用し、「test」は決して使用しないでください。新しいフィールドをクリックした直後にキーストロークが失われる場合(タイトルの切り詰め、空のフィールド、後続のクリックでテキストが見つからないなど)、分割します:フィールドをclickし、wait500してから、ターゲット指定なしのfillを行います。 - ペイオフ:正確に1つのアクションに
emphasis: trueを設定します。それをトリガーするクリックの直後、クリック自体ではなく、キャプション付きの最終wait(~2000ms)に配置します。カメラは引きで結果全体を示し、強調待機はリアルタイムで再生されます。その他の長い待機は早送りされます。 - ランチャービート:アプリが常駐アイコン(デスクトップ、メニューバー)またはグローバルホットキーの背後に存在する場合、
plan.launcherを設定します(captions、オプションのhint(ホットキーなど)、オプションのbadge)。- 動画はウォークスルーの前にビートを取得します:アイコンがぼやけたウィンドウの中で静かなデスクトップ上に座り、カーソルがそれをクリックし、実際のウィンドウがそこから成長し、ウォークスルーが開始される場所に正確に着地します。
- Remotionで合成され(レコーダーはアプリウィンドウのみをキャプチャ)、アイコンとして
motifImage/motifを使用します。コードが動作を確認した場合にのみ使用してください。
5. 録画 + レンダリング
npx tsx src/cli.ts <repo> --plan OUT/plan.json --from plan
ログを監視します:アクションごとに ✓、失敗は ✗ とエラー。失敗した場合、OUT/events.json → failures[](各失敗には失敗した瞬間のアクセシビリティスナップショットが含まれます)を読み、ターゲットを修正して再実行します。失敗したアクションはスキップされ、致命的ではありません。ペイオフが失敗した動画を出荷しないでください。初期のアクションが失敗した場合、後続のすべては通常、間違った画面で実行されます:録画全体を不良として扱い、raw.mp4 のフレームを確認して実際に何が起こったかを調べてください。
安価な再実行:
- コピー、ルック、ランチャー、サウンド、またはシーンコードの変更:
--from render、再録画なし。 - アクションキャプションは録画時に
events.jsonに焼き付けられます。plan.json(indexで)からそれらをパッチし、npx tsx -e 'import {editRecording} from "./src/edit.ts"; editRecording("OUT")'でタイムラインを再構築し、その後--from renderを実行します。 - ステップの変更:
--from plan(再録画)。
6. レポート前にレビュー
レンダリングされたMP4を、静止画だけでなくレビューします。コンタクトシートを作成し、すべてのフレームを確認します:
ffmpeg -v error -y -i OUT/demo.mp4 -vf "fps=1/2,scale=640:-1,tile=4x8" -frames:v 1 <scratch>/sheet.jpg
チェック項目:
- スタイルの一致:
probe.pngを静止画の横に置きます。同じ背景ファミリー、フォント、アクセント、マスコットですか?動画が異なるブランドのように見える場合は、lookを他の何よりも先に修正します。 - すべての
fill値が入力されたとおりに画面に表示されていること。✓はアクションが実行されたことのみを意味し、テキストが着地したことを意味しません。 - カメラが重要なもの(入力されているテキスト、クリックされているコントロール)に押し込まれており、ワイドショットや空のキャンバスになっていないこと。
- キャプションが読みやすく、アプリを覆い隠していないこと。テキストが収まっており、オーバーフローがないこと。
- Ahaフレームがペイオフを示していること(ローディング状態やトリミングされたボタンではない)。
- 比較ビートの「X → Y」が信頼できること。比率が馬鹿げている場合、古い方法の
secondsが水増しされています。 - オーディオが存在し、ピークが0 dB未満であること:
ffmpeg -i OUT/demo.mp4 -af volumedetect -vn -f null -。同期を確認するには、タイピング部分のshowwavespicを描画し、フレームと比較します。
7. レポート
ユーザーに以下を提供します:
OUT/demo.mp4へのパスとその長さ- フック、古い方法、オンリーワンのライン(それぞれ1行)
- ルックがどのように一致したか(どの色、フォント、マスコットがアプリから来たか)
- 機能させることができなかったもの、または録画ではなく合成されたもの(ランチャービートなど)
- アプリで気づいたバグ(例:キーストロークの欠落)
ライブ調整のためにツールが出力する npx remotion studio … コマンドと、サウンドトラック用の --music <file> について言及します。
効果音
デフォルトでオン。--no-sfx でオフになります。scripts/make-sfx.py がすべてを合成します(サンプルなし、ライセンス不要)assets/sfx/ に出力し、remotion/Sfx.tsx が録画イベントから各サウンドのタイミングを計ります:
- タイピング:1文字ごとに1つの触覚メカニカルスイッチサウンド(バンプクリック、ボトムアウトのトック、リリース)、レコーダーの実際のタイピング速度で。スペースはより深いスタビライズドサウンド、Enterはより重いサウンドになります。
- クリック:録画されたカーソルがクリックした場所でのマウスクリック(ランチャークリックを含む)。
- トランジション:シーンチェンジごとにウィッシュ音。
- 古い方法:ステップごとのカード着地音(ソフトではポップ、ボールドではサッという音)と判定音(ソフトポップ、またはボールドではスタンプ)。
- ペイオフ:チャイム。
- 比較:行ごとのポップ、時間結果に対するチャイム(ソフト)またはスタンプ(ボールド)。
--music を使用すると、音楽は効果音の下に音量が下げられます。Sfx.tsx で音量を変更し、--from render を再実行します。スクリプトを編集した後、再度実行してWAVを再生成します。
ネイティブMacアプリ
同じフロー、異なるレコーダー(mac/macdriver.swift:Accessibility APIでコントロールを検索、実際のマウス/キーボードイベント、ScreenCaptureKitでアプリウィンドウのみを録画)。--app を追加し、-- の後に起動引数を渡します:
npx tsx src/cli.ts <repo または ./local/dir> --app path/To.app [--app-seed demo/items.json] --prepare -- --demo {data}
{data}は実行ごとに新しい使い捨てフォルダになり、--app-seedがその中にコピーされます。ユーザーの実際のデータに対して録画しないでください。 アプリにデモ/データディレクトリ起動フラグがない場合は、録画前に追加するか(またはユーザーに依頼してください)、まずアプリを再ビルドします(ユーザーにコミットされていない変更がある場合)。- 最初に
mac/.build/macdriver check --openを実行します。ターミナルをホストするアプリに対して、アクセシビリティと画面およびシステムオーディオ録画の権限が必要です。いずれかが欠けている場合、正確なシステム設定ペインを開き、有効にするアプリの名前を表示します(終了コード3)。ユーザーは許可後にそのアプリを再起動する必要があり、これによりこのセッションは終了するため、再試行する代わりに後で戻ってくるように伝えて停止します。画面録画がない場合、--prepareは機能しますが、録画は機能しません。その間にストーリーボードを書いて準備を整えます。 - 録画はユーザーの実際のマウスとキーボードを乗っ取ります(約20~60秒、3秒のカウントダウン)。短いプローブ実行を含め、すべての実行の直前にユーザーに伝えてください。ユーザーがタイピングしている可能性があるときに開始しないでください。ユーザーの入力がフォーカスを奪い、テイクを台無しにします。
- ターゲット:
id、次にplaceholder、次にrole+name。gotoはありません。ターゲット指定なしのfillはフォーカスされているフィールドに入力します。pressをEnter/Tab/Meta+Nに使用します。 - ラベルのないアイコンボタンは自動化から見えません。キーコントロールに名前がなく、あなたがコードを所有している場合は、
.accessibilityLabel/.accessibilityIdentifierを追加します。 - キーが入力されている間はAccessibilityツリーをクエリしないでください。 SwiftUIアプリでは、AXクエリが再レンダリングをトリガーし、テキストフィールドを古いテキストにリセットしてキーストロークを落とす可能性があります。ドライバーはタイピング後にフォーカスされた要素のみを読み取ります。ドライバーを変更する場合は、そのままにしてください。それでもキーストロークが消える場合、アプリはおそらくこのバグを持っています(
NSViewRepresentableテキストビューで、updateNSViewが古いバインディングで文字列を上書きする)。ユーザーに伝えてください。
制限事項
ログインが必要なWebページは、公開ページまたは事前認証済みURLからフローを開始する必要があります。ネイティブ録画はmacOSのみで、単一のアプリウィンドウを録画します。その外側(デスクトップ、メニューバー、他のアプリ)はRemotionで合成され、録画されないため、レポートでそのように伝えてください。