Communitygithub.com

Malik-rgb43/video-intake(動画企画入力ワークフロー)

新しい動画のアイデア、ブリーフ、または具体的な指示リストを、チェック可能なコンセプト元帳に変換し、すべてのパラメータが正確になるまで質問を続けます。コンセプト、プロンプト、または制作の前に使用します。

video-intake(動画企画入力ワークフロー) とは?

このスキルは、新しい動画プロジェクトの最初の段階(ステージ wf-00)を自動化する、厳格な「動画企画入力」ワークフローです。ユーザーが自由形式のアイデア、ブリーフ、または具体的な指示を入力すると、このエージェントはそれを構造化された「コンセプト元帳(Concept Ledger)」に変換します。各行は具体的な要素(プラットフォーム、尺、トーン、CTAなど)を表し、ユーザーの言葉をそのまま保持します。ワークフローは、不明確な点をすべて解消するまで反復的に質問を繰り返し、推測を禁止します。ロックされた行は決して上書きされず、変更は追跡可能です。出力物には、逐語的なログ、検証可能な元帳、BRIEF.md、そして3つのコンセプトカード(Proven/Bold/Wild)が含まれます。このスキルは、AI生成やコード作成を一切行わず、計画フェーズに徹します。サポートプラットフォームは明確に定義されていませんが、Claude Codeなどのコード実行およびファイル読み取り/書き込みが可能なAIエージェント向けに設計されています。動作内容は、MARKDOWNファイルの読み取り、Pythonスクリプトの実行、ファイル構造の調査、そして厳格なルールセットに従った情報の整理です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/video-intake

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

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

ドキュメント

video-intake

すべての新しい動画が最初に通るゲート(ステージ wf-00)。出力: 逐語的なインプットログ、具体的な項目ごとに測定可能な行を持つコンセプト元帳、BRIEF.md、そして(ユーザーがコンセプトを固定しなかった場合)3枚のコンセプトカード。フレームごとのPROMPT、コード、生成は書き込みません。

絶対に曲げないルール

  1. 正確になるまでインプットを受け付ける。 参考資料がない場合は質問する。プラットフォーム、尺、トーン、CTA、構成(無音カットか再構築か)、品質基準は決して推測しない。
  2. ユーザーが書いた具体的な内容はすべて元帳の行になる IDが付与され、ユーザーの言葉そのまま(ヘブライ語はヘブライ語のまま)。複合的な主張は分割する(「地球が大きく、人物が高い」=2行)。
  3. ブロッキング行(FMT, LEN, TON, BAR, CTA, FILE)がロックされるまで、コンセプトカード、PROMPT構成、制作は行わない。 さらに、映像がある場合はSTRとCOLORを、複数のファイルが納品された場合はVARを追加する。
  4. PROMPT.mdは、最初のコード行の前にユーザーの承認を得る。 自律実行の場合も同様。エージェントがドラフトを作成し、人間が承認する(決定デフォルト Q6)。変更順序: 元帳 → PROMPT → コード。
  5. ここでは費用を発生させない。 インプットは計画である。AI生成には paid-generation-gate が必要。「計画のみ」は生成ゼロを意味する。権利が不明確で生成が計画されている場合はブロックする。
  6. ロックされた行は決して上書きしない。 新しい行を追加し、古い行を取り消し線で消す(struck by L<nn>、または仕様では ~~old~~ -> new, time)。
  7. 未知かつ重要なことだけを質問する。 ツールやフォルダについて質問しない。判断して理由を1行で説明する。
  8. スキルは手順であり、許可ではない。ユーザーとプロジェクトの費用とインストールに関する制限が優先される。モデル上でテストされていない(決定デフォルト Q4)。

