Tela Viva: アニメーション式チュートリアルリール
3スタイルキット: ユーザーがスタイルを指定せずにリールを依頼し、かつスキル「Modo 8-Bit(ピクセルアート)」と「Hora Dourada(チュートリアル用フラットアイコン)」も利用可能な場合は、まず3つのスタイルのうちどれが良いか尋ねてください。
このスキルは、テーマをチュートリアル形式の縦長リール(1080×1920、30fps、MP4)に変換します:
- 上部にプログレスバーとステップ番号(短いタイトル付き)。
- 中央に、汎用的でブランドのないウィンドウが「動作」している様子(テキスト入力、応答表示、マーカー、機密データの黒塗りなど)。
- 下部に、単語ごとのキャプション:発話中の単語がブランドカラーで表示されます。
- 最後に「フォローしてね」カード。
動画はコード(Python + ffmpeg)で生成されます。AI動画生成は使用しません。40秒のリールなら1分未満で完成します。
常にユーザーの言語(通常はポルトガル語)で応答してください。
ステップ1. リクエストを理解する(1回の質問で、不足している情報をすべて尋ねる)
ユーザーがまだ言及していないことだけを、一度に質問します:
- テーマ: 視聴者が何を学んだり試したりするのか?ユーザーがすでにナレーションのテキストを提供している場合は、そのテキストを使用します。
- ブランド: メインカラー(16進数、例:
#7C3AED)とプロフィールの@。回答がない場合は、紫色#7C3AEDと@seuperfilを使用し、その旨を伝えます。
ユーザーが「お任せで」と言った場合は、質問せずにデフォルト値を使用し、使用した値を伝えます。
ステップ2. スクリプトを書く
roteiro.json ファイルを作成します(以下の形式; exemplos/roteiro-exemplo.json にテンプレートがあります)。
効果的な構成(5~8シーン、30~60秒):
- フック(記号
!):視聴者が共感する状況(ナレーション最大10語)。 - 番号付きステップ(記号
1、2、3...):シーンごとに1つのアクション、ウィンドウにアクションを表示。 - 注意(ステップの1つに含めることも可):結果を確認し、機密データを貼り付けない。
- コールトゥアクション(記号
✓):例:「プロンプトはキャプションに」+ 付箋(nota)。 - 最後(
"tipo": "final"):「もっと見たい方はフォローを…」。
コンテンツルール:
- タイトルは最大6語。1~2語を
*アスタリスク*で強調。 - ナレーション:約毎秒2.3語。各シーンの長さはナレーションから算出されます。
- 架空のデータ、名前、企業(「Aさん」「サプライヤー」)を使用し、データが含まれるシーンには
"exemplo": trueをマーク。 - 実際のツールの名前、ロゴ、画面を配置しないでください。ウィンドウは汎用的です(「AIアシスタント」「スプレッドシート」「受信箱」)。
- 機能、数式、数値、結果をでっち上げないでください。スクリプトがツールの機能に言及する場合は、公式ソース(Web検索など可能なら)で確認し、確認したことをユーザーに伝えてください。確認できない場合は、その旨を伝えてください。
- 大げさな約束(「10時間節約」「もう二度と…」)はしない。
ステップ3. 動画生成前のプレビューフレーム
各シーンの中間時間を指定してプレビューを実行します(時間は出力の先頭に表示されます):
python3 <スキルフォルダ>/scripts/reel.py roteiro.json --out saida --preview 3,10,18,25,32
saida/previa_grade.jpg を開いて確認:
- ウィンドウからはみ出ているテキストがないこと。
- 2行を超えるタイトルがないこと。
- マーカーと黒塗りが正しい位置にあること。
必要に応じてJSONを調整し、繰り返します。その後、ユーザーにプレビューグリッドとスクリプトを表(シーン、表示内容、ナレーション、時間)で見せ、動画を生成しても良いか尋ねます。
ステップ4. 動画を生成する
python3 <スキルフォルダ>/scripts/reel.py roteiro.json --out saida --nome meu-reel
このコマンドで生成されるもの:
saida/meu-reel-sem-voz.mp4:落ち着いたBGMとタイピング音(スクリプト自作、サードパーティの音楽は不使用)。saida/guia-narracao.txt:ナレーションテキストのみ、シーンごとに1段落。saida/tempos.txt:各シーンの開始時間と終了時間。
--sem-musica でBGMなしの動画を生成します。
ユーザーへの納品物:
- 動画
- ナレーションガイドと時間ファイル
- 投稿用キャプション(フック、手順、プロンプト全文があれば、「これは例です。」、ハッシュタグ3~5個)
送信前に、最終的なMP4の4~5フレームを確認してください(ffmpegで抽出)。
ステップ5. 音声(ユーザーが音声ファイルを送ってきた場合)
ユーザーはガイドに従ってナレーションを録音します(スマホでも、AI音声でも、好みに応じて)。音声ファイルを受け取ったら:
python3 <スキルフォルダ>/scripts/reel.py roteiro.json --out saida --nome meu-reel --audio /path/to/voz.m4a
- タイムマークがない場合、スクリプトは各シーンの単語数に比例して、音声全体にシーンを均等に配置します。
- 正確に同期するには、JSONに
"marcas_audio": [0, 7.8, 15.2, ...]として、録音内で各シーンが始まる秒数を設定します。ユーザーがこれらの時間を伝えるか、単語単位のタイムスタンプが付いた文字起こしツールがあれば、ファイルを聞いて確認できます。 - 出力は
saida/meu-reel-com-voz.mp4で、BGMは音声の下で小さくなります。
別の方法:ユーザーが自分で動画編集ソフト(CapCut、InShot、Instagramのエディター)で、音声なしの動画に音声を追加することもできます。
納品時の注意: AIで生成された音声、画像、動画が含まれる場合、ユーザーは投稿時にAIラベルを付ける必要があります。
roteiro.json の形式
{
"marca": {"cor": "#7C3AED", "arroba": "@seuperfil", "bio": "プロフィールの短いフレーズ"},
"palavras_por_segundo": 2.3,
"cenas": [
{"selo": "!", "titulo": "受信箱が*いっぱい?*", "narracao": "...", "exemplo": false,
"duracao": 6.5,
"janela": {"tipo": "lista", "...": "..."},
"nota": {"texto": "プロンプトはキャプションへ ↓", "sub": "保存", "em": 0.4},
"pilula": {"texto": "オフにできる", "em": 0.3, "y": 0.4}}
]
}
duracaoは省略可能:指定がない場合はナレーションから長さを算出します。- 最後のカードには@の頭文字が表示されます。ユーザーから依頼がない限りマスコットは入れないでください。
nota(付箋)とpilula(フローティングラベル)は省略可能です。emの値はシーン内で表示されるタイミングの割合(0~1)です。- 色は、白背景でテキストが読みにくい場合に自動的に暗くされます。
ウィンドウ内テキストのマークアップ: [[テキスト]] はシーン中に表示されるマーカーになります。{{テキスト}} はテキストを隠す黒い帯(機密データ)になります。
tipo | 用途 | フィールド |
|---|---|---|
lista | 受信箱、タスクリスト、ファイル | titulo, itens([送信者、件名、プレビュー])、nao_lidas(インデックス)、destaque(インデックス)、tremer、destaque_em |
texto | 会話、メモ、ドキュメント | titulo、resumo({titulo, linhas})、resumo_animado、mensagens([{autor, texto}])、marcar_em、tarjar_em、etiquetas(✓付きピル)、etiquetas_em |
chat | AIアシスタント(暗いウィンドウ) | titulo、prompt(タイプ入力)、resposta(行のリスト、省略可)、caracteres_por_segundo |
escrever | メールやメッセージの返信 | titulo、texto(タイプ入力)、botao |
planilha | シンプルな表 | titulo、colunas、linhas、coluna_destaque、formula(省略可:確認済みの数式のみ)、revelar_ultima |
cartao | 新着情報、ルール、ハイライトまとめ | selo、titulo(*強調* 可)、texto、fonte(情報の出典) |
final | 「フォローしてね」カード | bio、botao、clique_em |
よくある問題
- 「ffmpeg が見つかりません」: スクリプトは
imageio-ffmpegを pip で自動インストールしようとします。失敗した場合は、pip install imageio-ffmpegを実行してください(必要に応じて--break-system-packages付き)。 - テキストがウィンドウから切れたりはみ出したりする: テキストを短くする、2つのメッセージに分割する、リスト項目を減らす(約5行まで収まります)。
- キャプションが速すぎる: シーンの
duracaoを増やすか、ナレーションの単語数を減らします。 - フォント: Inter と JetBrains Mono(SIL Open Font ライセンス、ファイルは
assets/fontsにあります)。