Communitygithub.com

worldwonderer/drama-skills

AI 短剧/漫剧创作 skill 合集,覆盖剧本、资产、分镜、图片/视频提示词到独立审查全链路,适配 Claude Code 与 Codex。

drama-skills とは?

このスキルは、AIエージェント(Claude Code や Codex など)上で動作する短編ドラマ/マンガドラマ制作のための統合ツール群です。脚本開発、キャラクター・背景などのアセット作成、ストーリーボード、画像・動画プロンプト生成、そして独立したレビューまで、制作の全工程をカバーします。ユーザーは意図に応じて適切なサブスキル(例: $short-drama-write で脚本、$short-drama-video-prompts で動画プロンプトなど)へルーティングされ、一貫したワークフローで進行できます。プロジェクト状態は `short-drama.json` で管理され、トランザクション復旧や外部編集の衝突検出など、堅牢なデータ整合性を備えています。また、ブラウザベースのローカルダッシュボードも提供し、プロジェクトと脚本の閲覧・編集を直感的に行えます。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add worldwonderer/drama-skills

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

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

ドキュメント

短編ドラマ制作ルーティング

これは軽量なプロジェクトルーティングであり、このスキル内でストーリー、アセットプロンプト、ショット、動画プロンプト、または最終レビューを代わりに作成するものではありません。

クリエイターが読むべき内容は、プロジェクト short-drama.json#/language(ステータス、差分、選択、次のアクションなどすべて)に従います。 画像・動画生成器に送るプロンプト本文は #/format/prompt_language(デフォルト en)に従います。 これらは別々のフィールドであり、一方から他方を推測してはなりません。status は両方の値を同時に報告します。 完全なルールは contract-and-ownership.md の出力言語契約を参照してください。

各リクエストの開始点

  1. ユーザーが明示したパスを使用するか、カレントディレクトリから上方向に最も近い short-drama.json を探します。
  2. このスキルのインストールディレクトリから同じスイートの他のスキルを見つけ、suite-manifest.json を読み取ります。スキルが不足しているかバージョンが混在している場合は、変更を停止します。
  3. short-drama.json と .short-drama/state.json のサマリーのみを読み取ります。一度にすべての作成ファイルをロードしないでください。
  4. status を実行するか書き込みを行う前に、まずトランザクションリカバリを実行します。外部編集の競合を検出した場合は元のファイルを保持し、adopt、restore、merge の3つの処理を提供します。静かに上書きしないでください。
  5. クリエイターの現在のタスクに従ってルーティングします。パイプライン全体を強制的に完了させる必要はありません。

エントリポイント、チェックポイント、改訂、および納品については creator-workflow.md を参照してください。 各エントリポイントでは最初に runtime-preflight.md を実行し、インストールの確認、トランザクションの復元、プロジェクトステータスの読み取りを統一的に行います。 所有権、ファイルの期限切れマーク stale、プライバシー、またはリカバリに関する疑問がある場合は、 contract-and-ownership.md を読んでください。 意図が不明瞭な場合は routing-examples.md を読んでください。 ルールIDを担当スキルにマッピングする必要がある場合にのみ knowhow-index.md を読んでください。ルーティングは割り当てのみを行い、作成スキルの判断を代行しません。 参照画像が何を決定できるか、および最初と最後のフレームの契約については reference-roles.md を参照してください。 観客が現時点で知ることができることについては audience-reveal.md を参照してください。 追加撮影と代替バージョンとマスター版の関係については pickup-and-alternate.md を参照してください。 異なる制作形態の実行翻訳については production-form-profiles.md を参照してください。 正式なストーリーボードの前に、キャラクター、場所、高圧力の代表フレームを使用して視覚言語を統一する必要がある場合は、 look-development.md を読んでください。

意図ルーティング

クリエイターの意図ルーティング先
アイデアの開発、ストーリーの約束、シリーズ、エピソードマップ$short-drama-develop
小説・長尺素材のインポートと、トレーサブルなエピソード分割とアセット候補プレビュー$short-drama-novel-analyze → $short-drama-develop → 翻案/エピソード分割を受け入れる → $short-drama-write → 脚本を受け入れる → $short-drama-assets
長編が改作に値するか判断する、まずサンプルクイックレビューを見る$short-drama-novel-analyze
単話契約、因果ビート、脚本の執筆/修正$short-drama-write
キャラクター/造形、場所/ビュー、プロップ/状態の分解$short-drama-assets
キャラクター/場所/プロップ/部分修正の画像プロンプト執筆$short-drama-image-prompts
原文カバレッジ、ショットまたはフリーズフレームの作成$short-drama-storyboard
アクション/演技/カメラワーク/サウンドの動画プロンプト執筆$short-drama-video-prompts
作画スタイル、制作形態、またはビジュアル方向性の決定$short-drama 自身: production-form-profiles.md に従って1枚の形態カードを特定し、候補を生成してクリエイターに受け入れてもらい、その後 creator_authority に昇格させます。アセット、画像プロンプト、ストーリーボード、動画プロンプトはすべて形態が決定していることを要求し、いずれも独自に選択しないため、このステップはここで完了する必要があります
Look Development / スタイルフレームの作成$short-drama でまず観察可能なビジュアル方向性を明確にして受け入れる → $short-drama-image-prompts で lookdev_frame テキスト仕様を書く。画像は生成せず、スタイル参照がアイデンティティ、地理、またはプロット状態を引き継がないようにする
承認された制作観察で本プロジェクトを校正する$short-drama-review で正確なバージョンをバインドして診断 → 対応する owner が preserve_set 付きのピンポイント改訂 → 再受け入れと fresh re-review。承認された観察がない場合はテキストリスクのみ報告
検証、レビュー、または改訂リクエストの発行$short-drama-review
テンプレート感やAI臭のチェック・診断のみfresh $short-drama-review、エビデンス付き finding のみ発行
AI臭の除去、ブラッシュアップ、またはピンポイント修正$short-drama-write、作者の声を保持し意味的差分を表示
まずチェックしてから修正fresh review → write owner がピンポイント改訂 → fresh re-review
ダッシュボード、短編ドラマ作成台、または作成コンテンツの管理を開く$short-drama dashboard:以下の「ローカルダッシュボード」起動契約を実行

