SCROLLUCK/dark-channel-studio-public

shorts-from-peaks

ツールの順序

1. search_videos(query, n, shorts) - YouTubeを検索し、結果を（視聴回数、バイラル性で）ランク付けし、上位のピークとともに保存します。list_sourcesは既に保存されているものを表示します。公式または許可されたソースを優先してください。
2. get_peaks(video_id) - 保存されたソースのヒートマップピーク。ヒートマップがない場合はその旨を伝え、別のソースまたは手動ウィンドウを提案し、ピークを決して捏造しないでください。
3. create_clip_project(video_id, peak_rank=1, hook_text) - ピークからエディタードラフトを作成するか、手動ウィンドウ用にstart/end秒を渡します（直接実行）。
4. render_project(video_id, hook_text, custom_script) - バックグラウンドでドラフトをレンダリングします（直接実行）。get_job(job_id)でポーリングします。そのchecks_failedは失敗した変換チェックをリストします。
5. 失敗したチェックを修正し、queue_add(project_id)でキューに追加するようユーザーに依頼します（確認が必要）。ui_open("editor", video_id)でユーザーに表示します。

• ヒートマップがない場合、またはユーザーが所有する長いアップロード/リンクの場合：autoclip_source(url, length, max_clips, prompt, create_drafts)はトランスクリプトから最適な瞬間を見つけ、ランク付けされたクリップを返します（get_jobをポーリング）。create_drafts=trueの場合、それらはエディターに配置されます。

ピークの読み取り

• 値は0〜1に正規化されます。ピークは>= 0.8の極大値です。10秒未満のピークは1つにマージされます。
• 動画の最初の5%（イントロアーティファクト）にあるスパイクは無視します。値で上位3つを保持します。
• 各ピークを開始-終了、ピーク値、ツールからのランク、動画タイトルとURLとともに報告します。

カットウィンドウ

• 合計の長さは15〜30秒（最大30秒：変換ゲートがそれより長いものを拒否します）。
• 視聴者がセットアップを理解できるように、ピークの3〜5秒前に開始し、見せ場の2〜4秒後に終了します。文またはアクションの境界でカットします。
• 動画の長さにクランプします。サードパーティのクリップ1つから実行時間の50%以上を使用しないでください。Bロール、画像、データカードを追加します。
• Shortごとに1つの瞬間。同じストーリービートの場合にのみ2つのピーク。

フック（最初の3秒）

• 最初のフレームに重ねて読まれる質問、ステーク、または驚くべき主張。大きな画面上の見出し（最大6語）を追加します。
• タイトル、説明、またはトランスクリプトに存在する事実のみを使用します。噂は「RUMOR」とラベル付けします。
• ナレーション：文は最大8語、約2.5語/秒。フック → コンテキスト → ピークでの見せ場 → 短いCTA。ソース自身の音声は小さくするかオフにし、ナレーターが主導します。

変換チェック（5つすべて合格する必要があります。docs/LEGAL.mdを参照）

• narration：元のナレーションが存在する。
• visual_layers：少なくとも2つの追加レイヤー（テキスト、画像/ステッカー、Bロール、データカード）。
• text_overlay：フックまたはテキストが画面に表示されている。
• duration：30秒以下。
• source_credit：すべてのプラットフォームのキャプションでソフトがクレジットされている。 いずれかが失敗した場合、プロジェクトを修正して再レンダリングします。再レンダリングにより、以前の承認は無効になります。

キャプションとテキスト

• 単語ごとのキャプション、グループあたり2〜4語。太字のサンセリフフォント、黒の輪郭付きの白、アクティブな単語がハイライトされます。
• キャプションを下部の約12%と側面の約6%（プラットフォームUI）の外に配置します。絵文字はチャンネルスタイルで使用している場合のみ。

タイトル、キャプション、ハッシュタグ

• タイトル/最初の行 = フック、80文字未満。1文のコンテキスト。
• 3〜5個のハッシュタグ：1個のニッチ、1〜2個のトピック、1個の広範。禁止または誤解を招くタグは使用しないでください。
• 常にソース：<チャンネル> - <URL>を含めます。
• テンプレート：references/clip-brief.md。

AI開示

合成ナレーション（TTS）またはAIビジュアルを使用する場合、承認前に投稿ごとのAI開示フラグが必要であり、アップロード時にプラットフォーム独自のAIラベルも必要です。確認カードでユーザーに注意を促します。

禁止事項

• 生のクリップ、30秒を超えるクリップ、またはナレーションなしのクリップを投稿しないでください。
• ユーザーがブロックしたとマークしたソース、またはプライベート/メンバー限定/サインインのみのソースを使用しないでください。
• ユーザーの確認なしにキューに追加、スケジュール、または削除しないでください。