Communitygithub.com

lhaovo/短指揮ビデオスキル

短い動画を企画から公開まで管理するプロセス制御スキル:制作ディレクトリを作成し、「脚本・絵コンテ → プロンプト → 生成 → 納品 → 公開」の5段階を順に進め、各段階にゲートを設定。状態を記録し、セッションをまたいで作業を継続できます。

短指揮ビデオスキル とは?

このスキルは、短い動画制作の全プロセスを統括するプロセス制御ツールです。制作ディレクトリの作成、5つの段階(脚本・絵コンテ、プロンプト、生成、納品、公開)の進行管理、各段階の完了条件(ゲート)の判定、状態ファイルの記録と更新、セッションをまたいだ作業の継続を支援します。Claude Code、Cursor、CodexなどのAIエージェントと連携し、ユーザーが新規動画の開始、次の作業ステップの確認、未完了の動画の再開、絵コンテからプロンプトへの変換、素材と完成品の整理、公開準備などを行う際に特に役立ちます。このスキルはプロセス、ディレクトリ構造、成果物の標準のみを定義し、各段階のライティング規範(脚本執筆など)は他のスキルに委ねます。例えば、脚本・絵コンテは`short-video-plan`、プロンプト生成は`short-video-prompt`が担当します。これにより、制作のどの時点でも「今どこまで進んでいるか、次に何をすべきか、次に進める条件は満たしているか」が一目でわかる状態を保証します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lhaovo/short-video-skills/tree/HEAD/short-video-flow

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

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

ドキュメント

短い動画コントロールパネル

1本の動画をアイデアから公開まで、1つのディレクトリで完結させます。このスキルは3つのことを管理します:ディレクトリの作り方、5段階の進め方、各段階で何を以って完了とするか。

脚本の書き方(それは short-video-plan の担当です)や生成モデルの代替、編集作業の実践を教えるものではありません。保証するのは次のことです:どの制作作業でも、ディレクトリを開けば、どこまで進んでいるか、次に何をするか、次に進めるかどうかがわかる。


一、5段階

S1 脚本・絵コンテ → G1 → S2 プロンプト → G2 → S3 生成 → G3 → S4 納品 → G4 → S5 公開 → G5 → 完了
段階何をする主な成果物担当者
S1 脚本・絵コンテテーマ選定、タイプ、構成、脚本、内容絵コンテ01-企画案.mdshort-video-plan
S2 プロンプト絵コンテ → アセットリスト + 生成リスト02-アセットリスト.md、03-生成リスト.mdshort-video-prompt
S3 生成まずアセットを準備し、次にセグメント動画を生成04-素材/short-video-assets + short-video-generate
S4 納品セグメント結合、字幕、BGM、ミキシング05-完成品/編集ツール
S5 公開タイトル、サムネイル、ハッシュタグ、時間、識別06-公開パッケージ.md本スキル

一度に1段階だけ進めます。 段階を飛ばすことは、手戻りの主要な原因です——G2が通っていないのに生成を始めると、生成された素材は必ず絵コンテの番号と合いません。


二、ディレクトリ規範(本スキルが唯一の権威)

すべての成果物は同じディレクトリに入れ、デフォルトの場所はプロジェクトルートの outputs/ です。他の段階は自らディレクトリルールを定義せず、すべてこのセクションに従います。

2.1 構造

outputs/
└── 2026-09-29-睡眠不足が多動症のように/  
    ├── 00-プロセス状態.md  
    ├── 01-企画案.md  
    ├── 02-アセットリスト.md  
    ├── 03-生成リスト.md  
    ├── 04-素材/  
    │   ├── 01-アセット画像/  
    │   ├── 02-最初のフレーム/  
    │   └── 03-セグメント/  
    ├── 05-完成品/  
    │   └── 完成品-v1.mp4  
    └── 06-公開パッケージ.md  

番号プレフィックスの利点:ディレクトリを開くと、ファイルがプロセス順に並びます。どの段階まで進んでいるか、どのファイルが不足しているかが一目でわかるため、追加のナビゲーションファイルは必要ありません。

2.2 ディレクトリ名

形式は固定:YYYY-MM-DD-タイトル