クリエイターの明確な意図は、名目上の「次のチェックポイント」よりも優先されます。Look Development はオプションのプロジェクトレベルのブランチであり、汎用的な前提条件ではありません。 C2 アセットが受け入れられた後、画像プロンプトとストーリーボードは並行ブランチです。クリエイターが一方のみを必要とする場合、もう一方を待つよう強制しません。

現在のコンテキストがターゲットファイルの作成に参加した場合、レビュールーティングは新しいフレッシュなレビュアーエージェント/コンテキストを優先して起動し、ターゲット、受け入れられた制限、レビューシートのみを渡す必要があります。実行環境がフレッシュエージェントをサポートしていない場合は、透過的に PROVISIONAL セルフチェックにダウングレードし、Skill 名の切り替えを独立したレビューとみなさないでください。

「テンプレート/AI で書かれたように見える」は診断リクエストです。「それを直す」は owner 改訂リクエストです。write owner に自己診断させてから自分自身に結論を出させることはできません。また、レビュアーが権限を超えて本文を直接修正することもできません。組み合わせリクエストはまずターゲットバージョンを凍結し、フレッシュレビュアーがエビデンスと損失を特定し、write owner に受け入れられた範囲のみを修正させ、最後に新しいフレッシュレビュアーが新しいハッシュに対して再レビューを行います。独立したコンテキストを取得できないステップはすべて PROVISIONAL のままにします。

初期化

プロジェクトがなく、ユーザーが初期化を要求した場合:

  1. 可逆フォーマットのデフォルト値のみを確認または合理的に推測します:タイトル、言語、プロンプト言語、アスペクト比、パス。 エピソード数/尺が不明な場合は空欄のままにします。言語はクリエイターが現在使用している言語をデフォルトとし、プロンプト言語はデフォルトで en とします。 クリエイターがプロンプトにもプロジェクト言語を使用するよう明示的に要求した場合はクリエイターに従い、品質上の結果を代わりに判断しません。
  2. プロジェクトテンプレートをコピーします。既存のクリエイターファイルは上書きしません。
  3. 空のステージディレクトリと非公開入力境界を確立します。
  4. short-drama.json#/creator_authority に空のクリエイター制限、ビジュアル方向性、制作設定を確立します。 これらは初期状態で unset であり、アセットとその下流はすべて形態が決定していることを要求します。したがって、初期化後はクリエイターに次のように伝えます: 制作形態を決めることが次に最も有益なアクションです。エントリはこのスキル(意図ルーティングテーブル参照)にあり、サブスキルにはありません。 実際の選択は creator-decision.example.jsonl に示されている決定記録に書き込まれます。
  5. スイートバージョン、契約バージョン、および5つの相互に独立した空の状態を記録します。
  6. プロジェクトパスと最も有益なクリエイターアクションを通知します。

初期化ではストーリーエンジン、スクリプト、アセット設定テーブルは生成しません。

開発段階で プロジェクト開発/director-brief.md が提出された場合、まずクリエイターにその内容と現在の visual_direction / production_profile との意味的差分を表示します。明確に受け入れられた場合のみ、ルーティングは該当する選択を short-drama.json#/creator_authority に昇格させます。候補ファイル自体はクリエイター権限を持ちません。

ローカルダッシュボード

ユーザーが $short-drama dashboard を呼び出した場合、サブスキルに引き継がず、このスキルに組み込まれたローカル短編ドラマ作成台を直接起動します。

  1. まず runtime-preflight.md に従ってスイートを確認し、未完了のトランザクションを復元します。

  2. 作業ディレクトリが何らかのプロジェクト内にある場合は、そのプロジェクトルートを workspace とします。それ以外の場合は、ユーザーが明示的に指定したコンテナディレクトリを使用します。指定がない場合はカレントディレクトリを使用します。workspace の外部はスキャンしません。

  3. このスキルのインストールディレクトリから実行します:

    python3 <short-drama-skill-dir>/scripts/dashboard_server.py --workspace <workspace> --port 0 --open
    
  4. プロセスを実行し続け、スクリプトが出力する完全なループバックアドレス(今回の起動のセッションフラグメントを含む)と停止方法を報告します。ブラウザが自動的に開けない場合は、サービスを維持し、ユーザーにその完全なアドレスを開いてもらいます。

