JohanDuran/video-studio

編集ルール

以下のルールは再確認せずに従うこと。利用可能なツールとその使い方については video-toolkit を読むこと。

0. プロフィールとハウスルール

• チャンネルのプロフィールは video-toolkit §0 に従って見つける：作業フォルダの直近上位にある studio.json、存在しない場合は ~/.video-studio/config.json のデフォルトチャンネル。 不足 → /studio-setup を提案する。
• プロフィール内の house_rules はユーザー自身の決定事項（例：「マイクの音には触らない」）である。 これらは以下のデフォルト設定を上書きする。ユーザーが新しい恒久設定を口にした場合は、それを house_rules に1行（理由と日付付き）で追加し、保存したことをユーザーに伝える。

1. すべて無料であること

• DaVinci Resolve：無料エディション、21.0.x。 21.1以降へのアップグレードを決して提案しないこと：21.1でPythonスクリプティングがStudio専用になり、無料版のResolve MCPが使えなくなる。
  • 21.1以降のAPI機能（SetSpeed、AddTransition、SetFades、NormalizeAudioLevel、CreateMulticamClip、AutoAlignClips、output blanking）を提案しないこと。代わりに回避策（キーフレーム、Fusion、ffmpeg、手動UI操作）を提案する。
  • Studio専用機能（Voice Isolation、Dialogue Leveler、時間/空間ノイズリダクション、Super Scale、Magic Mask）を、それがStudio専用であることを明記せずに提案しないこと。
  • プロフィールの resolve.edition が studio の場合、Studio機能は問題ない。ただし21.0.x固定は、ユーザーがアプリ内ブリッジに依存している場合のみ適用される。
• HyperFrames：ローカルレンダリングのみ。 ツールボックスの render_hyperframes または npx hyperframes render を使用する。
  • hyperframes cloud render、lambda、cloudrun、hyperframes auth login を決して実行しないこと。
  • HeyGenクレジットが必要な機能（HeyGen TTS/ボイス、アバター、media-use resolve --type bgm|sfx（heygen CLIが必要）、AI画像/音楽/動画生成（クレジット消費））を使用しないこと。代わりにツールボックスを使用する：音声には speak、効果音には sfx_search/sfx_generate、文字起こしには transcribe。
  • HyperFramesのワークフローステップにこれらのいずれかが必要な場合は、スキップするか無料の代替手段を使用し、その旨を伝える。
  • HyperFramesのデスクトップアプリや hyperframes open を推奨しないこと：パイプラインは Claude + CLIレンダリング + Resolve MCP である。Web Studioプレビューはユーザー自身の小規模な調整にのみ使用可能。
• その他のツール： インストール済みのもの（ffmpeg、Node、Docker）を優先する。有料サービスにサインアップしたり接続したりしないこと。
• 音声： Kokoro（ローカル、Apache 2.0）を speak 経由で使用し、プロフィールの声と速度を使用する。チャンネル動画に非商用TTSウェイトを使用しないこと。
• 文字起こし： WhisperXをツールボックスの transcribe で使用し、ResolveやHeyGenのものは使わない。特に依頼がない限り話者ダイアライゼーションは行わない。
• 生成効果音/音楽： Stable Audio Open 1.0をツールボックスの sfx_generate で使用する（Hugging Faceライセンスは /studio-setup 時に受け入れ済み）。

2. フォルダ構成

<studio>/
  sfx_library/       共有生成音声 + index.jsonl（動画・チャンネル間で再利用；toolbox.sfx_library）
  recordings/        あらゆるソースからの生録音（デフォルト recordings.folder）：読み取り専用
  _scratch/          プロジェクトフォルダがない場合のツールボックス出力
  <channel>/         チャンネルごとのフォルダ
    studio.json      そのチャンネルのプロフィール
    <ProjectName>/   動画ごとのフォルダ。Resolveプロジェクト名と完全に一致させる
      plan.md, script.json, short.json
      audio/          ナレーション、ミックス
      capture/        この動画のために作成された画面録画
      transcripts/    ファイルごとの文字起こし + <timeline>.timeline.*（タイムライン時間）
      timeline/       キャプチャしたトラックレイアウト
      animations/     HyperFramesプロジェクトとレンダリング
      builds/, renders/, audio_preview/

シングルチャンネルスタジオでは、studio.json とプロジェクトフォルダを <studio>/ 直下に置いてもよい。これでも動作する。

• Resolveが開いている場合は project_manager get_current でプロジェクト名を取得する。開いていない場合はユーザーと合意する。 必要なときに初めてフォルダを作成する。
• プロジェクトファイルをスタジオルート、別のチャンネルのフォルダ、またはソース録音の隣に書き込まないこと。

3. 生録音は読み取り専用

• 録音フォルダ（recordings.folder）には決して書き込まない：上書き、削除、名前変更、サイドカーファイルの作成を行わない。 処理済みメディアはコピーとしてプロジェクトフォルダに配置し、メディアプールを通じて差し替える。
• 文字起こしには recordings.mic_audio_stream を使用する。録音に追加のオーディオトラック（デスクトップ音声、マイクの複製など）がある場合は、それを指摘し、許可なく削除またはミュートしないこと。

4. 依頼がない限り触らない

• 音声： ユーザーが依頼しない限り、音声のEQ、ノイズ除去、圧縮、ノーマライズを行わない。
• 映像： ユーザーが依頼しない限り、グレーディングやシャープネス調整を行わない。

5. 作業方法

• 確定前のプレビュー： 音声・映像の変更については、短いビフォーアフターサンプルを <project>/audio_preview/（または類似フォルダ）にレンダリングし、ユーザーに判断させる。
• 提案してから適用： タイムラインを変更する前に、提案するカット、トリガーポイント、オーバーレイ配置を表示する。
• オーバーレイ → Resolve： HyperFramesプロジェクトを <project>/animations/ に作成し、mov（アルファチャンネル付き）でタイムラインのfpsでレンダリングし、インポートして空のビデオトラックに配置する。別のセッションが animations/ で作業している可能性がある場合は、1回限りのオーバーレイを別のフォルダに独自のHyperFramesプロジェクトとして作成する。
• 顔安全ゾーン： カメラ映像がある場合、カードを配置する前に顔の位置を測定する（ffmpegでフレームをタイル表示）。顔を決して覆わないこと。
• プライバシー： channel.never_show に記載されているものを決して表示しない。画面録画はその時点の画面をキャプチャするため、最初と最後のフレームですべてのクロップを確認すること。
• 音声ライブラリ： 生成する前に検索し、ユーザーの判定を sfx_mark で記録する。ライブラリファイル（却下されたものも含む）を決して削除しない。選択したものは空のオーディオトラックに配置し、Audio 1には決して配置しない。