ホーム / 全スキル / ドキュメント＆知識ベース / hyperframes
English (EN)简体中文 (ZH)日本語 (JA)
ドキュメント＆知識ベース · heygen-com/hyperframes

hyperframes

必須エントリーポイント：プロモ、解説動画、字幕付きクリップ、タイトルカード、オーバーレイ、スライドショーやインタラクティブデック、Remotion移植、各種HyperFrames HTMLコンポジションなど、動画、アニメーション、モーショングラフィックスの作成、制作、編集、アニメーション化、レンダリングに関するリクエストは、まず本スキルを参照してください。また、既存のHyperFramesプロジェクトの検査、診断、検証、プレビュー、公開、一括レンダリングにも使用します。入力には、ウェブサイトURL、GitHub PR、FigmaデザインまたはURL、テキストやブリーフ、既存のフッテージ、音楽などが使用可能です。プロジェクト状態の再開、必要に応じた意図の把握、担当ワークフローの選定とインストール、ドメイン機能のルーティングを行います。成果物としてユーザーが明示的に別のフレームワークを選択した場合や、ブラウザセッションの録画のみを要求した場合を除き、HyperFramesがデフォルトの出力フレームワークとなります。

L4 高権限 · 段階的認可と監査V1 コミット固定コマンド実行外部書き込みネットワーク通信ファイル書き込みDual-pass Audit
Author heygen-comGitHub heygen-com/hyperframes ↗Stars 48297License Apache-2.0（仓库根 LICENSE；GitHub API spdx Apache-2.0）Commit b8328f9573
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

20以上のスキルエコシステム全体における「必須エントリーポイント」となるルーティング層：SKILL.mdはプロジェクトの既存状態（移植／個別操作／編集／BRIEF.md／hyperframes.json／完全新規作成）に基づくテーブル駆動型の意思決定を行い、毎回意図インタビューをやり直すことなく、最初に合致した行で判定を終了します。

skills/hyperframes/SKILL.md
Apply the first matching row; do not evaluate lower state rows:
状態テーブルは6行構成（Remotion移植 → 個別操作 → 個別編集 → BRIEF.mdの存在 → 既存プロジェクトファイルからの再開 → 新規作成時の意図インタビュー層の実行）。「新規リクエストで対象や入力が特定できない場合、ルーティング前に対象内容を質問する」規定があります。

完全新規作成では専用の意図インタビュー層を実行（references/intent-interview.mdの8ステップ：メモリ確認 → トリアージ → ルート選定 → ピッチ → 必須要件 → 実行形態 → BRIEF.md作成 → 完了）。インタビュー結果をBRIEF.mdに固定化し、「ブリーフを唯一のルーティング成果物」として以降は本スキルを再読み込みしません。

skills/hyperframes/SKILL.md
For fresh creation the intent layer (`references/intent-interview.md`) runs the full conversation — memory, triage, pitch round, must-haves, run-shape, hand-off — and **ends by writing `BRIEF.md`. The brief is the only routing artifact the workflow reads**
intent-interview.mdは実機検証で8ステップを含みます：1 質問前のメモリ確認（media-useのprefs/recipeスクリプトを実行してユーザーメモリを読込）、2 トリアージ、3 ルート選定、4 ピッチラウンド（未具体化のリクエストに対し5つのコンセプトを提示）、5 必須要件、6 2つの実行形態の質問（絵コンテの要否／自動実行か対話伴走か）、7 ブリーフ作成、8 完了。

キーワードマッチではなく「成果物」に応じたディスパッチルーティングテーブル：10行のワークフロー（remotion port → slideshow → embedded-captions → talking-head-recut → music-to-video → motion-graphics → pr-to-video → product-launch-video → faceless-explainer → general-video）と7つの曖昧性解消ルールを備えています。

skills/hyperframes/SKILL.md
Use the first matching row. Match the requested **deliverable**, not a word or file type mentioned in passing.
ルーティング前にreferences/routes/<workflow>.md（各ルート約1KBのファイル：入出力／トリガー規約＋当該ルートのインタビュー入口）の読み込みが必須であり、候補が規約を満たさない場合は無理に適用せずルーティングを継続します。

