絵本ストーリーボード生成
本ファイルは、エントリ、提供構造、実行順序、検証という編成レイヤーのみを規定します。ストーリー作成、描画プロンプト、動画プロンプトの各ルールとテンプレート原文は、すべて以下のファイルにあり、本ファイルはその内容を保持せず、再掲もしません。
| ファイル | 担当内容 |
|---|---|
references/story.md | ストーリー部分の全ルールと実行手順。同ファイルが自ら規定します |
references/creativity-path.md | オプションのクリエイティブパス(デフォルトではオフ):インターフェース契約と交換可能な値のソース |
references/drawing-prompt.md | 描画プロンプト部分のルール。テンプレート原文と描画ネガティブ文字列(スキル全体で唯一のコピー)を含む |
references/video-prompt.md | 動画プロンプト部分のルール。動画ネガティブ文字列と完成形テンプレート(スキル全体で唯一のコピー)を含む |
references/voice-prompt.md | 音声プロンプト部分のルール。音声ネガティブ文字列、完成形テンプレート、3プラットフォームのフィールドマッピング(スキル全体で唯一のコピー)を含む |
references/mcp-setup.md | 描画プロンプト最適化のMCP設定ガイド。現在は無効で実行に参加せず、有効化時にのみ読み込まれます |
references/example.md | 完成フォーマットのサンプル。スクリプトの回帰テスト用 |
scripts/pick_direction.py | クリエイティブパスに必要な値のソース(オプション) |
scripts/check_storyboard_md.py | 2つのテンプレート原文で完成品を文字単位で照合 |
前提条件
絵本のテーマはユーザーが提供します。単純なテーマ(主体とシーンのみ)でも、プロットを含むテーマ(要望と障害を含む)でも構いません。テーマが不足している場合は、references/story.md に従って候補ソースを処理し、ユーザーが選択します。ソースに結果がない場合は終了し、テーマを要求します。スキル側で勝手にテーマを決めたり、事前にサンプルを出力したりしてはいけません。
対外エントリ
| トリガー入力 | 提供内容 |
|---|---|
| 絵本のテーマ(例:「月と小さな星」) | 絵本のストーリーボードパック一式。各グループ6行。グループ数のデフォルト値は references/story.md で規定 |
| テーマが与えられず、スキルにテーマ選択の権限が与えられた場合 | 複数の候補テーマ(テーマ名、一言の方向性、主体、環境)。ストーリーボードを直接生成せず、選択後に上記の出力に従う |
ユーザーが動画プロンプトや画像生成動画プロンプトのみを要求した場合、その内容はスキルの内部部分であり、単独では提供しない旨を一文で説明し、絵本のテーマを提供するよう依頼します。テーマが提供された後、動画プロンプトは各グループの「→ 動画プロンプト:」の次の行に書き込みます。このような要求を満たすために、ストーリーボードを逆算してはいけません。
提供構造(必須、変更不可)
各グループは厳密に6行で、順序は固定です:
【第 X カット】
英文短句
→ 中文訳
→ 描画プロンプト:<references/drawing-prompt.md のテンプレート原文を文字通り埋める>。ネガティブ:<同ファイルの描画ネガティブ文字列>
→ 動画プロンプト:<references/video-prompt.md の完成形テンプレート。末尾にネガティブ文字列が付与されている>
→ キーワード:【color / size / action verb / place】
→ 音声プロンプト:<references/voice-prompt.md の完成形テンプレート。末尾に音声ネガティブ文字列が付与されている>
5つの強制制約:
- 英文短句は最初の行を独占し、引用符、括弧による注釈、カット説明を使用しない。
- 描画ネガティブ文字列は描画プロンプトと同じ行の末尾に「ネガティブ:」で付加する。改行せず、グループ末尾でまとめない。
- 動画プロンプトは描画プロンプトの次の行に続き、1段落に圧縮し、①②③などのラベルを付けず、独立したセクションにしない。
- キーワードは5行目に固定し、4項目の順序は変更不可。各項目はそのカットの具体的な内容に対応する。
- 音声プロンプトは6行目(グループの最終行)に固定し、読み上げテキストは1行目の英文短句と一字一句一致させる。パラメータはオーディオモデルに入力可能なフィールドとして記述する。
ファイルレベルの注記:最初の「【第 X カット】」の前に、各行の動画秒数と予算秒数を記述した読み上げ予算行を1行挿入する。これは独立した音声モデルの調整用であり、ファイルレベルの注記とし、グループ内には挿入せず、各グループの6行構造を変更しない。
実行順序
references/story.mdに従ってストーリー部分を完了し、各グループの英文短句と中文訳を生成する。references/drawing-prompt.mdに従って描画プロンプト部分を完了し、各グループの描画プロンプト行とキーワード行を生成する。描画最適化は現在オフ(「外部機能:描画プロンプト最適化」参照)。直接生成し、検出も呼び出しもしない。references/video-prompt.mdに従って動画プロンプト部分を完了し、各グループの動画プロンプト行を生成する。references/voice-prompt.mdに従って音声プロンプト部分を完了し、各グループの音声プロンプト行を生成する。- 以下のコマンドを実行して検証する:
python scripts/check_storyboard_md.py <成果.md> --theme "<テーマ>"。エラーは修正してパスさせる。音声は独立した音声モデルで後処理し、動画に直接出力しない。実測の読み上げ秒数が取得できた場合は、--voice-seconds "1:3.8,2:4.2"で再検証する。予算を超える場合は、その文をまず短くし、動画時間は延長しない。
連携要件:後続のステップは前のステップの成果に基づく。後続のステップが前の段階と矛盾する場合は、前の段階を修正し、後続のステップ内で強引に整合させてはいけない。スクリプトはフォーマットとテンプレートの一貫性のみを検証する。セマンティクスが英文短句に厳密に従っているかどうかは、各 reference ファイルの内容による自己チェックが担当する。
外部機能:描画プロンプト最適化(オプション)
現在の状態:無効。 prompt-optimizer はまだ完全ではなく、デフォルトの実行では検出、確認、設定、呼び出しを行わず、references/mcp-setup.md も読み込みません。描画プロンプトは references/drawing-prompt.md に従って直接生成します。以下の各サブセクションは、有効化時に使用するためのルールとして保持されます。ユーザーが会話内で明示的に「描画プロンプト最適化を有効にする」と述べない限り、一切実行しません。
有効化後、描画プロンプトの作成後、このMCPに4つのスロットがすでに埋められた完成テキストに対して、表現レベルの最適化を依頼できます。このMCPは後処理であり、プロンプト生成を担当しません。つまり、文意を理解し、平易な言葉で絵を決定し、スロットを埋め、テンプレートを組み立て、ネガティブ文字列を追加する既存のロジックはそのまま実行され、MCPはその後にスロット内のテキストを書き換えるだけです。有効かどうかに関わらず、描画部分の生成方法は変わりません。MCPがない場合は、単に潤色が1回減るだけで、生成パスが失われるわけではありません。
この機能は必須ではありません。欠落している場合や使用できない場合でも、提供をブロックせず、また、これを使用するために生成を遅らせたり放棄したりしてはいけません。有効化後、MCPの設定は、ユーザーの確認後に現在のエージェントが実行します。設定ファイルの特定、バックアップ、エントリのマージ、検証と書き戻しを、すべて references/mcp-setup.md の「現在のエージェントが実行する設定手順」に従って行います。
呼び出し契約(無効時は参考用)
MCPへの入力は1つだけです:そのグループで生成された描画プロンプトです。それ以外のコンテキストは一切持ち込みません。
- 入力:そのグループの描画プロンプトの完全なテキスト。テンプレートの先頭「【画面比率】」から、ネガティブ文字列の末尾まで。「→ 描画プロンプト:」などのラベル、グループ番号、前後の説明は付けない。
- 出力:3つのスロット内のテキストのみを採用する。テンプレートの固定文とネガティブ文字列は、本スキルの原文を優先し、MCPから返されたバージョンは採用しない。
- 禁止事項:絵本のテーマ、英文短句と中文訳、キーワード行、動画と音声行、他のグループの内容、ストーリーカード、スタイル要件、会話履歴、スキルルール。プロンプトの前後に「まずこのストーリーを理解してください」「これは児童絵本です」などの背景説明を付けてはいけません。また、複数のグループのプロンプトを1つのリクエストにまとめてはいけません。
- 1回1グループ:呼び出しは現在のグループのみを処理します。前のグループの返却テキストを次のグループの入力に混入させてはいけません。グループ間のクロスコンタミネーションを避けるためです。
- 必須フィールド:ツールスキーマに他に必須フィールドがある場合、「このプロンプトを最適化する」ことに直接関連する中立的な値(言語、タスクタイプなど)のみを入力し、そのフィールドを使ってテーマやストーリー内容を補足してはいけません。
- 往復しない:1回の呼び出しで1回採用。追加の質問や複数回の明確化は行いません。返された結果が使用できない場合は、「最適化結果の制約」に従ってロールバックします。
実行前検出(無効時は参考用。有効化後、処理開始前に1回実行)
検出はステップ1の前に行います。全体で1回のみ、グループ内で繰り返し確認しません。
MCPリストの取得:現在のセッションにマウントされているMCPサービスと利用可能なツールのリストを読み取り、prompt-optimizer(http://47.251.140.61:8081/mcp)とその提供するツールが存在するか確認します。リストが直接読み取れない場合は、prompt optimizer をキーワードとしてツールを検索します。判定は「サービスが存在し、そのツールが呼び出し可能であること」を基準とし、会話内でURLが登場したかどうかではありません。推測でツール名を捏造してはいけません。
| 検出結果 | 対応 |
|---|---|
| マウント済み | インストールについて確認や提案はしないが、ユーザーに対して今回の処理でこのMCPを呼び出して描画プロンプトを最適化することを明示する(一行の状態説明。ポップアップはなし)。その後、すぐに「呼び出し契約」に従って使用する |
| 未マウント | 確認ダイアログでインストールが必要かどうかを尋ねる。文言は、これはオプションの描画プロンプト2次最適化機能であり、インストールしなくてもストーリーボードの生成には影響しないことを説明する。オプションは2つ:すぐに設定する、設定しない |
| すぐに設定を選択 | references/mcp-setup.md を読み込み、現在のエージェントがその「現在のエージェントが実行する設定手順」に従って設定を完了する:クライアントと設定ファイルの位置を確認し、バックアップ、エントリのマージ、JSONの検証。その後、MCPリストを再読み込みして再確認する。再確認に合格したら、ユーザーに「設定が成功しました。以降、prompt-optimizer を呼び出して描画プロンプトを最適化します」と明示し、続けてステップ1に進み、ステップ2で最適化を有効にする |
| 設定しないを選択 | 今回の処理では以降プロンプトを表示せず、最適化を完全にスキップし、元のプロンプトで提供する |
- 現在のエージェントに書き込み権限がない、設定ファイルが見つからない、またはクライアントが認識するために再起動が必要な場合:そのファイルの設定手順全体をユーザーに送信し、ユーザーが実行または再起動する必要があることを説明する。このセッションでは未マウントとして続行し、待機もブロックもせず、提供説明にその旨を記載する。
- 拒否はこのセッション内でのみ記憶し、長期的な設定に書き込んだり、スキルファイルを変更したりしない。次回の実行時には、このセクションに従って再度検出し、再度確認する。
- ポップアップ機能が使用できない場合は、短い質問文で代用し、質問と2つのオプションは変更しない。
- ユーザーがすぐに設定を選択したが、ステップ2までに有効にならなかった場合(インストール未完了または未再起動)、2回目のダイアログは表示せず、未マウントとして続行し、提供説明にその旨を記載する。
グループ内呼び出し(無効時は参考用。有効化後、各描画行の作成後に実行)
- 各グループの描画行作成後に1回呼び出す。パラメータは「呼び出し契約」に従う。
- 呼び出しは可視であること。サイレント呼び出しは不可。呼び出し前に、呼び出し対象とそのグループを示す一行の状態を出力する。例:「prompt-optimizer MCP を呼び出して第3グループの描画プロンプトを最適化します」。呼び出し後、結果の一行(採用されたか、ロールバックされたか、理由を添えて)を出力する。
- 呼び出し成功:3つのスロット内のテキストのみを抽出し、「最適化結果の制約」に従って再確認後、そのグループの描画行に書き戻す。テンプレートの固定文とネガティブ文字列は、本スキルの原文を優先する。
- 呼び出し失敗、タイムアウト、または空の結果が返ってきた場合:最大1回再試行。それでも失敗した場合は、そのグループをスキップし、「未最適化(接続失敗)」とマークし、処理を続行する。
- グループ内でユーザーに確認を求めたり、設定を繰り返し確認したり、単一グループの失敗で前のグループに戻って再実行したりしない。
最適化結果の制約
- 表現のみを最適化し、絵の内容を再決定しない。 主体が誰か、数、姿勢、向き、インタラクション、シーン、照明は変更してはいけない。許可される変更は、表現、可視詳細の精度、語順のみ。スロットを空にしたり、既存の情報を削減したり、2つ目のアクションに拡張したりしてはいけない。
- テンプレートの固定文は一字一句変更しない。 「、児童絵本風イラスト」から「柔らかな陰影、硬い影なし、低年齢向け、画面に内蔵テキスト、透かし、署名なし」までの原文は、追加、削除、変更してはいけない。3つのスロット(画面主体、主体のインタラクション、環境シーン)内のテキストのみ、書き換えが許可される。
- ネガティブ文字列は変更しない。 最適化テキストには「ネガティブ:」とそれ以降の内容を含まない。ネガティブ文字列は、本スキルが行末に追加する。
- 事実上の制約は変更しない。 英文短句に存在しないキャラクター、小道具、シーンを新たに追加してはいけない。書き換え後も、その文から逆算可能でなければならない。
- スクリプトを優先する。 最適化後のグループは、再度
check_storyboard_md.pyによる検証に合格しなければならない。合格しない場合は、そのグループの最適化前の原文にロールバックし、ロールバック理由を記録する。 - 下流は確定版を基準とする。 ステップ3の動画プロンプトとステップ4の音声プロンプトは、最適化後の描画行を読み取る。最適化によって姿勢やシーンが変更された場合は、そのグループの動画行を書き直し、最適化前のバージョンを使用してはいけない。
提供時の注記
無効時は、最適化に関する注記は一切行わない。有効化後は、提供説明に、どのグループがMCP最適化されたか、どのグループがスキップされたかとその理由(未設定、ユーザー拒否、接続失敗)を記載する。どちらの場合も、成果行内にマークを書かず、6行構造を変更しない。
成果物と読み込みの契約
本スキルのコンテキストオーバーヘッドは、主に2つの要素によって決まります:reference 全体を繰り返し読み込むかどうか、および中間結果が会話内にのみ存在するかどうかです。両方とも制約する必要があります。
1. 成果物の契約
完成したMarkdownは、全プロセスを通じて唯一の累積キャリアです。各ステップは自分の部分のみを書き込み、下流は成果物のみを読み取り、上流の内容を再掲しません。
| ステップ | 成果物 | キャリア |
|---|---|---|
| 1 ストーリー | ストーリーカード:主体リスト、環境、要望、障害、解決、結末。各グループの英文と中文訳 | 成果ファイルのグループタイトルと最初の3行 |
| 2 描画 | 各グループの描画プロンプト行(ネガティブ文字列含む)、キーワード行 | 同じファイル、グループごとに追加 |
| 3 動画 | 各グループの動画プロンプト行(ネガティブ文字列含む)。ファイルヘッダーの読み上げ予算行 | 同じファイル、該当グループの描画行の後に挿入。予算行は第1グループの前に1回のみ書き込み |
| 4 音声 | 各グループの音声プロンプト行(ネガティブ文字列含む) | 同じファイル、該当グループのキーワード行の後に追加 |
| 5 検証 | スクリプト出力 | コマンドのエコー。ファイルに保存しない |
- グループごとに進める:1つのグループを完了してから次のグループに入る。先にすべてのグループの文を書き出してから、後でプロンプトを補完してはいけない。
- 中間内容は、成果ファイルまたは会話内のグループブロックに書き込んだ後は、再掲しない。修正時はそのセクションのみを変更し、全体を書き直さない。
- 成果ファイルはデフォルトで、スキルディレクトリと同じ階層の
outputディレクトリ、すなわち<スキルディレクトリ>/../output/に配置する。ファイル名は《テーマ》-ストーリーボードとプロンプト.md。ディレクトリが存在しない場合は作成する。ユーザーが出力パスを明示的に指定した場合は、ユーザーの指定を優先する。
2. 読み込みの契約
ステップごとに必要な部分のみを読み込み、全体をロードしない。既読の内容は再読み込みしない。テンプレート原文は、記述時にのみ参照し、応答内で再掲しない。
| ステップ | 必須読み込み | 必要に応じて読み込み | 読み込まない |
|---|---|---|---|
| 1 ストーリー | story.md の第2、5、6、7、8、9節 | 第1節のクリエイティブ原則、第3節の3つの質問(自己チェック時)。クリエイティブパス有効時は creativity-path.md を代わりに読み込む | 第10節の削除記録。未有効時の creativity-path.md |
| 2 描画 | drawing-prompt.md のテンプレート原文、描画ネガティブ文字列、スロット対応表、組み立てルール | 出力順序(ユーザーが出力を要求した場合のみ)。破損修正方法(手直し時のみ) | ソース説明セクション。mcp-setup.md(最適化無効時は読み込まない) |
| 3 動画 | video-prompt.md の完成形、言語時間と画面マージン、2ステップ理解、5次元詳細 | アクション語彙リスト(主体タイプに一致するセグメントのみ読み込む)。自己チェック表(初回使用時または不合格時) | サンプルA/B(フォーマット習得後) |
| 4 音声 | voice-prompt.md の完成形、パラメータ口径、4要素の記述方法 | プラットフォームフィールドマッピング(プラットフォーム変更時)。自己チェック表(初回使用時または不合格時) | サンプル(フォーマット習得後) |
| 5 検証 | 検証コマンド | example.md(フォーマット回帰テスト時のみ、かつテンプレートのみを参照) | その他すべて |
example.mdはデフォルトでは読み込まない。フォーマットは本ファイルの提供構造ですでに定義されており、サンプルを使ってレイアウトを確認する必要はない。- 6グループで同じテンプレートと一連のネガティブ文字列を共有するため、1回読み込めば十分。第2から第6グループを書く際に、同じファイルを再度ロードしてはいけない。
- コンテキストがすべての成果物を収容できない場合、成果ファイルを基準とし、その内容に従って続きを書き、既に完了したグループを再生成しない。
参照規律
- テンプレート原文、描画ネガティブ文字列、動画ネガティブ文字列、音声ネガティブ文字列は、それぞれ対応する reference ファイルにのみ存在する単一のコピーである。他のファイルに現れた場合はエラーとみなす。
- 埋め込み時は、全文をコピーしてスロットを置き換える。テンプレートの文構造を再構成したり、セミコロンで区切られた固定の短いフレーズを省略したりしてはいけない。
- テンプレートの固定文と既定の口径が矛盾する場合は、テンプレートを優先する。口径の調整が必要な場合は、テンプレートファイル自体を修正し、同時に検証を実行する。
- 音声の音色、ピッチ、音量は6グループ間で一貫させる。感情とアクセントのみが文に応じて変化する。他のオーディオプラットフォームに切り替える場合は、
voice-prompt.mdのマッピングテーブルに従って換算し、フィールドのセマンティクスを変更しない。
提供方法
- 会話内で完全な内容を直接出力する(グループ数は
references/story.mdに従い、各グループ6行)。要約による代替は提供しない。 - ユーザーがファイルを要求した場合、デフォルトでMarkdownをスキルディレクトリと同じ階層の
outputディレクトリに《テーマ》-ストーリーボードとプロンプト.md として書き込み、検証スクリプトを実行する。ユーザーがパスを明示的に指定した場合はその限りではない。