1仕組みと動作原理
2つの入口は1つのゲートを共有します。topicモードでは4問フィルターは選題と取捨選択にのみ使用され、ユーザーが指定したテーマを拒否してはなりません(不合格の箇所、生じる損失を説明し、代替案を提示する)。sourceモードではフィルターは一切適用されず、ユーザー素材をすべて読み込んだ上で「ストーリーライン鉱脈」を実行します。ソース素材をアウトラインではなく鉱山として扱い、on-ramp / tension / turn / mechanism / receiptsの5要素を抽出します。複数ソース・複数ラインがあっても背骨となる主軸は1本のみを選択し、残りはreceiptsに格下げします。
- **Topic mode** (the user names a subject, or asks for ideas): the four-part filter governs IDEATION and tie-breaking only.
構造の背骨は厳格なウェイト配分表です:FAMILIAR 15% → DIG(人物名+日付を明記)5% → STORY 15% → ARTIFACT 10% → MECHANISM(視聴者が画面上で即座に検証可能)20% → SECOND WIND 15% → THESIS(黄色い丸)10% → CLOSE 10%。THE FAMILYは新規ビートではなくFAMILIARの後半に属します。
FAMILIAR 15% → DIG (person + date named) 5% → STORY 15% → THE ARTIFACT BEAT 10% → MECHANISM the viewer verifies on screen 20% → SECOND WIND (a technology removes a constraint) 15% → THESIS in the yellow circle 10% → CLOSE mirrors the open 10%.
デザインパスでは、まずコンタクトシート(ビートごとに1フレーム、960×540タイル、HTML → ヘッドレスChromeスクリーンショット)を納品し、納品前にLOOK GATEセルフチェックを実施します。カラーパレットは公式に計測された固定値(ink #1a1a1a / yellow #FFE619 / process blue #66CFFF / specimen blue #58BCEC / greys / ground #fbfaf8)を用い、見出しはArchivo Black、各フレームは命名済みrecipeに準拠し、黄色の丸を反復する視覚媒体として使用します。この段階での修正は完成後の修正に比べてコストが10分の1で済みます。また、汚染防止ルールとして、ソースドキュメントに独自のブランド体系がある場合でも無批判に継承してはなりません(brand-faithfulは別ワークフローです)。
Iterate here — it is 10x cheaper than comp notes.
音声クロック:VOは先行録音またはTTSで生成します(TTS入力は発音用スクリプトとして記述:数字はスペルアウト、固有名詞は読み通りに記述)。その後、文字起こしにより単語レベルのタイムスタンプを取得します。以降のすべてのカット、ポップアップ、ハイライトは単語のタイミングに同期され、VOの差し替えは動画全体の再タイミング調整を意味します。字幕はスクリプトファイルではなく「実際に発声された音声」から書き起こされます。
Transcribe the result for word timestamps — audio is the clock; every cut, pop, and highlight keys to a word time.
シーム(seam)はこのスキルの核心メカニズムであり、「生成+検証」の2点構成です。まずledger.jsonを記述し(1シーム1行:カット秒、exit/entryの軸+方向、動きを担うセレクタ、テクニック)、seam-stamp.mjsを用いてマスターシームコードをindex.html(// <seams:auto>ブロックを置換)に刻印します。その後seam-gate.mjsで数値検証を行います。ledger行の一致、カット点でexitが静止せず動作中であること、entryが静止状態から開始しないこと、実測方向とledgerの一致、entry/exit速度の一致(WARN)、ゼロオーバーラップ(同一フレームで片側のみ可視、ディゾルブ不可)、Z符号(両側でscale変化の方向が一致し、incomingシーン自体の入場による符号反転がないかスキャン)、キャリア境界の矩形連続性(祖先のscaleを含め、許容誤差12px/5%)。
The script (usage + ledger schema: [seam-gate.md](seam-gate.md)) numerically enforces, per seam: ledger-row consistency, exit still moving at the cut, entry mid-flight (never from rest), measured direction = ledger direction, entry/exit speed match (WARN), **zero overlap** (one side visible per frame — the cut is not a dissolve), the **Z sign** rule
スライド化防止の基準値と技術宣言:各ビートはビートマップの段階でレイアウトrecipeとモーション手法を**宣言**しなければなりません(動画ビルド時の即興は禁止)。動画全体で最低基準をクリアする必要があります(キャリアをプッシュして突き抜ける換景zoom-isolation ≥1回、解決編の演出に用いるinverse zoom-through ≥1回、全画面で収まるdrive-past/scale traversal ≥2回、平面カードでは不可能な動きを行う背景切り抜きカットアウト ≥1回、newsprint layeringとcircle reveal ≥1回)。また厳格な上限も設定されています(静止カード/左右分割は最大でも3ビートに1回まで、隣接ビートで同一recipe・同一手法の連続禁止)。
- CAPS: static-card / side-by-side layouts ≤ one third of beats; no two consecutive beats share the same layout recipe or the same treatment.
2コア機能
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | HyperFrames 预览服务(版本钉在脚本常量里:0.8.14;--project 模式下由 npx 拉起,未缓存时会从 npm 下载;可改用 --url 复用已在跑的服务) |
| cli | 上游脚手架/技能安装:npx skills add heygen-com/hyperframes、npx hyperframes init |
| cli | Node 22+ 与本地 Chrome/chrome-headless-shell(verifier 自找 Puppeteer 缓存或系统 Chrome,用隔离临时 profile) |
| network | source 模式会抓公开引用与公共领域/开放许可资产(最多一跳公开引用),资产来源为 Wikimedia Commons API、LOC 等声明的来源 |
| api | 可选的第三方 TTS / 转写 API(须先向用户说明 provider、数据、所需凭据与可能成本并获得批准) |
| network | 预览期仍可能加载构图自身声明的远端资产(verifier 只把 --url/--comp-url 限制为 localhost,不限制页面内的远端引用) |
4推奨統制措置と判定根拠
- scripts/: ローカルスクリプトまたはコマンドの実行: node <SKILL_DIR>/scripts/seam-stamp.mjs --ledger ledger.json --write index.
- 网络端点: 外部ネットワークアクセスの宣言: registry.npmjs.org: --projectモード時にnpx経由でバージョン固定されたHyperFramesプレビューサービスを起動(未キャッシュ時はダウンロード);npx ski
- 本地工作目录: ファイルの読み書きと成果物の出力: ユーザープロジェクトディレクトリ内: index.html(// <seams:auto>ブロックのみ置換)、プロジェクトソースコード、ダウンロードしたアセット、audio/、コンタクトシート、r
5二重目の独立検証
- [ok] 『--url/--comp-url 只接受 localhost』是否真在代码里 — seam-gate.mjs 有 localUrl(value, label) 校验函数,非 localhost 直接报错;--project 模式自己 spawn 预览服务后拼 http://localhost:<port> 再连。文档声明与实现一致。
- [ok] seam-gate 到底验什么(本题重点) — 逐 seam 的报告行对应规则:ledger(plan 层 exit/entry 向量一致)、exit-moving / entry-moving(规则1/3:不许静止退出、不许从静止入场)、exit-direction / entry-direction(实测符号 = ledger 符号)、speed-match(law §3 速度匹配,仅 WARN)、zero-overlap(规则6:同帧只有一侧可见,切口不是叠化)、z-sign-scan(规则7:incoming 场景自身入场不得与 Z 符号打架)、carrier-*(规则3/4:carrier 矩形连续性,含祖先 scale,12px/5% 容差)。速度不匹配只是警告,不是失败——使用者需自己看警告与渲染帧对。
- [ok] 子进程环境是否被显式过滤 — previewEnv() 只取 15 个白名单系统变量 + npm_config_audit/fund,不用 process.env 整包;另单独读 CHROME_PATH 找浏览器。
- [ok] stamp 的写入边界 — seam-stamp.mjs 的 --write 目标 resolve 后必须落在当前项目目录内,且拒绝符号链接(lstatSync 判定)——降低借 ledger 写项目外文件的面。
- [ok] 文档量化门禁是否都有出处 — 色值/字体/recipe 命名在 vox-collage-layout.md 与 SKILL.md 的 LOOK GATE;运动法则与反模式表在 motion-continuity.md;转场代码与占位符在 velocity-matched-transitions-gsap.md;ledger schema 与容差在 seam-gate.md。引用链完整。
- [unlocatable] 『Grammar measured from Vox's Cooper Black film』所述测量过程与样本 — 该测量(以及 motion 的 frame-by-frame calibration)的过程与数据不在本 skill 目录内,无测量脚本或样本文件;只作为文档声明记录,本次只读侦查未运行 verifier 或渲染,故不作为已核事实使用。
6結論
e75b209b1949465d…