Bookflow Studio
このスキルは、実際のブック動画エピソードを扱う場合、またはクリエイターがこのワークフローのデモを依頼した場合に使用します。まず、リポジトリの AGENTS.md と docs/workflow.md を読んでください。エピソードファイルの記入やトラブルシューティングの際は docs/project-format.md を使用します。
エピソードを実行する
クリエイターが選択したエピソードフォルダ内で作業します。フォルダが存在しない場合は、どの本を取り上げたいか、または推薦を希望するかを尋ねてください。黙ってプロモーションする商品を選んではいけません。新しいエピソードを作成するには npm run bookflow -- init <episode-folder> を使用し、既存のファイルは保持します。
以下の成果物を通じてクリエイターをガイドし、該当する場合はCLIを使用します。
- 正確なタイトル、著者、版、対象読者を確認します。適切な公開情報源から事実を調査し、URLと各情報源が裏付ける内容を
sources.mdとclaims.csvに保存します。クリエイターが読書メモサービスを接続しており、その使用を許可している場合は、アクセス可能なメモのみをトピックのシグナルとして使用します。長いパッセージをコピーしたり、ハイライトを公開事実として扱わないでください。 - オリジナルのナレーションを
script.mdにドラフトします。事実に基づく情報と、解釈や個人的な経験を分けて記述します。クリエイターが参考動画を提供した場合は、その構造、ペース、おおよその長さを分析しますが、そのセリフを再利用しないでください。参考動画にアクセスできない場合は、その旨を伝え、制限を明確にします。 - 完全なスクリプトを表示し、制作メディアの準備に入る前に明示的な承認を待ちます。話すビートごとに1つの安定したセグメントIDを維持します。スクリプトの作成または修正のみのリクエストは、このレビューゲートで終了します。
- スクリプト承認後、
storyboard.csvを作成し、各話すセグメントを正確に一致させ、関連するビジュアル、出典/権利、画面上のテキスト、動き、および時間を指定します。ストーリーボードを表示し、制作アセットの調達または生成を行う前に承認を待ちます。 - ストーリーボード承認後、現在の環境で実際に利用可能なメディアツールのみを使用します。アセットの出典と権利を記録します。ナレーションには、クリエイターの録音または明示的に承認された音声ソースを使用します。WhisperなどのASRツールが利用可能な場合は、そのタイムスタンプを出発点として使用し、実際の音声トラックと照合します。中国語の字幕は正確に保ち、オプションの英語は携帯電話で読めるようにします。SRTのエクスポートは
npm run bookflow -- export-srt <episode-folder>で行います。 - 適切なエディタやレンダラー(例:HyperFrames や CapCut)が利用可能な場合のみ、動画をアセンブルしプレビューします。このリポジトリのCLIが画像、音声、または動画を生成することは主張しないでください。これはエピソードファイルの準備、構造/アライメントのチェック、字幕のエクスポートを行うものです。ここでのツール名はオプションの統合であり、バンドルされた依存関係ではありません。
docs/integrations.mdを参照してください。 - リリース候補として
npm testとnpm run bookflow -- check <episode-folder> --releaseを実行します。自動チェックで何が確認でき、何が確認できないかを説明します。クリエイターは、事実の正確性、権利、モバイルでの読みやすさ、レンダリングされた動画を依然としてレビューする必要があります。
Bookflow Studio自体を紹介する動画の場合は、このリポジトリに存在し、実行して検証された機能のみを説明します。CodexガイドのワークフローとCLIの具体的な機能を区別し、計画中またはツールに依存するメディア生成がコードによってすでに自動化されているように提示しないでください。
エピソードアセットとプライベート作業は公開リポジトリの外に保管します。認証情報、生の音声、アカウントデータ、無許可のカバー、音楽、スクリーンショット、顧客メディアをコミットしないでください。