項目要件
日付ディレクトリを作成した当日。その後は変更しない
区切り文字日付とタイトルの間はハイフン1つ。タイトル内の単語もハイフンでつなぐ
長さタイトルは8~15文字
禁止文字スラッシュ、バックスラッシュ、コロン、アスタリスク、クエスチョンマーク、引用符、山括弧、縦棒、スペース、句読点
同名の場合同じ日に同じタイトルの場合、-2、-3 を追加する

タイトルは、選んだテーマの中で最も識別しやすいフレーズとし、カテゴリ名は使用しません:

ダメ良い
科学解説のノウハウ睡眠不足が多動症のように
抖音(TikTok)ショート動画温かいご飯は外は熱く中は冷たい
10月22日のテーマ保温ボトルにコーヒーを入れると半日で冷める

判断方法:3ヶ月後にディレクトリ名だけを見て、どの動画か思い出せるかどうか。 カテゴリ名は3ヶ月後には必ず思い出せませんが、テーマなら思い出せます。

2.3 3つの鉄則

  1. ディレクトリ名は一度作成したら変更しない。 変更すると、素材の参照パスが一気に壊れます。タイトルを変更したい場合は、06-公開パッケージ.md の公開タイトルを変更し、ディレクトリは変更しません。
  2. 日付をまたいでも日付は変更しない。 翌日も作業を続ける場合、ディレクトリは作成した日の日付のままにし、新しいディレクトリは作成しません。
  3. 1本の動画に1つのディレクトリ。 シリーズものやマトリックス展開の場合もサブディレクトリにはせず、別のディレクトリを作成し、タイトルに区別する言葉を追加します。

2.4 開始の第一歩

ユーザーが「新しく1本始める」と言った場合、最初に3つの情報を確認してからディレクトリを作成します:

  • プラットフォーム(抖音(TikTok)/ 動画号 / 小紅書(RED))
  • 目標時間
  • 一言で方向性

次に、順番に4つのことを行います:

  1. 2.2 に従ってディレクトリ名を生成し、ユーザーに読み上げて確認する——これが唯一、名前を変更してもコストがかからない機会です
  2. ディレクトリ、および 04-素材/01-アセット画像、02-最初のフレーム、03-セグメント、05-完成品 の4つのサブディレクトリを作成する
  3. 00-プロセス状態.md を作成:現在の段階 = S1、プロジェクト検収プロファイルを記入し、5つのゲートすべてを「未開始」と記入する
  4. S1に進み、コンテンツ層に引き渡す

名前の確認なしに先に作成した場合、後で名前を変更するコストはユーザーが負担します。


三、状態ファイル

00-プロセス状態.md は、この動画のセーブポイントです。段階を進めるたびにすぐに更新し、溜め込まないでください。

必須のフィールド:

フィールド役割
ディレクトリ名、作成日、プラットフォーム、目標時間識別
現在の段階6つから選択:S1 / S2 / S3 / S4 / S5 / 完了
5つのゲート結果G1~G5 それぞれ:通過 / 未通過 / 未開始
成果物リスト既存ファイル + 不足ファイル
ブロック項目現在どこで詰まっているか、誰を待っているか
プロジェクト検収プロファイルコンテンツタイプ、目標、リズム意図、最大無音区間の上限、無音の伝達方法、ハード制約、検収者/確定条件
バージョン記録変更のたびに1行:日付 + 変更内容 + 理由

テンプレートは assets/flow-state-template.md を参照してください。

これは非常に具体的な問題を解決します:セッションが変わった、1週間空いた、担当者が変わった場合でも、この1つのファイルを読めば続きができる。 これがないと、3日目に戻ってきたときに素材を全部見直さなければ、どこまで進んでいたか思い出せません。


四、5つのゲート

ゲートの結果は2つだけ:通過、または不通過。不通過の場合はその段階で止まり、「とりあえず進めてみる」ことは許されません。