ダッシュボードには1つの作成ページのみがあります。左側はプロジェクトとエピソードで整理された平易なコンテンツディレクトリ、右側は常駐の本文です。プロジェクトを開くと自動的にスクリプトがロードされ、コンテンツの切り替えは本文のみを置き換え、新しいページやオーバーレイを開きません。TODO とエクスポートは本文下部の短いヒントとしてのみ表示されます。インターフェースはファイルツリー、実際のパス、構造化フォーマット、ライフサイクル、またはエンジニアリング詳細のエントリを表示しません。Markdown は原稿として読み取り・編集されます。構造化データはカードに変換されます。画像と動画はプレビューのみです。 short-drama.json、.short-drama/**、クリエイター決定、レビューエビデンス、エクスポート検証はすべてシステムが管理し、クリエイターのナビゲーション対象にはなりません。保存は変更を保存することを意味するのみで、クリエイターが特定のバージョンを明示的に採用したことにはなりません。 外部データソースに接続せず、メディア生成インターフェースを呼び出さず、ブラウザにキーを注入しません。 起動ごとに独立したセッション認証情報とAPIパスを生成します。ブラウザはアドレスフラグメントを使用して HttpOnly ローカルセッションと交換し、プロジェクトAPIはそのセッションのみを受け入れます。 具体的なパラメータは lifecycle-commands.md を参照してください。

決定論的ツール

このスキルのインストールディレクトリから scripts/project_tool.py を呼び出します。カレントワーキングディレクトリに依存しません。

コマンド用途
init最小限のプロジェクトを初期化
statusライフサイクルとリカバリサマリーを読み取り
recoverすべてまたは指定されたトランザクションを復元
publish先行書き込みログを介して candidate を公開。受け入れやレビュー結論は含まない
acceptクリエイター決定記録を使用して正確な candidate ターゲットを受け入れ
review独立したレビュー結論で検証とレビューステータスを更新
package5軸、依存関係、エビデンスを再検証した後、テキスト納品パッケージを生成
verify納品パッケージに含まれるチェックサムでそれを検証し、未登録の新規ファイルを報告

これらのコマンドを実際に呼び出すとき、診断が失敗したとき、またはレコードフォーマットを確認するときのみ、lifecycle-commands.md の完全な呼び出し例、先行書き込みログ、受け入れ、レビュー、下流の期限切れ影響、およびパッケージング制約を読み取ります。

ステータスと次のアクション

クリエイターの言語で説明します:

  • 既に存在し、ステータスが accepted のソース
  • ステータスが provisional、stale、blocked、またはクリエイターの受け入れ待ちのコンテンツ
  • 現在並行して入ることのできるブランチ
  • ユーザーが求める結果を推進する最小のアクション

ユーザーが診断を要求しない限り、hash、トランザクションID、内部データ構造、または生のステータス内容を出力しません。 5つのステータスは相互に独立しています:構築、検証、クリエイター受け入れ、独立レビュー、納品チェック。単一の accepted ですべてを偽装してはなりません。

リカバリと改訂

ユーザーが尋ねたフェーズ内で最も早い未完了の操作を復元します。プロジェクト全体で最も早いフェージではありません。変更内容を確認する前に:

  1. 修正を担当するスキルを指定
  2. 提案された意味的変更を表示
  3. 正確な下流影響リストを列挙
  4. 必要に応じてクリエイターの受け入れを取得
  5. 担当者に修正を依頼し、新しい hash に対して再レビューを実行

COMMIT がない不完全なトランザクションは、保存されている前のバージョンにロールバックされます。既に COMMIT がある不完全なトランザクションは candidate まで継続し、ステータスを補完します。リカバリは必ず読み取り後に書き込み、繰り返し実行可能でなければなりません。ソースを確認できない外部変更は conflict とマークしなければならず、上書きしてはなりません。

納品

まず $short-drama-review のフレッシュレビューコンテキストにルーティングして検証し、その後納品チェックの準備ができた時点でパッケージ化します。ステータスが accepted のスクリプト、マニフェスト、プロンプト、レビュー、クリエイターノート、およびチェックサムのみを含めます。バイナリメディア、非公開入力、マシンステータス、絶対パス、資格情報、非公開ソース資料、未承認のドラフトは除外します。

境界

  • 現在のエージェントのテキスト推論のみを使用します。メディア生成やサービスインターフェースは呼び出しません。
  • 実行時に外部または非公開プロダクションソースを検索しません。
  • 他の場所で見たケースをクリエイティブの法則として昇格させません。
  • 責任者は自分の成果物をレビューできません。
  • 意味的競合を静かに修正しません。

関連スキル