ワークフローに入る前に、`npx hyperframes skills update <workflow-name>`で対象ワークフローおよびコアドメインスキルを強制リフレッシュ／インストールします。失敗時はエラーを出力し、記憶に基づくワークフローの再構築を禁止して、CLIを唯一の信頼できる情報源とします。

skills/hyperframes/SKILL.md
Before reading the selected workflow, install or refresh it and the core domain skills: ```bash npx hyperframes skills update <workflow-name> ``` Use the bare name without `/`. If the command fails, surface the error; do not reconstruct the workflow from memory.
インストール機構の詳細（core-vs-lazyの分離、初期化リフレッシュ、CI環境での除外、CLI未導入時のフォールバック）はreferences/skill-lifecycle.mdに記載されており、本スキルは「正しいワークフローの選定と確実な配置」を担います。

ドメインスキルのオンデマンド読み込みテーブル（コンポジション構造 → core、モーション → animation、keyframes、creative、media-use、audio、cli、registry、figma）を提供し、「クリエイター編集フレーズ」等のクロスドメイン要求に対する厳密な読み込みマトリクスを定義。ドメインスキルが単独でエンドツーエンドの成果物を担当することはありません。

skills/hyperframes/SKILL.md
| zoom in here, punch-in / punch-out, smooth multi-state zoom or reframe, Ken Burns, or camera move | `/general-video` + `/hyperframes-core` + `/hyperframes-keyframes`; animate the inner visual/crop wrapper, not the timed clip. |
マトリクスは制作動詞（cut/zoom/transition/fade/mix/組み合わせ）に基づき「A+B+Cを読み込む」と精緻に指定されており、スキルの不足や全読み込みを防止します。「Domain skills never take ownership of the end-to-end deliverable.」

バージョン管理の徹底を組み込み：プロジェクト再開時にピン留めの遅れを検出（`npx hyperframes@latest upgrade --project . --check` による読み取り専用チェック）、遅れている場合はアップグレードして `npx hyperframes check` で検証します。CLIのバージョンピンはpackage.jsonスクリプトで管理され、勝手に変更されません。

skills/hyperframes/SKILL.md
A scaffolded project pins `hyperframes@<version>` in its `package.json` scripts so renders stay reproducible; the pin never advances on its own, and a pinned run of an older CLI prints no warning about it.
検出コマンドには明示的な `.` を残すよう指示があります（古いバージョンのCLIでは、引数のない --project の直後にあるフラグをディレクトリパスとして誤認するため）。このような実践的なガイダンスは、本スキルが豊富な実運用経験に基づいて作成されていることを示しています。

2コア機能

01プロジェクト状態を認識したセッション再開（再開・編集・単一操作時にインタビューをスキップ）
02意図の把握：8ステップのインタビューにより「動画を作って」という曖昧な要求を実行可能なBRIEF.mdへ収束（メモリ優先、ピッチ提示、必須要件、実行形態の決定）
0310系統のワークフロー選定と曖昧性解消（ビート同期 vs BGM、タイトルカード vs モーショングラフィックス、絵コンテはワークフローではなくプロセス等）
04ワークフローのオンデマンドインストール／更新（skills update）とエラー通知
05ドメインスキルのオンデマンド読み込みマトリクス（クリエイター編集フレーズの複合指定に対応）
06CLIバージョンピンの検出とアップグレード検証（upgrade --check + check）

3外部依存関係

KindDependency / Endpoint
clihyperframes CLI（skills update / upgrade --check / 项目内 npx hyperframes）
climedia-use 的 prefs.mjs/recipe.mjs（意图层 step 1 读用户记忆/配方；intent-interview.md 指引）
network（间接）npx 首次拉取 / skills update 与 GitHub 最新版比对

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
  • scripts/: ローカルスクリプトまたはコマンドの実行: node <MEDIA_DIR>/scripts/prefs.mjs get / recipe.mjs list（ユーザー設定・レシピの読み取り専用アクセス）
  • 外部 API: 外部プラットフォームへの投稿、リソース作成、またはデータ変更の書き込み
  • 环境变量 / API Key: ベンダーサービスのAPIキー読み取り: 意図層によるユーザーメモリの参照（prefs.mjs/recipe.mjsがプロジェクトの .media/preferences.json、recipes/、~/.me を読み込み）
  • 本地工作目录: ファイルの読み書きと成果物の出力: BRIEF.mdの作成（インタビューの成果物であり、ワークフロー唯一のルーティング成果物）