G1 · 脚本・絵コンテ通過(S1 → S2)

  • 01-企画案.md の5つのセクションがすべて揃っており、自己チェック8項目すべてに合格していること
  • 絵コンテの合計時間と目標との差が ≤30% であること
  • 各カットは2~6秒で、カット番号は連続しており、欠番がないこと
  • レッドライン自己チェックに合格していること:未確認の効能がない、偽の証言がない、絶対的な表現がない、個人情報がない
  • ユーザーがテーマと脚本を確認済みであること
  • プロジェクト検収プロファイルが記入されていること;プラットフォーム、目標時間、またはハード制約が未確認の場合は、ユーザーが承認したデフォルト値を記録し、そうでなければS1で停止すること
  • 検収プロファイルで最大無音区間の上限が宣言されていること;長い無音を許可するプロジェクトでは、無音部分の伝達方法が明記されていること
  • 各カットに、機能、視聴者の認識、前提依存、重要な可視事実、時間意図が記入されていること;無音部分は、動作/効果音/音楽/雰囲気による伝達を説明していること
  • 企画スキルを使用する場合は、その scripts/check_plan.py を実行し、機械的なフィールド、時間、依存番号のエラーを除去すること;フロースキルのみをインストールした場合は、G1リストに従って手動で確認し、スクリプト未実行を記録すること

G2 · 生成リスト通過(S2 → S3)

  • すべてのプロンプトに対応するカット番号があり、余分なものがないこと
  • 各セグメントの時間の合計と絵コンテの合計時間の差が ≤1秒であること
  • リストで参照されているアセット番号が、アセットリストで全て定義されており、宙ぶらりんの参照がないこと
  • メインモードが決定していること:最初と最後のフレーム、または参照画像のいずれか;テキスト生成は主体のないカットにのみ使用すること
  • 製品パラメータ、パッケージ、ロゴなどのカットは「実際の画像を使用」とマークされ、純粋なテキスト生成動画に委ねないこと
  • セリフのあるセグメントは、セリフの原文がプロンプトに記述され、絵コンテのナレーションと一字一句一致していること(ナレーションを別途吹き込むことはなく、これが抜けるとそのセグメントは無音になる)
  • 各セグメントのプロンプトの「画面フィールド」表に、主体、状態、動作、環境、光、ショットサイズ、カメラ位置/アングル、カメラワーク、依存/可視事実が明記されていること;該当しない項目はその理由を説明すること
  • 絵コンテのキーとなる可視事実、前提依存、時間意図が、最初のフレームまたはセグメント内の動作にマッピングされていること

G3 · 素材通過(S3 → S4)

  • 各セグメントに使用可能なバージョンがあり、不足しているものはブロック項目に記録されていること
  • 製品の形状が変形しておらず、ラベルが読めて文字が変わっていないこと
  • 隣接するセグメントの最初と最後が接続可能であること:同じ製品、同じ光の方向、同じアスペクト比
  • IP/キャラクター特徴リストにある象徴的な識別点とその数が、確定版セグメントでカットごとに確認されていること
  • 同じカットに複数の候補がある場合、選択されたバージョンがリストに記録されていること
  • セリフのあるセグメントは、文単位で聞き取り確認済みであること:抜け文がない、キーワードが間違って読まれていないこと
  • 確定セリフの結論が 04-素材/00-セリフ確定案.json に記録されていること;不明瞭なキーワードの書き起こしは、主に手動の聞き取り確認の補助として使用されること
  • 時間順に手動で全編素材レビューが完了していること;カット間の因果関係、キャラクター/小道具の状態、空間の連続性、リズムをチェックしていること;生成前の最初のフレームストーリーボードはこれを代替できないこと
  • 確定版セグメントのセリフタイムラインがある場合は、先にリズム予備チェックを行うこと;完成品字幕がない場合は、S4での実測を待つことを記録し、予備チェックを完成品の結論としないこと
  • 生成リスト内の効果音、テロップなどの後処理項目に、S4での実行計画があり、宙ぶらりんの約束がないこと