フロー

  1. 既存のものを読む: メッセージ、添付ファイル、そしてソースツリー全体を確認する: python scripts/source_inventory.py <source folder> --write projects/<name>/_work/intake(source_ls.txt + probe.json を書き込む;4Kカメラのオリジナルがラフカットの隣に気づかれずに置かれていたことがある)。projects/ に同じソースの同種プロジェクトがないか確認する。「新しいプロジェクトか、Xの続きか?」と質問する。ブランチ(参考資料、貼り付けられたプロンプト、「חדש לגמרי」、「רק תכנן」): references/branches-and-mistakes.md を参照。
  2. 逐語的にログを取る _work/intake/INTAKE_LOG.md へ: ユーザーの言葉をそのままの行として、あなたの質問を ## Round N の下に Q: 行として記録する。
  3. 元帳を解析する hf/PROMPT.md の <ledger> ブロックへ(まだ <structure> のないドラフト): id、次元、said、測定可能な spec、where / when、受け入れチェック、src U/R/D/A、ステータス(references/ledger-template.md を参照)。
  4. 質問ループ(references/question-bank.md を参照): 1ラウンド3〜4の質問、具体的な選択肢、最初の選択肢が推奨。BAR はラウンド1で行う。各ラウンド後に נעול: ... | פתוח: ... を表示し、元帳を更新する。「תמשיך」/「continue」= 推奨選択肢を採用し、D とマークし、それを1行で伝える。
  5. 参考資料あり? reference-style-transfer に渡し、どの時間範囲が「スタイル」かを尋ねる。なし: 質問を続ける。スタイルを創作してはならない。
  6. コンセプト: ユーザーが固定しなかった場合、Proven / Bold / Wild の3枚のカードで、コンセプトが異なるものを作成し、1つを推奨する(references/concept-cards-and-brief.md を参照)。
  7. BRIEF.md: テンプレート(agent-content/techniques/templates/BRIEF.md)から正しい事実を埋め、ledger_check.py を実行し、PROMPT作成者に引き継ぎ、承認を待ち、hf/CHANGELOG.md に PROMPT_APPROVED <date> "<words>" と記録する。

質問ループの概要

  • 各ラウンド3〜4問、影響の大きいものから順に: FMT / LEN / STR / BAR、次に HOOK / TON / LOOK / MOT、次に TYPE / 3D / BROLL / BRAND、次に CAP / MUS / SFX / CTA、次に FILE / VAR / DUE。
  • すべての選択肢は具体的(数字、名前、16進数、ファイル)で、最初の選択肢が推奨であり、(מומלץ) / (recommended) と理由を1行添えてラベル付けする。視覚的な選択: プレビュー、または3つ以上の美的選択が保留されている場合は choice-board を追加する。
  • ls、ffprobe、またはメッセージが既に答えていることは決して質問しない。ツールやフォルダについて質問しない。
  • 各ラウンド後: נעול: L01 L02 ... | פתוח: HOOK LOOK ...。
  • 参考資料なし = 質問する。参考資料あり = 分析し、参考資料では答えられないこと(尺、アスペクト比、構成、CTA、ファイル名、品質基準、音楽ライセンス、締め切り)だけを質問する。

ラウンド1のメッセージ(ヘブライ語 / 英語)

סבב 1 - ארבע שאלות, לכל אחת ברירת מחדל מומלצת:
1. פלטפורמה ויחס? (מומלץ: 9:16 ריילס/טיקטוק; מאסטר אחד, שאר היחסים בעיצוב מחדש)
2. כמה שניות בדיוק? (מומלץ: התוכן המלא בצילום; 45 במושן)
3. חיתוך שתיקות בלבד, או בנייה מחדש? (מומלץ: שתיקות בלבד, סדר טבעי, משפטים שלמים)
4. רמת איכות? (מומלץ: פרימיום - ביט גרפי כל 3-6 שניות, צבע מדוד)
Round 1 - four questions, each with a recommended default: 1. platform and ratio, 2. exact seconds, 3. silence cut only or rebuild, 4. quality bar.

元帳の行の一例

| L02 | TRN | "פילם ברן בשניה 1-2" | the user's burn file, full frame, screen blend | 1.00-2.00 s (f30-60) | frame strip f28-62: burn visible, file name matches | U | locked | 1行に1つの主張。said はそのまま。spec は測定可能。時間付きの said には範囲とフレームレベルのチェックが必要(チェッカーが両方を検証する)。

インプットがうまくいっていない兆候

尺やプラットフォームがユーザーの文に基づいていない。FILE や CTA がロックされる前にコンセプトカードが存在する。ユーザーが見たことのない D 行がある。ソースフォルダがリストされていない。PROMPT に <structure> ブロックがあり、PROMPT_APPROVED 行がない。

ゲート

状態: pass | fail | blocked | n/a、理由付き。ログがない、元帳が空、タイムアウト、フォルダが読み取れない場合は決して通過しない。

