1仕組みと動作原理
「フォールバック（受け皿）ワークフロー」としての位置付け：一致する専用 workflow がない場合、または BRIEF.md に flow: companion と明記されている場合にのみ使用。新規作成は例外なく先に /hyperframes 意図層を通してルーティングする。
skills/general-video/SKILL.md
Route fresh creation through hyperframes before using this skill.
ここでの処理内容：本スキルは HyperFrames ルーター（/hyperframes）配下の一枚のカードであり、自身は「どの workflow を選ぶか」の意思決定を担いません。「動画を作る」という入力だけでモデルが直ちに受け皿フローへ走るのを防ぐため、トリガー条件を意図的に絞り込んでいます。
作業開始前にステートマシン判定を実施：「具体的な編集 / BRIEF あり / hyperframes.json または STORYBOARD あり / 完全新規」の4行の優先順位に従って最初に一致したものを採用し、それ以降は評価しない。
skills/general-video/SKILL.md
Apply the first matching row; do not evaluate lower state rows:
ここでの処理内容：「継続作業」と「やり直し」の曖昧さを排除します。具体的な編集ではヒアリング（discovery）を行わず、既存の BRIEF があれば追加質問を行わず、真のゼロベース時のみ意図層に戻します。テーブルの各行にはアクションと禁止事項（'Do not reopen discovery.'、'Ask no brief questions.'）が明記されています。
横断的能力（メディア、Figma）は自前で実装せず、すべて adapter を介して兄弟スキルへ転送：音声/画像/アイコン/ロゴ/ナレーション/カラーグレーディング/LUT/VFX/字幕はすべて先に /media-use の resolve + setup-providers を参照する。
skills/general-video/SKILL.md
**Media:** For any audio, image, icon, logo, voice, grade, LUT, treatment/effect, caption, or media-operation need, load `/media-use` and follow `../media-use/references/resolve.md` (resolve, adopt, reuse) and `../media-use/references/setup-providers.md` (providers, auth).
ここでの処理内容：素材調達・ライセンス・ブランドアセットの取り扱いは唯一の担当窓口（/media-use）があり、本スキルは「いつ呼び出すか」のみを担います。Figma 入力も同様に /figma 経由を強制します。理由は本文にある通り、SVG サニタイズのバイパス、メディア出自の追跡、ブランドトークンのバインドを行うためです。
実行形態は BRIEF.md の flow/storyboard の2つのフィールド（automation/companion × yes/no）から派生させ、独自の同義語の創作は固く禁じる。
skills/general-video/SKILL.md
Do not invent synonyms for these states. An ongoing “just build it” signal is handled by the intent layer and arrives as `flow: automation`, `storyboard: no`.
ここでの処理内容：ゲート動作（ボードを展開するか、停止して質問するか）は mode によって決まり、mode はモデルのその場の判断ではなく brief から派生します。これは HyperFrames ファミリー全体の「制御された自動化」における中核メカニズムです。
コンポジション規約は厳格な制約（class="clip" + 単一の paused seek-safe タイムライン + レンダリング時の決定性）であり、keyframes ファミリーと同一の決定性規律を共有する。
skills/general-video/SKILL.md
Timed elements use `class="clip"`; the root and relevant ancestors are sized; each composition registers one paused, seek-safe timeline on `window.__timelines`; rendering is deterministic. Do not use render-time network fetches, clocks, or unseeded randomness.
ここでの処理内容：レンダラーはフレーム単位で seek するため、レンダリング時のネットワークリクエスト（通信タイミングによる出力の不確実性を招く）、クロック参照、シード値のないランダム生成は禁止されています。この規約は 8 つの workflow スキル共通の制約です。
唯一付属するスクリプトは packet builder の薄いラッパー：本 workflow のパスと単一の動作差異（デザイン真値の解決順序 frame.md → design.md → DESIGN.md）のみを固定し、残りのロジックはすべて hyperframes-core の共有実装を再利用する。
skills/general-video/scripts/frame-packets.mjs
// Thin wrapper over the shared packet builder in hyperframes-core — this file pins // this workflow's paths plus its one behavioral difference: design truth resolves // frame.md → design.md → DESIGN.md (general-video § 6 order). Everything else has // one owner: ../../hyperframes-core/scripts/lib/frame-packets-core.mjs
ここでの処理内容：明示的な「単一の所有権」規約です。共有ビルドロジックを各 workflow 内で分岐させることは禁止されています。実際のディスク書き込み（フレームごとの packet と _role.md の mkdirSync + writeFileSync）は core 実装内で行われ、core が outDir に応じて `.hyperframes/frame-packets/` を生成します。
サブエージェントのディスパッチには経済的閾値と定量的根拠が存在：短い動画はインライン処理の方が高速であり、大規模な場合のみファンアウトし、かつ全ワーカーを単一ウェーブでディスパッチする。
skills/general-video/SKILL.md
**Dispatch pays for itself only at scale.** Authoring packets and warming fresh worker contexts costs real minutes and tokens: a film of up to ~6 short scenes builds FASTER inline, in this context, one scene after another (measured: 5 short scenes ≈ 9 min inline vs ≈ 21 min packetized).
ここでの処理内容：「並列処理の方が常に速い」という直感を実測値によって覆し（パケットの組み立てとコンテキストのウォームアップには固定コストがかかる）、各ワーカーに 2〜3 シーンを割り当て、単一ウェーブでディスパッチすること（第2ウェーブを発生させると所要時間がほぼ倍増する）を要求します。これが一般的な「1フレーム1エージェント」設計と本スキルとの差別化ポイントです。
2コア機能
01専用フローが存在しない場合の自由な作成および編集（マルチシーン動画、ブランド動画、モンタージュ、静的ループ、タイトルカード、素材リミックス）
02companion（伴走）モード：「請負業者ではなくディレクター」のスタンスで上限となる提案を提示し、ユーザーに引き算させる
03タイムラインレベルの編集指示（ハードカット/トリム/結合/並べ替え）——同一素材のマルチインスタンス + data-media-start/data-start/data-duration
04フレームパケットビルダー：ディスパッチされるワーカー向けに、境界付けられたパケット（シーンブロック + blueprint 本文 + 参照ルール）と完全な役割定義ファイル _role.md を生成
05frame-worker 出力の二次成果物規約：HTML に加えて motion.json（長さ + イン/アウトベクトル）の提出を必須とし、上位レイヤーでのシーン接合を可能にする
06セルフリフレッシュと借用の規律：依存する前にまず `skills update` を実行。他の workflow を借用する際はストーリーの構成とテイストのみを借用し、固有のスクリプトやディレクトリ規約は持ち込まない
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | hyperframes CLI（init / check / lint / snapshot / preview / render / skills update） |
| cli | hyperframes skills update（自刷新，需网络拉取最新 skill 集） |
| cli | media-use 的 prefs.mjs / recipe.mjs（偏好记录与配方应用，本地写盘） |
| package | hyperframes-core 共享库（frame-packets-core.mjs，本 skill 脚本的唯一实现来源） |
| package | 兄弟 skill 依赖（/hyperframes 路由、/hyperframes-core、/hyperframes-creative、/hyperframes-animation、/hyperframes-keyframes、/media-use、/figma） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: node scripts/frame-packets.mjs --project … --storyboard …（ローカル Node スクリプト。hype 経由
- 网络端点: 外部ネットワークアクセスの宣言: npx hyperframes skills update general-video（コマンドのセマンティクスとしてリモートからスキルセットを取得。本スキル自体のスクリプトは
- 本地工作目录: ファイル読み書きと成果物出力: .hyperframes/frame-packets/*（各シーンの packet）および _role.md（hyperframes-core の fra 経由
監査ノート： 動作範囲：ローカル Node スクリプト + 外部 hyperframes CLI。ローカルの読み書き（パケット生成、設定記録、プロジェクトファイル）のみを行い、クレデンシャルの読み取り（.env / API キー / キーチェーン / トークンへのアクセスなし）やデータの外部送信（スクリプト内での fetch/ネットワーク API の使用ゼロ）はありません。唯一のネットワーク動作は、プロセス上要求される `npx hyperframes skills update` およびその後の render/capture 系 CLI（他のスキル内で実行）であり、通信先は公式 CLI 自体のみです。注意点：サブエージェントをディスパッチする際、完全なロールファイルとパケットをワーカーに渡す必要があるため、ホストのサブエージェント権限がビルドプロセスに導入されます。読み取り範囲と書き込み範囲はホスト側で制限する必要があります。
5二重目の独立検証
- [ok] 唯一脚本是否真的『薄』（有无隐藏功能/网络） — frame-packets.mjs 全文 37 行，仅 import existsSync/path/url 与 core；导出两个函数并透传 CONFIG；无 fs 写操作、无 fetch、无 env 读取。写盘与模板拼装在 core 中，符合注释自述。
- [ok] 网络 / 凭证 / 注入面 — skill 内 0 处 URL、0 处 fetch、0 处 process.env、0 处凭证关键词；grep 'heygen' 命中的两行是 Figma 段把 figma.com 当输入 URL 的说明与派发成本段，不是 API 调用。第二遍未发现漏掉的网络或凭证路径。
- [ok] 『外部资源』条目逐条回查调用点 — npx hyperframes init/lint/check/snapshot/preview/render/skills update 均在 SKILL.md 正文出现；prefs.mjs/recipe.mjs 路径在 §2 明确定义 <MEDIA_DIR> 为已安装的 /media-use skill 目录；frame-packets-core.mjs import 在脚本原文可验。
- [ok] frame-worker 输出契约与编排者所有权是否自相矛盾 — frame-worker.md 要求 worker 写两个文件（html + motion.json）并禁止写 <audio>、禁止碰邻居场景文件；SKILL.md §5 第 5 步要求编排者收集 motion.json 并在装配时把时长/进出场向量带入缝合。两侧互补、无冲突。
- [ok] 组内一致性（packet 构建路径与自刷新提示） — 与 product-launch-video / faceless-explainer 对比：三者都调 `node <SKILL_DIR>/scripts/frame-packets.mjs`，但 general-video 的 worker 拿到的是『2–3 场景』而另两者是『一帧一 worker』——这是有意的差异（本 skill 面向长片），已在 traits 注明而非记为出入。
6結論
最適な用途： HyperFrames 環境が整備されており、「専用テンプレートが存在しない」長尺またはマルチシーン作品を制作したいユーザーに適しています：ブランド/シズル動画、モンタージュ、素材リミックス、静的ループおよびタイトルカード、自由形式の構築。また、companion（伴走共創）モードを明示的に選択するユーザーにも適しています。このモードでは、本スキルがまず完全な上限提案（ストーリーアーク、デザイン仕様、シーンごとのモーション、トランジション、オーディオアイデンティティ、開始/終了シーンの演出）を提示し、ユーザーがそれを削っていく形で進行します。
不向きな用途： 以下には適していません：① 専用 workflow がマッチするタスク——看板製品のプロモーションは /product-launch-video、テキスト主体の解説は /faceless-explainer、ナレーションなしの短いモーションは /motion-graphics へ（description で直接指定）；② 本スキルから直接新規作成を開始すること（先に /hyperframes 意図層を通す必要があります）；③ hyperframes CLI や /media-use などの兄弟スキルが存在しない環境；④ 対話なしでの一発出力を期待するユーザー——automation モードであっても check/preview の関門やレンダリング承認が存在します；⑤ 素材調達/ナレーション/カラーグレーディングそのものの機能を求めるシナリオ——それらは /media-use の管轄です。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload general-video.tar.gz
sha256:
Option B · Copy Guide for Agent4d140e0c0bd3b0ae…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit b8328f9573.