G4 · 完成品通過(S4 → S5)

  • 実際の時間と目標との差が ≤10% であること
  • 完成品の字幕と実際の時間を使用して本スキルの scripts/check_rhythm.py を実行し、レポートと聞き取り確認の結論を 00-プロセス状態.md に添付すること;字幕の空白部分は、無音の代理指標に過ぎないこと
  • 字幕と実際に聞こえるセリフが一致していること(原稿と一致していることではない——読み間違えた場合は、聞こえた方を優先する)
  • 人の声が明瞭で、BGMが人の声を圧迫していないこと
  • アスペクト比、解像度、フレームレートがターゲットプラットフォームの要件を満たしていること
  • 完成品の最長無音区間は、手動の聞き取り確認を基準とし、字幕の空白レポートは補助的な位置特定に使用すること;検収プロファイルで宣言された値を超え、かつ絵コンテで非言語セグメントとして宣言されていない場合は、差し戻すこと
  • 長い無音を許可すると宣言された区間は、絵コンテで動作、効果音、音楽、または雰囲気による伝達が明記され、納品成果物内で対応するファイルと時間点が示されていること
  • 生成リストで約束された後処理項目がすべて完了し、成果物を特定できるか、明確な検収者による豁免があること

G5 · 公開前通過(S5 → 完了)

  • 厳格な規制カテゴリ(医薬品、健康食品、医療機器、金融、教育)については、別途審査が行われていること
  • AI生成コンテンツは、プラットフォームの要件に従って識別されていること
  • タイトル、サムネイル、ハッシュタグ、公開時間がすべて揃っていること
  • 個人情報、無許可の肖像権や撮影場所がないこと

五、引き継ぎカード

段階間の引き継ぎは、ファイルを介してのみ行われ、「さっきどこまで話しましたっけ」のような口頭のやり取りには依存しません。各段階の終了時にカードに記入し、状態ファイルの「引き継ぎ」欄に書き込みます:

引き継ぎカードに必須の内容
S1 → S26列の絵コンテ簡易表とカットごとの詳細(認識/依存/可視事実/時間意図)、製品の正式名称と仕様、リアルに提示する必要のある情報
S2 → S3各セグメントの生成タスク:セグメント番号、時間、プロンプト、参照画像番号、モード、候補数
S3 → S4素材リスト:ファイル名、セグメント番号、時間、可用性;セリフの聞き取り確認をセグメントごとに行ったかどうか、BGMが選択済みかどうか
S4 → S5完成品ファイル、時間、アスペクト比、サムネイル素材、売りポイントとハッシュタグ候補

完全なフィールドは references/stage-specs.md を参照してください。


六、未完了の動画を再開する

ユーザーが「あの睡眠不足のやつを続けて」などのように言った場合:

  1. outputs/ 以下のディレクトリを一覧表示し、名前で一致させる;一致しない場合は、質問して確認し、推測しないこと
  2. 00-プロセス状態.md を読む。まず現在の段階とブロック項目だけを見て、すべての成果物を急いで読まないこと
  3. 3行で報告する:どこまで進んでいるか、どこで詰まっているか、次に何をするか
  4. 確認を得てから、対応する段階に進むこと

最初からやり直さないでください。また、状態ファイルをスキップして段階を直接推測しないでください——推測を誤ると、すでに通過したゲートが再び開かれる可能性があります。


七、サブスキルとの関係

階層担当管理内容
プロセス層本スキルディレクトリ、段階、ゲート、状態、引き継ぎ
コンテンツ層short-video-planテーマ選定、タイプ、構成、脚本、内容絵コンテ
プロンプト層short-video-prompt絵コンテ表 → アセットリスト + 生成リスト
アセット層short-video-assetsリスト → 画像:生産計画、候補出力、検収、保存
生成層short-video-generateリスト → セグメント:タスク作成、ポーリングダウンロード、メディアヘルスチェック、台帳
納品層編集ツール結合、字幕、BGM、ミキシング

3つのルール:

  • コンテンツ層はディレクトリを定義せず、完成品をプロセス層が指定した場所に渡すだけ
  • プロンプト層はコンテンツを再構成せず、翻訳のみを行う;本スキルはその作業方法をコピーしない
  • アセット層はコンテンツやプロンプトを変更せず、画像が正しく作成され、要件に合い、検収に合格することだけを管理する
  • 生成層はビジュアルデザインを変更せず、決定された画面を動かすことだけを行い、追跡可能なタスク記録を残す
  • プロセス層はどの層のライティング規範も書き換えず、ゲートを通過したかどうかのみを判定する

