概要
このスキルは、リリースのチェンジログを、HyperFramesのHTMLベースレンダリングを使用して洗練された動画構成に変換します。製品アップデートに視覚的な発表がふさわしい場合に使用します。ヒーローフレーム、キーとなる箇条書きのコールアウト、背景パターンが含まれます。入力されたチェンジログエントリからMP4をレンダリングします。
HyperFrames — チェンジログ動画
入力: チェンジログ .md (テーマ+項目)。出力: リンター通過済み、シームゲートグリーンのHyperFramesプロジェクト。レンダリングは明示的に要求された場合のみ行います。
使用するタイミング
- ユーザーが チェンジログ/ダイジェストMarkdown を提供し、週次動画を希望した場合
- ユーザーが 「チェンジログ動画」 または 「週次ダイジェスト動画」 と発言した場合
- ユーザーが アニメーション化されたモックUIとナレーションを含むブランド動画 を希望した場合
使用しないタイミング
- ユーザーが製品ローンチ動画を希望する場合 (
hyperframes-product-launch-videoを使用) - ユーザーがモーショングラフィックスを希望する場合 (
hyperframes-motion-graphicsを使用) - ユーザーがトーキングヘッド動画を希望する場合 (
hyperframes-embedded-captionsを使用)
最重要原則: リスト表示するな、可視化せよ
すべてのテーマは、実際のUIまたはその忠実な類似物のアニメーションモックで表現し、UIがその変更を体験する様子を動作で示すこと。テキストの箇条書きは使用禁止。スクリプトを書く前に、すべてのテーマ/項目を必ずビジュアライゼーションレジストリ経由でルーティングしてください。
ワークフロー
0 · スキル資産からブートストラップ(必須)
mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
-vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
-an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html
次に references/build-spec.md を最初から最後まで読んでください。ここにブランドトークンが定義されています。
1 · 解析と編集カット
- 週の範囲、見出しの統計、テーマ、項目を抽出
- 予算: 合計45~60秒。 タイトル 2秒以下、アウトロ 3.5秒以下、4テーマで各約9~12秒
- テーマごとに、1つのヒーロービジュアライゼーションと最大 3つの読み上げ項目 を保持
- テーマはストーリー順に並べる: 目玉機能 → プロダクトサーフェス → パフォーマンス → 信頼性
2 · ビジュアライゼーションルーティング
各テーマについて、ビジュアライゼーションレジストリからサーフェスを選択し、1行で記述する: テーマ → サーフェス → モックが実行する2~4の順序付けられたアクション(各アクションはスクリプトのフレーズに対応)
3 · 2層スクリプト(読み上げ用 vs 表示用)
スクリプトをトークン行として記述する: 会話調で、すべての技術用語について spoken に発音記号形を持たせ、display には標準スペルを保持。キャプションは display を表示し、VOは spoken を読み上げます。
4 · VO + 単語タイムスタンプ
node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json
単語タイミングは厳格なゲートです。 次に進む前に、vo-words.json が空でなく、words: [...] 配列に各単語の start/end が含まれていることを確認してください。
5 · ビルド
references/build-spec.md に正確に従ってください: ブランドトークン + フォント + アニメーション背景エンコード + シーン基盤 + クローム + キャプションレール。その後、ドクトリン順序: ベクターレジャー → シームスタンプ → VO単語上の内部ビート → シームゲート検証。
キャプションは必須です。 先に進む前に captions.json から LINES 配列を設定してください。
6 · ゲート(すべてグリーンになってから提示)
hyperframes check— エラー0seam-gate.mjs verify— 失敗0- プレビューサーバーを再起動し、3~4ビートをスポットチェック
- ユーザーが要求しない限りレンダリングしない
- キャプション存在確認ゲート — 3~4フレームをサンプリングし、キャプションレールが表示されていることを確認
アンチ過最適化テーブル
| 過最適化 | 現実 |
|---|---|
| 「UI変更に箇条書きスライド」 | 変更を動作で表現するサーフェスのモックを作成 |
| 「表現できない項目に偽のUI」 | 正直なチェックリストシーン |
| 「TTSテキストにプレーンな'JSON'」 | 用語集の発音記号形を使用。表示は標準のまま |
| 「発音を推測する」 | 質問し、用語集を拡充する |
| 「すべてのチェンジログ項目を読み上げる」 | テーマごとに3項目まで。残りはダイジェストリンクでカバー |
| 「あらゆる場所に緑のアクセント」 | シーンごとに1つの緑の瞬間 |
| 「以前の動画のindex.htmlから開始」 | 常に master-skeleton.html をコピーする |
| 「空のLINES配列でも問題ない」 | 空のLINES = キャプションなしの出荷 = やり直し |
検証項目
-
hyperframes checkがエラー0でパスする -
seam-gate.mjs verifyが失敗0でパスする - キャプションレールが3つ以上のサンプルフレームで表示されている
- 単語タイムスタンプが音声と一致している
- ブランドトークンが build-spec.md と一致している
- レンダリングはユーザーが明示的に要求した場合のみ行う