Communitygithub.com

zyyzyy860-netizen/マイブック動画ワークフロー

Codexをガイドとして、調査主導のブックショート動画制作を実現します。Bookflowのエピソードファイルとチェック機能を活用。クリエイターがこのリポジトリを使って本の動画を企画、制作、レビューしたいときに使用します。

マイブック動画ワークフロー とは?

このスキルは、Codex AIエージェントが「Bookflow Studio」リポジトリに基づいて、本を紹介するショート動画の制作ワークフローを支援するためのものです。主にClaude CodeやCodexのようなターミナルベースのAIエージェントで使用することを想定しており、クリエイターが本の動画エピソードを企画、制作、レビューする際に役立ちます。スキルはリポジトリ内の`AGENTS.md`と`docs/workflow.md`をまず読み込み、`npm run bookflow` CLIコマンドを活用してエピソードファイルの初期化、構造チェック、SRT字幕のエクスポートなどを行います。ワークフローは、タイトルと対象読者の確認、オリジナル脚本の作成、ストーリーボードの構築、メディアアセットの調達、動画のアセンブリとプレビュー、そして自動チェックを経てリリース候補を生成するまでの7つのステップで構成されています。重要なのは、このCLIは画像や音声、動画を生成するものではなく、あくまでエピソードファイルの準備、構造とアライメントのチェック、字幕のエクスポートを行う点です。AIエージェントは、実際に利用可能なメディアツールのみを使用し、スクリプトとストーリーボードの各段階でクリエイターの承認を得る必要があります。また、著作権やプライバシーに配慮し、認可されていない素材をリポジトリにコミットしないよう徹底します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/zyyzyy860-netizen/my-book-video-workflow/tree/HEAD/skills/bookflow

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Bookflow Studio

このスキルは、実際のブック動画エピソードを扱う場合、またはクリエイターがこのワークフローのデモを依頼した場合に使用します。まず、リポジトリの AGENTS.md と docs/workflow.md を読んでください。エピソードファイルの記入やトラブルシューティングの際は docs/project-format.md を使用します。

エピソードを実行する

クリエイターが選択したエピソードフォルダ内で作業します。フォルダが存在しない場合は、どの本を取り上げたいか、または推薦を希望するかを尋ねてください。黙ってプロモーションする商品を選んではいけません。新しいエピソードを作成するには npm run bookflow -- init <episode-folder> を使用し、既存のファイルは保持します。

以下の成果物を通じてクリエイターをガイドし、該当する場合はCLIを使用します。

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

Bookflow Studio自体を紹介する動画の場合は、このリポジトリに存在し、実行して検証された機能のみを説明します。CodexガイドのワークフローとCLIの具体的な機能を区別し、計画中またはツールに依存するメディア生成がコードによってすでに自動化されているように提示しないでください。

エピソードアセットとプライベート作業は公開リポジトリの外に保管します。認証情報、生の音声、アカウントデータ、無許可のカバー、音楽、スクリーンショット、顧客メディアをコミットしないでください。

関連スキル