Futuros Residentes / Doc Juanes のリールを編集する
編集上の決定を下す前に、references/estilo.md を読んでください。そこには承認されたスタイルと各ルールの理由が記載されています。何か問題が発生した場合は、references/problemas.md を確認してください。発生しうる問題のほとんどはすでに一度発生しています。音楽については references/musica.md を参照してください。
映像を依頼した人との作業方法
- 依頼者にはスペイン語で、明確に、専門用語を使わずに話しかけてください。依頼者はプログラミングができない可能性があります。何が見えるか、何をするかを説明してください。
- 実行前に、常に行動計画を要約し、承認を待ってください。常に、各段階(初期計画、各修正ラウンド、サムネイル、音楽)で行います。要約には 2 つの基準を含めます。それは、映像に関する基準(何を、どのように行うか、ステップバイステップ)と 財務基準です。トークン消費の予測(「トークン消費」を参照)です。具体的な計画を立てるために、生の映像の準備と文字起こしを事前に行うことができます。
- あなたは音声を聞くことはできません。測定と再文字起こしで確認し、主観的なもの(サウンドエフェクト、音楽の音量、非常にタイトなカット)は依頼者に聞いてもらってください。
- 各バージョンのフレームと MP4 を依頼者に見せてください。変更を依頼された場合は、依頼者が言及した編集済み動画の秒数で特定し(
src/Reel/edit.jsonでマッピング)、どのフレーズかを確認してください。 - ブランド: 計画で、動画が Doc Juanes か Futuros Residentes (FR) のどちらかを確認してください。プロジェクトフォルダと通知先の Google Chat スペースを定義します(ステップ 9)。
- 名前: 計画で、SHORT_NAME を大文字とアンダースコアで提案(または依頼)してください(例:
JUANCHO_PASASTE)。これはプロジェクトフォルダの名前にもなります。- レビュー中: 各バージョンに番号を付けて、古いバージョンを見て「変更がわかりません」と言われないようにします:
SHORT_NAME_REEL_v2.mp4、SHORT_NAME_COVER_1.jpg…。ダウンロードフォルダには最新バージョンのみを置きます。 - 最終バージョンが承認されたら、番号を含む他のすべてのものを取り除いて名前を変更します:
SHORT_NAME_REEL.mp4およびSHORT_NAME_COVER.jpg。そして、ダウンロードフォルダから却下されたバージョンとサムネイルを削除します。 - サムネイル: いずれかが選択されたらすぐに、動画がまだレビュー中であっても、ダウンロードフォルダと
out/portadas/内のファイル名をSHORT_NAME_COVER.jpg(番号なし)にすぐに変更し、他のオプションを削除します。後で選択されたサムネイルの調整を依頼された場合は、番号なしの同じファイルを上書きします。 - 送信するテスト画像(フォント、色、照明、エフェクト、レビュー用フレーム):
SHORT_NAME_TEST_<TOPIC>_N.jpg(例:SHORT_NAME_TEST_FONTS_1.jpg)。最終バージョンが承認されたら、却下されたバージョンと同様にそれらも削除します。リールとサムネイルのみが残ります。 - 依頼者のファイルを
rmで削除しないでください。./scripts/trash.sh <ファイル>を使用してください(Mac のゴミ箱または Windows のごみ箱に移動。復元可能)。
- レビュー中: 各バージョンに番号を付けて、古いバージョンを見て「変更がわかりません」と言われないようにします:
- 音楽: すべての動画に音楽が必要なわけではありません。リクエストがあった場合のみ追加してください。既に使用した曲を繰り返さないでください(
references/musica.mdのリスト参照)。Janeth がリサイクルを許可した場合を除きます。 - インタラクティブなプログラム(
npx create-videoなど)はターミナルパネルのタブで実行されます。依頼者にそのタブをクリックしてそこに回答するよう指示し、各質問を説明してください。
このスキルを変更できる人
このスキルは GitHub(github.com/tatacardona/Reels-FR-Doc-Juanes)にあり、Janeth Cardona のみが変更できます。どのコンピュータを使用しているかを確認するには:git -C ~/.claude/skills/editar-reel-fr config user.email
- 応答が
[email protected](Janeth のコンピュータ)の場合:スキルを変更する前に、必ず彼女に確認し、彼女の同意を待ってください。何を変更するか、なぜそれがすべての動画に役立つかを 1 行で伝えてください(彼女自身が変更を依頼した場合は、すでに承認されています)。特定の動画に関する事項(曲、タイミング、位置、音量)は、そのプロジェクトにのみ含め、スキルには決して含めないでください。変更後:git -C ~/.claude/skills/editar-reel-fr add -A && git commit -m "<変更内容>" && git push - その他のコンピュータでは、スキルファイルを決して変更しないでください。 すべての人に役立つ改善点や問題を発見した場合は、その人に Janeth に伝えるよう指示し、送信するテキスト(何が起こったか、どの動画か、提案内容)を書いて渡してください。
- 使用された曲は
references/musica.mdに記録されます。他のコンピュータでは、タイトル、アーティスト、リンクを Janeth に渡して追加してもらってください。
トークン消費(アカウントはチーム全体で共有)
Claude の各ステップは会話全体を再読します。これがほぼすべてのコストであり、会話が長くなるにつれて増加します。そのため:
- 動画ごとに新しい会話を開始してください。 動画が承認されたら、次の動画のために新しい会話を開くことを提案してください。同じ会話を続けると、コストが 2~3 倍になる可能性があります。
- 修正をまとめて依頼してください。 すべての修正を 1 つの番号付きメッセージにまとめ、1 回のエクスポートで適用するよう依頼してください。
- 少量かつ小規模に読んでください。 縮小されたフレーム画像(
SCALE=0.25-0.35)、ファイルと出力の必要な部分のみ(tail、grep)、疑問があるセグメントのみを再文字起こししてください。大きな画像はコストがかかります。 - 尋ねずに待機してください。 長時間のエクスポートはバックグラウンドで実行します。毎分確認しないでください。
- 依頼されていないステップは実行しないでください。 ステッカー、音楽、AI 背景、追加の検索は、リクエストされた場合のみ実行してください。
各計画における予測(実際の 30~45 秒の動画で計測。Claude Opus 5.5 を使用した API の公定価格、新しい会話の場合)。計画のステップ、その範囲、合計を示す短い表を表示し、概算であることを明記してください:
| 段階 | Claude のステップ数 | 概算費用 |
|---|---|---|
| 準備、文字起こし、計画の提示 | 15~25 | 1~2 米ドル |
| ビジュアル提案(フォント、色、照明)サンプル付き | 8~15 | 1~1.5 米ドル |
| 編集の組み立て、承認用テキスト、v1 のエクスポート | 20~35 | 2~3 米ドル |
| 各修正ラウンド+新しいエクスポート | 10~25 | 1~2.5 米ドル |
| 音楽の検索と調整 | 10~20 | 1~2 米ドル |
| サムネイル 3 枚 | 8~15 | 1~1.5 米ドル |
| 標準的な動画全体(計画、v1、2 ラウンド、サムネイル) | 80~130 | 7~12 米ドル |
Team/Enterprise プランでは料金が異なる場合があります。この数字はオプションを比較するためのものです。依頼者が節約したい場合は、具体的な代替案(ラウンド数を減らす、音楽なし、新しいサムネイルなし、シンプルな動画にはより経済的なモデルを使用するなど)を提案してください。決定は依頼者に委ねられます。
各動画の終了時に、python3 scripts/consumo.py --desde "<動画の最初のメッセージのテキスト>" で実際の消費量を測定し、予測とともに共有してください。差が大きく、Janeth のコンピュータを使用している場合は、この表の調整を提案してください。
ステップ 0: ツール(マシンごとに 1 回)とスキルの更新
git -C ~/.claude/skills/editar-reel-fr pull -q # スキルの最新バージョンを取得(動画ごと)
source ~/.claude/skills/editar-reel-fr/scripts/setup-tools.sh # $PY、$FF、$PROYECTOS、$DESCARGAS をエクスポート
完全な ffmpeg、faster-whisper、DeepFilterNet(エコー除去)、OpenCV を専用環境にインストールします。 最初の文字起こしでは、large-v3-turbo モデル(約 1.6 GB)をダウンロードします。事前に許可を得てください。
- Mac: Node.js と Python 3 が必要です(Xcode ツールに含まれるか、一度インストールします)。
- Windows: Claude Code は Git Bash を使用し、これらのプログラムはそこで実行されます。最初に一度だけ、Python 3.11 と Node.js LTS をインストールしてください(
winget install Python.Python.3.11およびwinget install OpenJS.NodeJS.LTS、本人の許可を得てください。Python 3.12 以降は機能しません)。Windows で何か問題が発生した場合は、references/problemas.mdを確認し、Janeth に報告してください。
ステップ 1: Remotion プロジェクト
- プロジェクトは
$PROYECTOS/<MARCA>/SHORT_NAMEに配置します。<MARCA>はDoc JuanesまたはFRです(Mac: ムービー → Reels Doc Juanes; Windows: ビデオ → Reels Doc Juanes)。動画ごとに 1 つのプロジェクトです。コピー用の以前のプロジェクトは、これら 2 つのサブフォルダにあります。 - 最も速い方法:以前のプロジェクトから
package.json、package-lock.json、tsconfig.json、remotion.config.ts、src/index.ts、src/index.css、src/Root.tsxをコピーし、node_modulesもコピーします(Mac:cp -c -R、インスタントクローン; Windows:npm ci)。以前のプロジェクトがない場合:npx create-video@latest(Blank、Tailwind Yes)、npm i、npm i @remotion/google-fonts@<remotionのバージョン>を実行します。 - テンプレートとスクリプト:
cp -R ~/.claude/skills/editar-reel-fr/assets/template/src/Reel src/Reelとmkdir -p scripts && cp ~/.claude/skills/editar-reel-fr/scripts/* scripts/を実行します。 - コンポジションを登録します(
assets/template/Root.snippet.tsxを参照)。"resolveJsonModule": trueも忘れずに設定します。
ステップ 2: 生の映像を準備する
- フレームを抽出します(
"$FF" -ss 20 -i crudo -frames:v 1 x.jpg)。それを確認します:向き(人物が横向きの場合はccw/cwを使用)、壁の色(キーワードの色を決定)、顔の位置(FACE_ORIGIN)。 FF="$FF" ./scripts/prep.sh "<crudo>" <none|ccw|cw>→public/video-vertical.mp4(影を明るくする露出カーブ付き。LIGHT=0で削除)+work/内のオーディオファイル。- 背景や照明の改善がリクエストされた場合(背景が雑然としている、上からの照明で顔が暗い):
scripts/fondo-luz.pyは AI で人物を分離し、ぼかした背景、顔を追跡するフィルライト、必要に応じて壁にステンドグラス風の色付きライトを備えたpublic/video-fondo.mp4を作成します。調整はedit-config.json→"fondo"で行います(スクリプトのヘッダーを参照)。build-edit.pyの後に実行します(使用されたセグメントのみを処理します。セグメントが変更された場合は再実行してください。そうしないと、それらのフレームは未処理のままになります)。VIDEO_SRC = "video-fondo.mp4"で有効になります。事前にテストフレームを見せてください。 スタイルは控えめが好まれます:軽いぼかし(5)、非常にソフトなエッジ(14)、ステンドグラス/ボケは非常に控えめに。
ステップ 3: 文字起こしとマッピング
"$PY" scripts/transcribe.py # 時間付きフレーズ → work/transcript.json
"$PY" scripts/energy.py words # 各単語の音量とフレーズ全体の比較(+dB = 強調)
編集マップを作成し、短いリストで説明します:
- 削除: カチンコ(「よし、テイク N…」)、NGテイク(「もう一度」、汚い言葉、笑い)、繰り返されたフレーズ(最もクリーンなテイクを残す。通常は最後)、フライングスタート、クロージング(「よし」)。
- フック: 最初の強力なフレーズ。最初に配置します。
- 引き伸ばされた単語(例:3 秒の「いいえ」)、不明瞭な単語、文字起こしされていない音声=繰り返されたテイクまたはフライングスタート:これらの孤立したセグメントを再文字起こし(オーディオ部分に対して WhisperModel を使用)し、
energy.py zoom <start> <end>で調整します。 - 台本に誤ったデータ(言い間違えた数字)がある場合は、カットを提案してください。AI で声を模倣しないでください。
ステップ 4: オーディオ
FF="$FF" PY="$PY" ./scripts/audio.sh # エコーが少なく自然な声(DeepFilterNet + ソフトエキスパンダー、-14 LUFS)
"$PY" scripts/energy.py # クリーンな声で測定 → よりタイトなカット
"$PY" scripts/sfx-stickers.py # 音付きステッカーがある場合のみ
"$PY" scripts/sfx-tear.py # 破れる写真がある場合のみ
ステップ 5: edit-config.json: 編集上の決定
ベース: assets/edit-config.example.json。すべての時間は生の動画の秒単位です。
clips: フレーズまたはアイデアごとに 1 つのセグメント。順序通り。余裕を持ったマージン。スクリプトは内部と外部の無音部分をトリミングしますが、単語を決してカットしません。fx:punch(継続)、whoosh(話題の変更)、leak(色付きの太陽光フラッシュ。インスピレーションを与える動画向け、estilo.mdを参照)、flash(白いフラッシュ)。zoomはセグメントのショットを固定します。steps: [[秒, ズーム], …]は、オーディオをカットせずにショットを段階的に変更します。hold_zoom: true= 単一ショット。tail: 0.1= カットが最後の子音を切ってしまう場合のセグメント終了時の余分なマージン。emphasis: 強調して話された、または重要な単語の[単語, 秒](約 1.5~2 秒ごとに 1 つ)。word_fixes: 単語の実際の時間。後でセグメント内にあることを確認します(前の無音部分にある場合、字幕から消えます)。idea_start: アイデアの開始大文字(0.1 秒未満のすべての単語に影響:次の単語が非常に近い場合、「Y no」など、最初の単語の直前の時間を使用します)。text_fixes:[{"at": 秒, "text": "pregunta:"}]単語の正確なテキスト(例:「:」を保持するため)。brand_words(「Futuros Residentes」、「Doc Juanes」を保護。他に「UdeA」などを追加)、small_extra(単独では決して使用されない短い単語:「fue」、「esa」、「mi」、「tan」…)。photos:{src, show_at, tear_at}(破れる)または{src, show_at, hide_at}。stickers(リクエストされた場合のみ。例はassets/edit-config.stickers.example.json):{kind, show_at, hide_at, x, y, size, sfx: [[ファイル, 秒, 音量]]}。種類:broken-heart(break_at)およびsrc/Reel/Stickers.tsx内のARTの描画。新しいものについては、独自の SVG として描画します(Apple の絵文字や著作権のある画像は絶対に使用しないでください)。人物が手を動かしている場所に配置します(フレームを確認)。顔や字幕の上には決して配置しないでください。エフェクトが頭を追従する必要がある場合は、"$PY" scripts/head-track.py <開始> <終了>+follow_head: trueでフレームごとの位置を指定します(track)。sounds:[[ファイル, 秒, 音量, オフセット_秒]]。shakes: 震えのある秒数(衝撃)。end_push: {at, to}: デフォルトのクロージング、顔へのソフトなズームイン(約 1.6 倍)。フェードアウトはなし。end_hold: 終了時の追加秒数。speed: 加速がリクエストされた場合(ステップ 7 を参照)。- ベースフォント(通常の単語):Montserrat Black 900、白色に黒い輪郭。動画のブランドが別のフォントを要求する場合を除く(例:Futuros Residentes の動画ではウェブサイトのフォントを使用)。
- 強調単語: 動画の雰囲気に基づいて計画で提案し、実際のフレーム上で 2~3 のオプションを提示します:1 つのフォント、または2 つのフォント(例:感情的な部分にはエレガントなセリフ体、インパクトのある部分には太字)、同じ色または異なる色。フォントと色は雰囲気に合わせます(インスピレーション、ノスタルジック、エネルギッシュ、コミカル…)。
EMPH_*(1 番目)とEMPH2_*(2 番目、emphasisで"alt"とマークされた単語)はconstants.tsにあります。色は壁とコントラストがなければなりません。 echo:[[開始, 終了]]重要なフレーズにかけるソフトエコー(その後:"$PY" scripts/eco.py)。そのようなフレーズを検出した場合は提案するか、リクエストされた場合に適用します。
…
[翻訳のため省略]