1仕組みと動作原理
目標は「別のエージェントが推測することなくそのまま実行できる spec を出力すること」としてハードコードされています。評価基準はドキュメントの網羅性ではなく、実行可能性です。
skills/video-intake-and-storyboard/SKILL.md
Use this skill before building scenes. The goal is to transform conversational direction into a spec that another agent can execute without guessing.
ここで行われていること：インテークの検収基準を「下流工程で推測させないこと」に設定。同系統の end-to-end-video-playbook でも「まず意図を制作成果物に変換する」ことをステップ2としています。
インテークは4段階で抽出されます：客観的事実（シーン番号、尺と目標フレームレート/解像度、ナレーションとフレーズのタイムスタンプ、参考画像または最終フレームの目標、アセットの場所、明示的な変更不可の境界、前後のシーンとの必要なトランジション）、スタイルの制約、承認ステータス、未決定事項。
skills/video-intake-and-storyboard/SKILL.md
1. Extract hard facts.
ここで行われていること：ユーザーの何気ない発言をハードな制約と好みの2つに分類。明示的な「do not touch（触るな）」の境界は客観的事実として扱われ、以降は一貫して制約として処理されます。
質問の基準：実装に影響を与える質問のみを行い、オープンクエスチョンではなく具体的な選択肢（トリミングの要否、字幕スタイル、トランジションの方向、最終フレームの優先度、BGMの音量動作）を優先して提示します。
skills/video-intake-and-storyboard/SKILL.md
- Ask only if the answer changes the implementation.
ここで行われていること：確認のコストを最小限に抑制。オープンクエスチョンはエージェントのデザイン作業をユーザーに肩代わりさせることになりますが、具体的な選択肢であれば即座に意思決定が可能です。
scene spec の品質基準は10の質問です：最初のフレームで何が起きるか、最後のフレームで何が起きるか、時間経過で何が変化するか、どのナレーションまたは音声がタイミングを制御するか、どの正確なタイムスタンプが最も重要か、どの過去シーンを維持すべきか、どのアセットが必要か、どのスタイルを再利用すべきか、どのビジュアルリファレンスがレイアウトを規定するか、どの証明フレームが成功を立証するか。
skills/video-intake-and-storyboard/SKILL.md
A scene spec is ready to implement when it answers:
ここで行われていること：「spec がいつ完成したとみなせるか」の判定基準を提供し、「準備完了」を感覚ではなくチェックリスト化しています。
タイムスタンプは制作上の制約として扱われ、意味論的なマッピングが付与されます（「At 5s」はその瞬間に必ず可視化、「Start around 3s」はその瞬間に見えるよう少し前から開始可能、「Land by 10s」はそれまでに完了、「Hold for 3s」はその間に大きなレイアウト変更なし、「Do not appear before」は初期状態にしておき到達時のみ表示）。
skills/video-intake-and-storyboard/SKILL.md
"Start around 3s" means animation may begin slightly earlier if it must be visible by 3s.
ここで行われていること：自然言語の時間表現を実行可能な制約に変換。同系統の scene-continuity でも時間のデフォルト値の最終裁定権をナレーションのタイミングに委ねています。
タイムスタンプは「シーン内ローカル」か「全体グローバル」かを明記する必要があります。これは同系統内で発生する複数の不具合（字幕、シーン尺、証明フレーム）の共通の根本原因です。
skills/video-intake-and-storyboard/SKILL.md
Always record whether timestamps are local to a scene or global to the full video.
ここで行われていること：一文で特定カテゴリの曖昧さを完全に排除。下流の audio-sync-assembly におけるシーン開始点マップや render-qa の指定タイムスタンプはこの規約に依存しています。
承認境界の指示は、提案ではなく制約として明確に定義されます（Scene 01 を変更しない、承認済みとして扱う、ゼロから再生成しない、スタイル・フォント・カラー・コンポーネントを維持する、このトランジションのみ更新する、添付画像は参考のみとする）。
skills/video-intake-and-storyboard/SKILL.md
These are constraints, not suggestions.
ここで行われていること：ユーザーの口頭での承認を実行可能な制約へと変換。リポジトリの AGENTS.md にある「ユーザーから明示的な指示がない限り承認済みシーンを変更しない」という原則と同源です。
コンテンツとパターンの分離：メモを「プロジェクト固有のコンテンツ」（名前、ロゴ、ナレーション、製品UI、ブランドコピー、非公開ファイル名）と「再利用可能なパターン」（カメラワイプ、グラフ描画、字幕プレビュー、安全マージン、音楽のダッキング、最終フレームの証明）に分割し、後者のみを将来の skill やサンプルに採用します。
skills/video-intake-and-storyboard/SKILL.md
Only reusable patterns belong in future skills or examples.
ここで行われていること：「実プロジェクトから skill を抽出する」ためのルールを設定。非公開のアセットやブランド情報が公開リポジトリに漏洩するのを防止します（README の貢献原則および AGENTS.md のリポジトリ境界に対応）。
2コア機能
014パスのインテークスキャン（客観的事実 / スタイル制約 / 承認ステータス / 未決定事項）と「実装に影響を与える質問のみを行う」基準
02scene spec のルール：各シーンに1つの templates/scene-spec.md を作成。ビートは曖昧なモーションの雰囲気ではなくタイムスタンプ付きの視覚的アクションとして記述。特定の瞬間に必須となる表示および早期表示禁止の内容を明記。初フレーム/最終フレームの要件と後続 QA 用の証明タイムスタンプを記載
03storyboard のルール：複数シーンには templates/storyboard.md を使用。承認済みシーンを locked としてマーク。引き継ぎ（carryover）の依存関係を注記。どの音声がシーン尺を制御し、どの字幕や台本ファイルがマスターであるかを記録
04参考画像の取り扱い：一致必須項目（構図、色、サイズ、テキスト、配置）と差異許容項目（完全な複製、実データ、ロゴグラフィック、カメラの切り出し、アニメーションパス）を定義。最終フレームから逆算し、最終フレームの証明と次シーンへの引き継ぎ証明を計画
05承認境界の捕捉（6つの発言パターン）と「手戻りを減らすプロンプトパターン」（最終フレームの目標、重要要素が表示される正確な時間、その瞬間の前後に見える内容、変更不可の既存シーン、スタイルの変更可否、音声が参考用か重ねるべきマスターか）
06storyboard の失敗パターンリスト（シーン尺と音声尺の不一致、未作成の直前シーンの最終フレームへの依存、参考画像と記述されたタイミングの矛盾、ユーザーによる事後の参考画像無視の指示、最終シーンの変更に伴う前段の字幕や音声の修正波及）
07確認質問リスト（音声は確定か参考用か、最終フレームは完全一致か方向性の一致か、画面録画でキャンバスが映ってもよいか、無音区間に字幕が必要か、一時停止時に音楽を大きくするか）と引き継ぎフォーマット（記入済み spec と storyboard、アセット一覧、ロック済みシーン一覧、未決事項、推奨実装順序）
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| package | 仓库根模板 templates/scene-spec.md（每场景一份）与 templates/storyboard.md（多场景结构）——本件点名使用；位于仓库根，不在 skill 目录内 |
| package | 输入素材：用户提示、带时间戳的旁白或脚本、参考图、编辑注记与项目内既有场景/渲染（本地读取，无外部服务） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: （本 skill のディレクトリ内にスクリプトは存在せず、ドキュメントでもコマンドは一切指定されていません）本 skill はドキュメントの読み取りと記述のみを行います。spec や storyboard への記入は、ホストがプロジェクト内でファイルを書き込むことで実行されます
- 本地工作目录: ファイルの読み書きと成果物の出力: シーンごとの scene spec ファイル（templates/scene-spec.md の記入済みバージョン）
監査ノート： skill ディレクトリ内には SKILL.md のみが存在します（純粋な指示書であり、スクリプト、エンドポイント、認証情報は一切なし）。動作面はローカルの読み取り（プロジェクト素材、参考画像、既存シーン）およびローカルディスクへの書き込み（spec、storyboard、リストの記入）に限定されており、青色分類の「ローカルの読み書きのみ」に合致しています。**素材を外部サービスに送信することはありません**：本 skill ディレクトリの全スキャンにおいて、http(s):// エンドポイント、fetch/requests、token/env の読み取り、CLI コマンドは一切検出されませんでした。「プライベートコンテンツと再利用可能なパターンの分離」をルールとして明記しており、リポジトリの健全性維持（非公開素材やブランドが公開サンプルに混入するのを防ぐ）に対してポジティブな制約となっています。同系統の9つの skill と同一の判定基準です：ディレクトリ内には SKILL.md のみが存在し、動作面はローカルの読み書きおよびローカル CLI のみで、エンドポイント、認証情報、素材の外部送信は存在しません。
5二重目の独立検証
- [ok] 「无外部依赖、无端点无凭证」是否成立 — 目录内正则扫描零命中（无 http(s)://、无 fetch、无 token/env、无 CLI 名）；本件与 motion-design-systems、scene-continuity-and-transitions 同属族内「纯判据、零 CLI」的一组。
- [ok] 两个模板能否承载 SKILL.md 的质量门槛 — templates/scene-spec.md 含 Beat Timeline（Time、Narration or cue、Visual action、Required proof）与 Continuity（First frame must match、Last frame must be reusable by、Carryover frame files to update）与 QA Checklist（末帧与边界与字幕与音频证明时间戳、已知风险、验收标准），逐项对应十问；templates/storyboard.md 的 Scene Table 含 Status、Starts from、Ends on、Do not touch，并有 Global Rules 的 Approved scenes，对应 locked 与 carryover 依赖要求。
- [ok] 时间戳语义是否与族内时序真源冲突 — 本件把时间戳当约束并允许为在 3s 可见而略早开始，最终裁决交给音频（- Track which audio clip controls each scene duration.）；audio-sync-assembly 以最新批准的旁白音频为时序真源，scene-continuity 声明 narration timing wins when explicit.——三处一致。
- [ok] 「不要问可查明的」是否与「只问会改变实现的」自相矛盾 — 两条是同一门槛的两面：先声明只问会改变实现的，再列 5 类可从文件查明的问题（时长、场景名、帧率、含标签的源文件、是否有音轨），实际规则是「能读盘就不问，读了还不确定才问」。无矛盾。
- [ok] 本件是否覆盖「用户说忽略之前参考图」这类撤回场景 — Storyboard Failure Modes 列出 A user saying "ignore this reference" after it was already used.，属对撤回的提示；但未给具体回滚程序（只提示风险），实际回滚需依赖 render-qa 的外科流程——属分工而非缺口。
- [discrepancy] 「内容与模式分离」是否真能防止私有素材出仓 — 规则只要求把项目专有内容与可复用模式分开，并说私有文件名等属专有内容；但 SKILL.md 未给可执行的检查（例如私有资产路径清单或提交前审查），实际执行依赖 agent 自觉与仓库 AGENTS.md 的 Keep private project assets out of this repository.。属规则层约束，非机制。
6結論
最適な用途： 適しているケース：プロジェクトの立ち上げ段階（ユーザーから大まかなアイデア、タイムスタンプ付きナレーション、参考画像、編集メモのみが提供され、それを実行可能な複数シーン計画に落とし込む必要がある場合）。また、新規シーンの追加、既存シーンの保持、または「別のエージェントが直接そのまま実行できる」spec と絵コンテが必要な場合にも適しています。
不向きな用途： 適していないケース：① すでに完成・承認済みの spec があり直接ビルドに進む場合（hyperframes-scene-builder を使用すべき）；② 仕上げの微修正（render-qa-and-surgical-changes を使用）；③ 実際の映像・音声・検収エビデンスの生成が必要な場合（本 skill にはコマンドやスクリプトがなく、ドキュメントのみを出力）；④ コンプライアンス審査やプライベートアセットの秘匿化メカニズムが必要なプロジェクト（分離ルールは制約であり自動化された仕組みではありません）。
Install Agent-Ready
① Verified Mirror 2026-09-28
Option A · Direct DownloadDownload video-intake-and-storyboard.tar.gz
sha256:
Option B · Copy Guide for Agentf997b1af0e9338b6…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit f6b043d9fd.