ゲート述語証拠偽の場合所有者再確認
G1 元帳の完全性インプットログ内のすべての具体的な条項に行がある。すべての U 行の引用がログにある。0件の創作行。python scripts/ledger_check.py hf/PROMPT.md --source _work/intake/INTAKE_LOG.md の終了コード0(ステータス PASS、カバレッジ checked)不足行を追加するか、理由を添えて --waive する。ログを編集して合わせてはならない。video-intake新しいユーザーメッセージまたは元帳の編集時
G2 推測なしFMT, LEN, TON, BAR, CTA, FILE(+ --footage 付きでSTR, COLOR;+ --variants 付きでVAR)の各々が U/R/承認済み A から、またはユーザーが見た D 行から来ている。1ラウンドあたり最大4問。同じスクリプト: blocking すべて ok、too_many_questions なし次のラウンドを尋ねる。コンセプトは書かない。video-intake回答がブロッキング行を変更した時
G3 ソースツリーの読み取りソースツリー全体がリストされた。カメラオリジナルの候補が報告されているか、unknown とある。_work/intake/source_ls.txt と probe.json が存在し、引用されている。再実行する。blocked リストはブロックされたまま。video-intake新しいファイルがソースに追加された時
G4 参考資料ブランチ参考資料あり → reference-style-transfer とスタイル時間範囲が記録された。なし → ループ継続。インプットログ内のブランチ行スタイルを創作してはならない。video-intakeユーザーが参考資料を追加した時
G5 3つのコンセプト3枚のカード、フックの仕掛け/構成/ビジュアル言語のうち2つ以上がペアごとに異なる。各カードは従う元帳IDをリストしている。カード最も弱いものを再生成する。video-intakeブロッキング行が変更された時
G6 権利BRIEF.md に記入済みの「Source and rights」セクションがある(映像の所有者/同意、ファイルごとの音楽/ストックライセンス、クライアントアカウントか自身のアカウントか)。BRIEF.mdブロック: 有料生成不可、License: unknown の広告使用不可(決定デフォルト Q2)。video-intake新しいアセットが出現した時
G7 引き継ぎledger_check.py hf/PROMPT.md --source ... --prompt hf/PROMPT.md の終了コード0(すべてのIDが2回以上引用されている)かつ PROMPT_APPROVED が hf/CHANGELOG.md にある。スクリプト出力 + 行PROMPTはドラフトのまま。コードなし。PROMPT作成者元帳またはPROMPTの変更時

出力

_work/intake/{INTAKE_LOG.md, source_ls.txt, probe.json}、hf/PROMPT.md 内の <ledger> ブロック、hf/BRIEF.md、選択されたコンセプトカード、バリアント行(ファイルごとに1行)、OPEN: リスト、元帳チェックJSON。

停止条件

  • ユーザーが「ただ始めて」と言った場合: 推奨デフォルトを D として採用し、その旨を伝える。それでも、CTA、FILE、およびユーザーが見ていないブロッキング項目は尋ねる。
  • 新しいリクエストがロックされた行と矛盾する場合: 両方を表示し、どちらが優先されるか尋ねる。黙って選択してはならない。
  • ユーザーがPROMPT承認をスキップしたい場合: ショートカットを拒否し、より短いPROMPTを(スキップではなく)提案する。
  • インプットが4ラウンドを超えた場合: ロック済みと未ロックを要約し、残りを1回の「continue」で解決するようユーザーに依頼する。

参考文献とスクリプト

  • references/ledger-template.md: 元帳を作成または編集する際に読み込む(チェッカーが解析する形式、次元コード、チェックの種類、例)。
  • references/question-bank.md: フィールドが不足している場合、またはラウンドを作成する前に読み込む(ヘブライ語 + 英語、選択肢、ラウンド計画)。
  • references/branches-and-mistakes.md: 入力が参考資料、貼り付けられたプロンプト、同種プロジェクトの場合、またはゲート失敗後に読み込む。
  • references/concept-cards-and-brief.md: コンセプトカード、BRIEF.md、権利情報、または引き継ぎを書く際に読み込む。
  • scripts/ledger_check.py、scripts/source_inventory.py: 標準ライブラリ。各々 --self-check を備える。
  • 共有テクニック(他の所有者): agent-content/techniques/concept-ledger.md(正規の元帳ルール)、agent-content/techniques/question-bank.md(完全なヘブライ語バンク);ステージのプレイブック agent-content/playbooks/wf-00-intake.md。

Individual skills in this repo

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

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Design, build and review a motion-graphics piece in HyperFrames/GSAP: product or app launch, feature announcement, kinetic typography, logo reveal, UI explainer, animated screenshots. Triggers: מושן גרפיקס, אנימציה, השקה, טיפוגרפיה קינטית, לוגו אנימציה, "like a Higgsfield / Linear launch". Not for a speaker-to-camera reel (edit-talking-head), AI-generated shots (edit-ai-generated), caption-only work (hebrew-captions-asr) or ad compliance (edit-ad-promo).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Deliver one approved video as several outputs (other aspect ratios, hook variants, platform versions, no-music/no-captions versions) or run several videos in parallel, with one shared mix, strict naming and a manifest that blocks stale derivatives. Triggers: export as 9:16 and 1:1, hook variants, variants batch; גרסאות, וריאציות הוק, כמה סרטונים יחד, 9:16 ו-16:9. NOT for a single deliverable (render-qa-deliver) or designing the master (the type skill).

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

関連スキル