1仕組みと動作原理
唯一かつ最優先の関門は「最初の3秒間で最後まで見なければならないと思わせられるか」です。エフェクト、素材量、制作の作り込みはすべてその次であり、視聴者データが得られるまでは単なる編集上の推測に過ぎません。
.claude/skills/short-form-edit/SKILL.md
The first creative gate is: **"In the first 3 seconds is someone convinced they need to watch until the end?"** … Treat the answer as editorial judgment until audience data exists.
ここでの目的：ショート動画の成否を分けるポイントを冒頭に前倒しし、「バイラル化は願望であって編集で保証できる結果ではない」（同パラグラフ後半）ことを明確にし、エフェクトの量で説得力を代替することを防ぎます。
承認は持続的なステータスです。「完成版を作成してイテレーションする」という1回の指示でローカルでの編集とレンダリングが承認され、ドラフトごとに聞き直すのではなく不足している承認のみを追加確認します。ただし、公開や第三者への連絡には常に明示的な承認が必要です。
.claude/skills/short-form-edit/SKILL.md
User authorization persists. … ask only for missing approval, not again at every draft. Never post the reel or contact anyone without explicit authorization.
ここでの目的：レビュー関門と承認モデルを分離し、本スキル唯一の外部アクションにおけるレッドライン（公開／連絡）を提示します。
同一の実素材から明確に異なる3つの冒頭ドラフトを作成し、テーマの明確さ、好奇心、ミュート時の伝わりやすさ、視聴継続意欲を比較した上で、選定理由を記録します。
.claude/skills/short-form-edit/SKILL.md
Build three materially different rough openings using the same truthful source speech. … do not select only the loudest effect.
ここでの目的：感覚的な冒頭選定を「同一素材による複数案の比較」に置き換え、音声と粗削りなSFXを含めた低解像度アニマティックを先行作成することで、予測可能性・文脈不足・弱い見返りといった問題を低コストな段階で解消します。
オープンループの構造化：誠実な視聴者の疑問ごとに、伏線要素、配置タイムスタンプ、リマインダーまたは部分的な回答、回収タイムスタンプ、そして回収を成立させる発話エビデンスを定義します。
.claude/skills/short-form-edit/SKILL.md
Create `OPEN-LOOPS.json` with each honest viewer question … then visibly change that state.
ここでの目的：「サスペンス（引き）」を検証可能なJSONに落とし込みます。デフォルトで開くループは主ループ1つ＋副ループ最大1つとし、約束された学びはCTA前に必ず回収されなければなりません（コメントの誘導を唯一の回答にしてはならない）。
グラフィックと字幕を単語レベルの時間にバインド：字幕とインパクトイベントは単語の開始時点から±2フレーム以内に配置し、意図的な視覚先行は最大0.15秒まで許容します。
.claude/skills/short-form-edit/SKILL.md
Target within 2 frames of word onset for captions and … at most 0.15 seconds of deliberate visual anticipation.
ここでの目的：「発話への密着」を数値的な制約に変換します。子要素の出現は、index*0.4のような均等な時間差（stagger）ではなく各固有名詞にバインドし、カットごとのアンカーフレーズと時間を記録します。
ブランドアセットは真正でなければならない：記憶に基づく再描画、近似、他社ロゴの生成は禁止。検証可能なアセットが入手できない場合は、プレーンテキストのブランド名で代用します。
.claude/skills/short-form-edit/SKILL.md
Never invent, approximate, trace from memory, or generate an existing brand's logo. … use plain brand-name text rather than fabricate a mark.
ここでの目的：ロゴの真正性を監査可能な項目にします。参照元URL、オリジナルファイル、チェックサムを保持し、完成版映像内のすべてのロゴ表示箇所（小さなマークや繰り返し要素を含む）を逐次照合します。
納品前に2つのローカルバリデータ（plan構造＋footage台帳）を実行し、バリデータはセンス、アニメーション表現、聴感を認定するものではないことを明記します。
.claude/skills/short-form-edit/SKILL.md
It reads `assets/plan.json`, `assets/transcript.json`, and `assets/edit-decisions.json`. … never silently skip checks because the schema differs.
ここでの目的：機械的に検証可能な部分（字幕の単語数、時間マッピング、シーンの連続性、アンカー、Bロール台帳とハッシュ）をスクリプトに任せ、自動化できない部分は人間の目と耳に委ね、確認手法をありのままに開示します。
音声面での厳密なミキシング仕様：まず音声をノーマライズし、BGMベッドはボーカルより約14〜20 dB低くダッキングした上で実トラックに合わせて調整し、最終的に約 -16 LUFS かつ ≤ -1 dBTP を目標とします。
.claude/skills/short-form-edit/SKILL.md
start the bed roughly 14-20 dB below voice … adapting to source dynamics rather than crushing them.
ここでの目的：「音楽がうるさい」といったフィードバックを測定可能な比率変更の要求に落とし込みます。単に全体のマスターを下げるのではなく、ベッド／音声の比率が確実に下がっていることを検証しなければなりません。
Bロールの計上と再利用規律：動画1本につき同一の素材シーンは1回のみ使用可能（クロップ変更、速度変更、カラーグレーディングは新規シーンとみなさない）とし、台帳に記録してバリデータを実行します。
.claude/skills/short-form-edit/SKILL.md
Record source scene identity, file hash, and selected interval in `assets/footage-ledger.json`; run the footage validator below.
ここでの目的：同一素材の使い回しによる尺の水増しを防止します。2つのアスペクト比で同一素材を共用することは許容されますが（意図された挙動）、それ以外の再利用は台帳内でバリデータによって弾かれる必要があります。
2コア機能
01トーキングヘッド素材 → 完成版ショート動画の再編集全ワークフロー（クリップ選定、不要部分カット、EDL、字幕、グラフィック、Bロール、音楽、SFX、納品）
023案の冒頭比較 ＋ 低解像度アニマティックレビュー（開始の第1フレーム、インパクト、展開、メインカットへの復帰のコマ送り確認を含む）
03オープンループ構造化によるストーリーテリング層（OPEN-LOOPS.json：疑問／伏線／リマインダー／回収 ＋ 発話エビデンス）
04plan構造バリデータ：字幕の単語単位での文字起こし一致、タイミング整合性、カット点をまたがない単語配置、正しいソースマッピング、シーンの連続性とフレーム同期、カット点近傍のアンカー、2.2秒超のイベント空白に対する理由付け
05footage台帳バリデータ：各行にソースシーンID ＋ sha256 ＋ 正当な区間を要求、同一素材シーンの重複や区間の重複を禁止し、ファイルごとにハッシュを再計算
06縦型／横型の両アスペクト比の個別検証およびモバイルセーフゾーン配置（1080x1920 推奨 x=90..930, y=200..1600、右側と下部はSNSのUI用に確保）
07チェックリスト化されたクオリティゲート（references/quality-gates.md）：最初の3秒の根拠からロゴの真正性まで多岐にわたり、各項目でエビデンスと失敗例を要求
08オーディオプロダクション：文字起こしタイミング同期、BGMと音声の比率、SFXイベントマップ（ファイルの開始位置ではなく聞き取れるインパクト点に同期）、-16 LUFS / ≤ -1 dBTP の目標値
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | Node（两个本地校验器） |
| cli | FFmpeg（抽转场条带、抽帧检查编码后的开场与 hero 帧） |
| api | 转写服务（默认 ElevenLabs Scribe，备选 Whisper；凭证与服务成本见 docs/TOOLS-AND-API-KEYS.md） |
| api | 生成式 B-roll / 图像（可选，Kie.ai 或用户自选提供方，需检查账号与额度） |
| cli | HyperFrames CLI（lint / 实时预览 / draft → final 渲染；capture 卡住时允许确定性图形导出 + FFmpeg 合成） |
| package | 兄弟 skill：hyperframes、video-storytelling（构建前必读），以及 edit-video / cut-silences（分工边界） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: node scripts/validate-plan.mjs video-projects/<slug>（完全ローカル: plan/transcript/ を読み込み）
- 网络端点: 宣言された外部ネットワークアクセス: なし（スキル自身のディレクトリ内にはURLもfetchも皆無）：文字起こしと生成は外部クライアントまたはユーザー環境で実行
- 本地工作目录: ファイルの読み書きと成果物出力: video-projects/<slug>/assets/：plan.json、transcript.json、edit-decisions.json
監査ノート： 。スキル自身のディレクトリ内のコードは完全にローカルで完結しています（scripts/validate-plan.mjs および scripts/validate-footage.mjs はプロジェクト内のJSONを読み取り、sha256を計算し、結果を出力するだけであり、ネットワーク接続もクレデンシャルの読み取りも行いません。ディレクトリ全体のトークンスキャン結果：process.envなし、fetchなし、http/https URLなし）。オレンジフラグが適用された理由は、SKILL.md自身が宣言している制作ワークフローに起因します：① **ユーザー素材の外部送信**——元動画を外部の文字起こしサービス（デフォルトはElevenLabs Scribe、フォールバックにWhisperを指定し、docs/TOOLS-AND-API-KEYS.mdのクレデンシャルとサービスコストの確認を要求）に送信するよう指示しており、音声・動画コンテンツがローカルマシン外に出る点；② **任意の有料生成**——Bロール／画像をKie.aiまたはユーザーが選択したプロバイダ経由で生成し、SKILL.mdでアカウント、利用枠、連携の事前確認を要求している点。いずれも「自身が宣言した用途のためにユーザー素材を外部サービス／生成バックエンドに送信する（アカウント枠の消費を含む）」に該当し、どちらもダウングレード（生成の代わりに手持ち素材を使用する、プロバイダを変更するなど）が可能です。セキュリティ低下（TLSの無効化、--no-verifyなど）、自動化回避、任意のコード実行ベクトルは見られませんでした。自動化に関連する処理の1つは、プレビュー用のヘッドレスブラウザでPointer Lockとpointer captureを無効化するという明確なセキュリティ強化策です。
5二重目の独立検証
- [ok] 两个自带脚本是否真的不联网、不读凭证（决定档位下限） — validate-plan.mjs 只有 fs/path import 与纯函数导出；validate-footage.mjs 为 fs/path/crypto。全目录 grep 无 process.env、无 fetch/axios、无 http(s):// 调用点（文档中的 URL 仅示例命令与文档引用）。
- [ok] 转写/生成服务是否真由本 skill 声明（橙档依据） — SKILL.md 原文 'Transcribe with the student's chosen provider; ElevenLabs Scribe is Nate's default.' 与 'Kie.ai is Nate's optional provider for generated moving inserts and images.'，两处都要求先看 docs/TOOLS-AND-API-KEYS.md 的凭证与成本。即：外发是**流程指示**，不是随包脚本行为——报告中两者分开陈述。
- [discrepancy] 「禁用 Pointer Lock/pointer capture」是安全收紧还是绕过防护 — ［判定：判定为收紧，不影响档位］SKILL.md 'Browser automation is headless with Pointer Lock and pointer capture disabled in every context.' 出现在「跑 lint 与看实时预览」段，目的是避免无头环境下指针锁抢占；它是关掉被测页面夺权，而非绕过平台自动化侦测（无 AutomationControlled、无真实键击替身、无 remote-allow-origins）。不构成红档特征。
- [ok] 校验器能否替代「品味/动效/听感」复核 — SKILL.md 明写 'The plan validator catches structural defects but cannot certify taste, motion, or the audio listening pass'，并要求另做不看屏的娱乐性复核（ENTERTAINMENT-REVIEW.md）且如实披露缺失的复核模态。脚本与人类判断的分界自洽。
- [unlocatable] 「前 3 秒」这类判断是否有可核的客观阈值 — 门禁条款要求记录观众收益、未解疑问、第 3 秒可见证据与确切回报场景，但「具体到第几帧算成立」没有客观阈值；quality-gates.md 只给失败样例（如 attention grabbed with no reason to continue）。本次只读侦查无法代作者给出可复现判定，故如实标为无法定位为客观标准。
- [ok] SKILL.md 指名的仓库级文档是否真的存在（避免文档断链） — docs/TOOLS-AND-API-KEYS.md、MOTION_PHILOSOPHY.md 与 references/{quality-gates,plan-schema,curiosity-and-entertainment,reference-analysis,premium-motion-and-footage}.md 在仓库内均可定位（非虚构引用）。
6結論
最適な用途： トーキングヘッドの動画素材から完成したショート動画を制作したいユーザーに最適です：YouTubeショート、Reels、縦型ショート広告など、「選定 — 不要部分カット — 字幕 — グラフィック — Bロール — 音楽 — SFX — 検証」をワンストップで必要とし、スクリプト検証と人間の視覚・聴感による二重の検収を受け入れられるケース。また、ショート動画の編集メソドロジーを学びたい読者にも適しています（SKILL.md自体が失敗例付きの編集規範となっています）。
不向きな用途： 不向きなケース：① 長尺動画の編集（edit-videoを使用）；② 無音のカットのみを目的とする場合（cut-silencesを使用）；③ 完全にオフラインであり、外部の文字起こしサービスに素材を渡せない環境；④ 実素材が存在せず、生成AIのみで動画を組み立てようとするシーン（本スキルは実証の代わりに生成コンテンツを用いることを繰り返し禁止しています）；⑤「確実なバズ」を期待するユーザー（ドキュメント内でそのような約束は明確に拒否されています）。
Install Agent-Ready
① Verified Mirror 2026-09-28
Option A · Direct DownloadDownload short-form-edit.tar.gz
sha256:
Option B · Copy Guide for Agentaeca951228fc9c2b…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 0d30152a82.