チェックリストオーバーレイ
左側に画面収録、右側にチェックリスト。各項目は、そのステップが画面上で発生した瞬間にチェックされます。最後のチェックが行われると、動画は完全にチェックされたリストの状態でホールドされます。
入力
| 入力 | 備考 |
|---|---|
| 収録 | 1つのローカル動画ファイル。理想的には16:9。無音でも問題ありません。 |
| ステップ | 3〜7個の項目:{ "label": "...", "at": <収録開始からの秒数> }。ラベルは短い命令形のフレーズ(約2〜4語)にします。 |
| タイトル | 1行。結果を示します(例:「5ステップでエージェントにスキルを追加する」)。 |
| サブタイトル | オプションの1行。 |
| パレット | オプションの16進数オーバーライド:bg, surface, panel, ink, muted, accent, border, accentInk。デフォルトはオレンジのアクセントカラーを使ったダークテーマ。accentInkはaccent上で読みやすい十分な濃さにしてください。 |
タイムスタンプが提供されない場合は、収録をスクラブし(ffmpegで1〜2秒ごとにフレームを抽出して確認)、各ステップが視覚的に完了または進行中である最初のフレームを選択してください。推測しないでください。
ワークフロー
- プロジェクト契約のために
/hyperframes、/hyperframes-core、/hyperframes-cliを読み込みます。 spec.jsonを記述します:{ "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" }, "steps": [ { "label": "アプリを開く", "at": 1.5 }, { "label": "検索", "at": 7.9 } ] }- プロジェクトディレクトリにコンポジションを生成します:
node <skill>/scripts/create.mjs spec.json <recording.mp4> <project-dir> [--hold 2.2]これにより収録がコピーされ、最後のフレームが抽出され(収録終了後も画像がホールドされるように)、収録に合わせたサイズのindex.htmlが書き込まれます。全長 = 収録時間 + ホールド時間(デフォルト2.2秒)。 npx --yes hyperframes checkがエラー0、警告0でパスする必要があります。- 検証(後述)を行い、その後レンダリング:
npx --yes hyperframes render --workers 2 --quality delivery --output final.mp4。
タイミングルール
- チェックはステップ上に正確に表示され、決して前には表示されません。塗りつぶしとチェックマークの描画は
t = atで開始され、描画は約0.3秒後に完了します。atより前に項目がチェックされたように見えてはいけません。 - タイムスタンプは収録時間であり、収録はコンポジション時間0から始まるため、
atはそのまま使用されます。収録をトリミングする場合は、すべてのatを同じ量だけシフトしてください。 - 「次はこれ」というアウトラインが、前のチェックの直後に次の項目に表示される場合があります。これはアウトラインのみであり、塗りつぶしやチェックマークは含まれません。
- 各チェックが認識できるよう、チェック間は少なくとも1.5秒以上間隔を空けてください。2つのステップが近すぎる場合は、それらをマージしてください。
- 最後のチェックは収録終了の少なくとも1.5秒前に行われるか、完了したリストが2秒以上表示されるように
--holdを増やしてください。 - カウンター(
n / N)、プログレスバー、フレームリングのパルスはすべて同じatの値に連動するため、同期が保たれます。
レイアウト(16:9収録の場合)
1920x1080のキャンバス、56ピクセルのマージン。タイトルとサブタイトルは上部に配置。収録フレームはヒーローとして約1250ピクセル幅(幅の約65%)、チェックリストパネルはその右側に520ピクセルのカラムとして配置し、フレームと同じ高さにします。項目は高さを均等に分割します。これにより、収録内のUIテキストが読みやすくなります。フレーム幅を約1100ピクセル以下に縮小しないでください。縦長の収録の場合、ジェネレーターはアスペクト比に応じてフレームをスケーリングします。16:9以外の収録の場合:フレームがヘッダーの下に収まるか確認するか、最初に収録をクロップしてください。
ラベルは32ピクセルで2行に折り返されます。約26文字以内に収めてください。
検証
レンダリングされたfinal.mp4に対して、スナップショットだけでなく、以下の手順を実行します。
- 各ステップについて、
atの0.08秒前のフレームと0.45秒後のフレームを1つずつ抽出します:ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png。 - それらを確認します。前:項目は未チェック、カウンターはi-1。後:項目は塗りつぶされチェックマークあり、カウンターはi、プログレスバーが進んでいます。
- 最後のホールド部分のフレーム(終了の約0.2秒前)を抽出します:すべての項目がチェックされ、カウンターは
N / N、バーは満タン。 - 収録内のテキストがフレーム内で判読可能で、ラベルがクリップされていないことを確認します。そうでない場合は、
spec.jsonまたはパレットを修正して再生成します。 ffprobeでファイルを確認:1920x1080、h264、duration = 収録時間 + ホールド時間。
納品
final.mp4へのパス、その長さ、使用されたステップのタイムスタンプを報告します。プロジェクトディレクトリ(index.html、assets/、spec.json)は、異なるラベルやパレットで動画を再生成できるよう保持します。ユーザーがStudioで編集したい場合は、先にnpx hyperframes previewを開いてください。