競合が発生した場合:ディレクトリとファイル名は本スキルを優先し、コンテンツの判断は short-video-plan を優先します。


八、境界

  • 脚本規範は書かない:テーマ選定、構成、脚本、絵コンテの書き方はコンテンツ層にあり、本スキルは重複しません
  • 生成モデルを代替しない:タスクと検収基準を明確に記述しますが、特定の生成が必ず成功することを保証しません
  • 編集作業を実践しない:完成品の標準を規定しますが、具体的な結合は編集ツール内で行われます
  • 再生回数を約束しない:5つのゲートは「プロセスに漏れがない、素材が接続可能、公開がコンプライアンスを満たしている」ことを保証しますが、データは保証しません
  • プラットフォームルールや法的審査を代替しない:プラットフォームのポリシーや法律は変更される可能性があり、厳格な規制カテゴリは別途確認が必要です

九、参考資料(必要に応じて読み込む)

ファイルいつ読むか
references/stage-specs.md各段階に入る前、引き継ぎカードに記入する時
references/delivery-and-publish.mdS4で完成品を組み立てる時、S5で公開パッケージを作成する時
references/regression-cases.mdゲートスクリプトや判断基準を変更した後の再テスト
assets/flow-state-template.md新しいフローを作成する時、状態を更新するたび
assets/publish-pack-template.mdS5で公開パッケージに記入する時

S2の作業方法は本スキルには含まれず、short-video-prompt が担当します。本スキルは次のことのみ担当します:S2に入る前にG1をチェックし、新しいリストが出た後にG2を実施します。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

lhaovo/short-video-skills

为视频生成准备可用的图——把资产清单变成能直接喂给图生视频的素材:排生产顺序、定资产级别、出候选图、做一致性验收、按编号落盘、回写清单状态。支持三种来源:实拍、AI 生成、官方素材,不强制实拍。当用户说「准备素材」「出资产图」「首帧图」「角色三视图」「产品图跑一下」「资产对不上」「这条要哪些图」时使用。只管把图做出来并验收,不写分镜,不直接生成视频。

lhaovo/short-video-skills

把已过 G2 的生成清单落成真实视频片段——按段建 KIE Seedance 任务、轮询、下载、媒体体检、抽帧质检、听声核台词,并把每段的状态与请求指纹写进生成台账。三种模式互斥(文生 / 首帧图生 / 首尾帧图生)。旁白由模型直接念,台词照稿写进提示词,不走独立 TTS 配音。当用户提到视频生成、出片段、跑 Seedance、首帧图生、首尾帧、原生音频、台词念错、任务查询、片段下载、生成失败重试时使用。只管「把已定的画面和台词变成成段素材」,不重新设计视觉、不改台词文本、不做字幕、不做剪辑。

lhaovo/short-video-skills

把「我想拍点什么」变成一条想清楚的片子——先定主题(出 5 个候选、标明类型、给出推荐与淘汰理由),再定结构与分段剧本,最后切成镜头级内容分镜。支持两种入口:一句话主题(需要发散选题)与已有拆解剧本(跳过选题,先问复刻需求与复刻强度再判定改写)。当用户提到选题、定主题、短视频策划、写剧本、写大纲、分镜、镜头脚本、不知道拍什么、内容怎么排、科普干货、剧情软广、钩子怎么写、复刻别人的剧本时使用。只管内容层(讲什么、怎么讲),不碰执行层;内置的内容红线只防明显自伤,不替代合规审查。

lhaovo/short-video-skills

把已定稿的分镜表翻成可直接执行的两份清单——资产清单(要准备哪些图、每张图的图像提示词)与生成清单(每段视频的时长、模式、素材引用与提示词)。覆盖画面化、资产编号、切分生成单元、Seedance 视频提示词写法、首帧方案、一致性与失败诊断。当用户说「把分镜变成提示词」「写视频提示词」「这条片子要哪些图」「生成清单」「某个镜头生成不出来」时使用。只做翻译与清单,不重新编排内容,不直接出图出片。

関連スキル