القائمة
エピソード番号またはLISTENのプレビューURLから「盛り上がり切り抜きショート動画」を生成するフルパイプライン。ユーザーが「#N のクリップ作って」「切り抜き動画を作って」「Magic Clips」「このプレビューリンクから作って」などと言ったときに使う。音声DL→文字起こし→ハイライト検出→字幕校正→Remotionレンダリングまでを一気通貫で行う。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | make-clip |
| description | エピソード番号またはLISTENのプレビューURLから「盛り上がり切り抜きショート動画」を生成するフルパイプライン。ユーザーが「#N のクリップ作って」「切り抜き動画を作って」「Magic Clips」「このプレビューリンクから作って」などと言ったときに使う。音声DL→文字起こし→ハイライト検出→字幕校正→Remotionレンダリングまでを一気通貫で行う。 |
エピソード番号を受け取り、盛り上がり部分の縦型ショート動画（1080×1920、字幕付き）を生成する。
デザインとデータ仕様の詳細は video/README.md と docs/design-system.md を参照。
ffmpeg（必須）python3 -m venv $SCRATCHPAD/venv && $SCRATCHPAD/venv/bin/pip install -q mlx-whisper
src/data/episodes.json から対象話数の number / title / pubDate / audioUrl を取得し、
mp3 をスクラッチパッドにダウンロードする。
予約投稿（未公開エピソード）の場合: RSSにまだ載っていないので episodes.json は使えない。
LISTENのプレビュー共有URL（https://listen.style/p/magicalfm/<slug>/<共有トークン> の
4セグメント形式）をユーザーからもらえれば、ログイン不要の curl 1発で全情報が取れる:
curl -sL "<プレビューURL>" -o $SCRATCHPAD/preview.html
grep -o '<title>[^<]*</title>' preview.html # 「N: タイトル - マヂカル.fm - LISTEN」→ number/title
grep -oE 'https://[^"]*\.mp3' preview.html | head -1 # 音声のCDN URL（これをDLする）
grep -oE '202[0-9]-[0-9]{2}-[0-9]{2}' preview.html | sort -u # 配信予定日
bun scripts/fetch-listen-transcript.mjs $SCRATCHPAD/preview.html listen.json # 話者分離もこのHTMLから取れる
プレビューURLが無い場合のフォールバック:
number / title / 配信予定日はユーザーに確認してプランに手で書くfetch-listen-transcript.mjs に渡す、
(b) それが無理なら F0 ピッチのフォールバックで割り当てて文脈検証を厚めにするいずれの場合も、公開前なので動画の内容がネタバレにならないかユーザーに一言確認する （ハイライト候補の提示と兼ねると1回で済む）。
$SCRATCHPAD/venv/bin/mlx_whisper ep.mp3 \
--model mlx-community/whisper-large-v3-turbo \
--language ja --word-timestamps True \
--output-dir $SCRATCHPAD --output-format json --verbose False
19分エピソードで数分かかるので バックグラウンド実行 し、待ち時間に他の準備を進める。
cd video && bun scripts/find-highlights.mjs <ep.mp3> <whisper.json> --top 5
RMSエネルギー上位の窓が文字起こし付きで出る。スコアはあくまで候補。 各候補の前後の文脈を transcript で読み、以下の基準で1つ選ぶ:
冒頭30秒はオープニング定型なので通常は避ける。
選んだ窓の単語タイムスタンプを whisper JSON から抽出し、
video/plans/ep-N.json を手組みする（既存の ep-263.json が見本）。
校正（必須）: Whisper の生出力は誤認識があるため、文脈から必ず直す:
組版ルール:
bg はエピソード番号 % 4 → 0:lilac / 1:lime / 2:sky / 3:candy（OGPと同じ）clipEnd は最後の単語の約2.2秒後（CTA表示ぶん）クリップタイトル（必須）: トップレベルに
"clipTitleLines": ["帝国がクローンを", "やめた理由"] を書く。タイトルカードに
エピソード名の代わりに表示される、ショート動画としての見出し。クリップの内容を
簡潔に表すフックにする（オチそのものはネタバレになるので書かず、興味を引く切り口で）。
1行 約8文字・最大2行。省略時はエピソードタイトル表示にフォールバックするが、基本は必ず付ける。
話者の割り当て（必須）: 各ページに "speaker": "michiru" | "upamune" | "guest" を
付けると、動画にアバターが表示され発話中の側がハイライトされる。
ゲスト回: プランのトップレベルに "guest": { "name": "kita" } を書くと、
ホスト2人の間にゲストのアバター（画像未指定なら 🎤 プレースホルダ）が並ぶ。
ゲストが喋るページには "speaker": "guest" を付ける。name は短く（表示幅の都合上
7文字以下推奨）。画像を使う場合は "avatar": "<public/配下のファイル名>" を追加。
割り当ては LISTEN (listen.style) の話者分離を第一ソースにする。ホスティング側で 発話セグメント単位の diarization が済んでおり、ページ単位のF0推定より正確:
# エピソード説明文の「LISTENで開く」リンクのURLを渡す
bun scripts/fetch-listen-transcript.mjs https://listen.style/p/magicalfm/<slug> listen.json
[{start, end, speaker(0|1), text}]。0/1 が誰かはエピソードごとに任意なので、
会話の文脈（誰が質問しているか・名前の呼びかけ）か F0（michiru ≈ 167Hz / upamune ≈ 115Hz、
librosa の yin で確認）でそのエピソードのラベル対応を決めるcd video
bun scripts/build-clip.mjs plans/ep-N.json <ep.mp3>
bunx remotion still src/index.ts Clip out/check.png --frame=<確認したいフレーム>
bunx remotion render src/index.ts Clip out/magicalfm-N-clip.mp4
ffmpeg -ss <秒> -i out.mp4 -frames:v 1 check.png で 3フレーム以上 抽出して確認:
open で動画を開いてユーザーに報告するレンダリング済みの動画は Cloudflare R2（clips.magical.fm）にアップロードし、
src/data/clips.json にエピソード番号キーで自動追記する（1エピソードに複数可）:
cd video
bun scripts/upload-clip.mjs out/magicalfm-264-clip.mp4 264 "50歳でもバリベイビー"
初回のみ bunx wrangler login でCloudflareにログインしておく。
エピソード詳細ページに「切り抜きクリップ」セクションとしてリンクが表示される。
第3引数の label にはクリップのオチ・見どころを短く書く。