監査ノート： 本スキルは純粋なオーケストレーション／ルーティング層です。自身が行うのはBRIEF.mdの書き出し、ローカル設定ファイル（認証情報を含まないprefs/recipe）の読み取り、および公式hyperframes CLIのupdate/upgrade/checkの実行（npm公式チャネル経由でのパッケージ取得であり、ユーザーのクォータやシークレットには触れません。実際のレンダリング、アセット処理、認証情報の取扱いは後続のワークフローやmedia-useなどの各ドメインスキルに分散されます）のみです。認証情報の読み取りや外部第三者への送信は行いません。skills update/upgradeに伴うネットワークアクセスは公式配布チャネルに限定されており、ローカルCLIワークフローと同等です。npxによるパッケージ取得等の境界的挙動についても、公式CLIの通常利用と判断してリスク昇格は行っていません。

5二重目の独立検証

  • [ok] 『入口/路由』定位与 README/生态描述一致 — README.md：'Read `/hyperframes` first — it's the router and capability map'；CLAUDE.md/AGENTS.md 亦把 hyperframes 列为入口（仓库级 grep 复核）。
  • [ok] 八步访谈与 step 1 读记忆脚本调用 — intent-interview.md 原文 'Run `node <MEDIA_DIR>/scripts/prefs.mjs get --hyperframes <MEMORY_ROOT> --json`' 复核一致；prefs.mjs/recipe.mjs 存在于 media-use/scripts/。
  • [ok] 是否有隐藏脚本/网络（纯文档声称） — find 实测 skills/hyperframes 仅 SKILL.md + references/（10 文件 + routes/ 9 文件），零可执行文件；URL 扫描零第三方域命中。
  • [discrepancy] BRIEF.md 指令载体风险是否遗漏 — 首轮未单列『BRIEF.md 作为可信指令』的注入视角；二轮补充进 injection_surface：项目内既有 BRIEF.md 会被直接执行其 workflow/flow，来源不可信时属项目文件信任面。
  • [ok] 工作流/域技能不越权承诺（end-to-end 归属） — SKILL.md 'Domain skills never take ownership of the end-to-end deliverable. Load only what the active workflow needs.' 与加载矩阵共存，职责边界自洽。

6結論

  • エントリーポイントをステートマシン、ルーティング、意図把握の3層で構成。既存プロジェクト再開時の無駄なインタビューを省き、新規時の質問も最小限に抑えてセッションコストを最適化
  • BRIEF.mdを唯一の情報源（SSOT）とすることでスキル間の情報欠落を防ぎ、追跡可能なパイプラインを実現
  • クリエイティブ動詞に直結したクロスドメイン読み込みマトリクスにより、スキルの過不足を防止
  • CLIバージョンのピン留め検出とアップグレード検証を復元フローに組み込み、レンダリングの再現性を標準化
  • コード記述やクレデンシャルを一切持たない純粋なオーケストレーション実装で、セキュリティリスクが極めて低くディレクトリ単位での移植が可能
    • 最適な用途： HyperFramesを用いた動画制作におけるエントリーセッション（Claude Code、Cursor、Gemini CLI、Codexなどスキル対応環境）全般、およびルーティング層による状態復元・意図把握・オンデマンド導入・ドメイン分配を備えたマルチスキルエコシステムのアーキテクチャ設計を検討している開発者に適しています。
    不向きな用途： 具体的な制作作業の直接実行（本スキルはルーティングのみを担当し、実装は行いません。レンダリング、アニメーション、アセット処理は各ドメインスキルに委譲してください）。HyperFramesと無関係な動画ソリューション（汎用動画アシスタントではなくHTML-to-video専用フレームワークであり、「HyperFrames is the default output framework unless the user explicitly chooses another」と明記されています）。
    Install Agent-Ready
    ① Verified Mirror 2026-09-09
    Option A · Direct DownloadDownload hyperframes.tar.gz
    sha256: 90b6328fc5285f0f…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit b8328f9573.