1仕組みと動作原理
SKILL.md 自体はルーティングテーブル兼ワークフローの骨格に過ぎず、創作ナレッジはすべて references/ ナレッジカード、palettes/、frame-presets/ アセットへ集約されオンデマンドで読み込まれます。タスク種別に応じて最初に読むカードを決定し、全カードの一括読み込みを防ぎます。
| Palette-specific color tokens | `palettes/*.md` |
「Web サイト感」の排除がコアメソドロジーです。非自明なコンポジションでは house-style と video-composition の 2 枚のカードの事前精読を義務付け、前者が「interpret the prompt, generate real content(プロンプトを解釈し本物のコンテンツを生成する)」と背景/前景レイヤーのレシピを定義します。
Skipping these is the single biggest cause of generic, web-page-looking output. They are not optional rows in the routing table below — for anything beyond a one-line edit, open both before you choose colors or write HTML.
デザイン仕様のパースには明確な優先度(frame.md → design.md → DESIGN.md)が設定されています。frontmatter のトークンが規範的な「ブランドの真実(brand truth)」であり、散文は判断のためのコンテキストに過ぎません。
If a project has a design spec, **read it first** and treat its frontmatter tokens as brand truth (colors, fonts, spacing, tone, constraints).
「すぐに使える」ブランドスターターアセットを提供します。12 種類の frame-presets(それぞれ FRAME.md + caption-skin.html + frame-showcase.html を同梱)と 9 種類の palettes を用意し、ワークフローで FRAME.md を丸ごと frame.md として adopt 可能です。
- Ready-made frame-preset (optional) → `frame-presets/` (adopt a `FRAME.md` as `frame.md`; see `references/design-spec.md`)
検証可能なアウトプットは 3 つのスクリプトによって支えられています。contrast-report.mjs はレンダリングフレームのコントラスト監査を実行し(@hyperframes/producer + sharp をブートストラップしてヘッドレスでサンプルフレームをキャプチャ)、extract-audio-data.py は numpy/ffmpeg を用いて音声連動構図用のオーディオ周波数帯を事前抽出します。
- `scripts/contrast-report.mjs` — inspect contrast warnings from rendered frames. - `scripts/extract-audio-data.py` — pre-extract audio bands for audio-reactive compositions. - `scripts/package-loader.mjs` — support script for bundled creative tooling.
境界の規律が SKILL.md に明記されています。本スキルはアニメーションを扱わず(hyperframes-animation へ委託)、hyperframes-core の技術規則を上書きせず、軽微な変更に余計な装飾を加え書き足さず、すべてのカードを一度に読み込みません。
Do not override `hyperframes-core` technical rules. Do not require a design system for a minimal technical composition. Do not add extra scenes, narration, music, captions, or transitions unless the request calls for them or you first propose the expansion.
2コア機能
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| package | @hyperframes/producer / @hyperframes/core / sharp(contrast-report.mjs 经 package-loader 按需 bootstrap) |
| cli | python3 + numpy + ffmpeg(extract-audio-data.py 解码与频段分析) |
| network | Google Fonts metadata API(找字体时 agent 被指引 curl 查询) |
| network | GSAP CDN(frame-showcase/design-picker 预览 HTML 引 jsdelivr gsap;属产物运行依赖而非 skill 自身外发) |
4推奨統制措置と判定根拠
- scripts/: ローカルスクリプトまたはコマンドの実行: node skills/hyperframes-creative/scripts/contrast-report.mjs(レンダリングフレームをローカルキャプチャして解析。依存関係不足時
- scripts/ 或 SKILL.md: 外部言語パッケージ依存関係の動的インストールを宣言
- 网络端点: 外部ネットワークアクセスの宣言: fonts.google.com/metadata/fonts(エージェントが案内される任意の curl 実行、/tmp のローカル JSON に保存)
- 本地工作目录: ファイルの読み書きと成果物の出力: クリエイティブ成果物: frame.md/design.md/DESIGN.md およびコンポジション HTML(エージェントがワークフローに従いプロジェクトファイルを出力)
5二重目の独立検証
- [ok] 『脚本目录无网络外发』 — 对 hyperframes-creative 全部 .mjs/.py/.md 做 http(s) 扫描:命中仅 design-picker/showcase 的 jsdelivr gsap、caption-skin 的 gsap、typography.md 的 fonts.google metadata、design-picker.md 的 localhost 提示——无脚本级外发。
- [ok] contrast-report.mjs 能力真实存在(非提示词) — 源码确认 bootstrap @hyperframes/producer/@hyperframes/core/[email protected] 并调用 createCaptureSession/captureFrameToBuffer/closeCaptureSession,输出 .hyperframes/contrast。
- [ok] frame-presets/palettes 资产计数 — find 实测:frame-presets 含 12+ preset(每套 FRAME.md/caption-skin/frame-showcase,code-editorial 附字体与 OFL)、palettes 9 个 md、references 17 个 md,与 SKILL.md 路由表指向一致。
- [discrepancy] 安全结论有无漏网(CDN 是否被误当无外发) — 第一遍初判『无网络』需修正:产物/预览 HTML 引用 jsdelivr gsap、字体检索指引 curl fonts.google.com——均非 skill 脚本自身外发而是 agent/运行时行为,已如实列入 external_deps 并据以定级 yellow(统一分档:存在公开网络外发即不低于 yellow)。
- [ok] 与动画技能分工声称 — SKILL.md 引言与 Boundaries 两处声明 non-animation 并指向 hyperframes-animation;animation SKILL.md 亦反向声明 creative 管非动画方向,双向一致。
6結論
c11a1f80c92e6741…