@autoaiai/aicut 0.1.11 → 0.1.13

package/skills/video-script-builder/references/component-catalog.md

@@ -1,197 +0,0 @@
----
-name: 组件目录
-description: HyperFrames 官方组件完整目录，用于分镜制作时的组件选型。按场景类型映射推荐组件，是 Step 2（组件选型）的核心参考文档。
----
-
-# 组件目录
-
-## 目录
-
-- [如何使用本目录](#如何使用本目录)
-- [场景到组件映射表](#场景--组件映射表)
-- [完整组件列表](#完整组件列表)
-- [安装说明](#安装说明)
-- [找不到匹配组件](#找不到匹配组件)
-
-## 如何使用本目录
-
-在 Step 2（组件选型）阶段，Agent 按照分镜表逐一为每个镜头匹配组件。工作流程：
-
-1. 识别当前镜头的场景类型（Hook/概念/数据/对比/产品/流程/氛围/CTA/社媒/地图/过渡）
-2. 查下表找到对应行，首选组件为推荐方案
-3. 若首选不匹配具体需求（风格冲突、镜头时长特殊等），选择备选
-4. 若整行都不匹配，跳转到文末「找不到匹配组件」章节
-5. 安装组件：`npx hyperframes add <name>`
-
-## 场景 → 组件映射表
-
-| 场景类型 | 首选组件 | 备选 | 何时用 |
-|---------|---------|------|--------|
-| Hook 开场 | vfx-text-cursor | caption-kinetic-slam | 前 3s 抓注意力 |
-| 概念/定义 | data-chart | flowchart, liquid-glass-widgets | 抽象概念具象化 |
-| 数据揭示 | data-chart | us-map, world-map | 数字/统计 |
-| 对比/反差 | vfx-shatter | grid-pixelate-wipe | A vs B |
-| 产品展示 | vfx-iphone-device | app-showcase, ios26-liquid-glass | 展示界面/设备 |
-| 流程/步骤 | flowchart | liquid-glass-media-controls | 1→2→3 步骤 |
-| 氛围/情绪 | grain-overlay + vignette | vfx-liquid-background | 建立 mood |
-| CTA 收尾 | logo-outro | caption-kinetic-slam | 行动召唤 |
-| 社媒引用 | x-post | reddit-post, spotify-card | 引用社交媒体内容 |
-| 地图/地理 | world-map | us-map-bubble, nyc-paris-flight | 地理位置相关 |
-| 过渡/桥接 | parallax-zoom | parallax-unzoom, grid-pixelate-wipe | 段落间过渡 |
-
-## 完整组件列表
-
-### 独立 Shader 转场（14 个）
-详见 `references/shader-transitions.md`。此处列出名称以便索引：
-
-| 组件名 | 类型 | 时长 | 安装命令 |
-|--------|------|------|----------|
-| glitch | block | 0.5s | `npx hyperframes add glitch` |
-| whip-pan | block | 0.5s | `npx hyperframes add whip-pan` |
-| light-leak | block | 0.6s | `npx hyperframes add light-leak` |
-| cinematic-zoom | block | 0.6s | `npx hyperframes add cinematic-zoom` |
-| thermal-distortion | block | 0.5s | `npx hyperframes add thermal-distortion` |
-| swirl-vortex | block | 0.6s | `npx hyperframes add swirl-vortex` |
-| domain-warp-dissolve | block | 0.6s | `npx hyperframes add domain-warp-dissolve` |
-| ridged-burn | block | 0.5s | `npx hyperframes add ridged-burn` |
-| sdf-iris | block | 0.5s | `npx hyperframes add sdf-iris` |
-| cross-warp-morph | block | 0.6s | `npx hyperframes add cross-warp-morph` |
-| flash-through-white | block | 0.4s | `npx hyperframes add flash-through-white` |
-| chromatic-radial-split | block | 0.6s | `npx hyperframes add chromatic-radial-split` |
-| gravitational-lens | block | 0.6s | `npx hyperframes add gravitational-lens` |
-| ripple-waves | block | 0.5s | `npx hyperframes add ripple-waves` |
-
-### 转场展示集（13个）
-每套包含多种同风格转场变体，用于需要风格统一但具体方向未定的场景。
-
-| 组件名 | 类型 | 安装命令 |
-|--------|------|----------|
-| transitions-3d | block | `npx hyperframes add transitions-3d` |
-| transitions-blur | block | `npx hyperframes add transitions-blur` |
-| transitions-cover | block | `npx hyperframes add transitions-cover` |
-| transitions-destruction | block | `npx hyperframes add transitions-destruction` |
-| transitions-dissolve | block | `npx hyperframes add transitions-dissolve` |
-| transitions-distortion | block | `npx hyperframes add transitions-distortion` |
-| transitions-grid | block | `npx hyperframes add transitions-grid` |
-| transitions-light | block | `npx hyperframes add transitions-light` |
-| transitions-mechanical | block | `npx hyperframes add transitions-mechanical` |
-| transitions-push | block | `npx hyperframes add transitions-push` |
-| transitions-radial | block | `npx hyperframes add transitions-radial` |
-| transitions-scale | block | `npx hyperframes add transitions-scale` |
-| transitions-other | block | `npx hyperframes add transitions-other` |
-
-### 字幕组件（16个）
-详见 `references/caption-components.md`。
-
-| 组件名 | 类型 | 时长 | 安装命令 |
-|--------|------|------|----------|
-| caption-kinetic-slam | component | N/A | `npx hyperframes add caption-kinetic-slam` |
-| caption-matrix-decode | component | N/A | `npx hyperframes add caption-matrix-decode` |
-| caption-particle-burst | component | N/A | `npx hyperframes add caption-particle-burst` |
-| caption-pill-karaoke | component | N/A | `npx hyperframes add caption-pill-karaoke` |
-| caption-neon-glow | component | N/A | `npx hyperframes add caption-neon-glow` |
-| caption-glitch-rgb | component | N/A | `npx hyperframes add caption-glitch-rgb` |
-| caption-editorial-emphasis | component | N/A | `npx hyperframes add caption-editorial-emphasis` |
-| caption-parallax-layers | component | N/A | `npx hyperframes add caption-parallax-layers` |
-| caption-highlight | component | N/A | `npx hyperframes add caption-highlight` |
-| caption-gradient-fill | component | N/A | `npx hyperframes add caption-gradient-fill` |
-| caption-clip-wipe | component | N/A | `npx hyperframes add caption-clip-wipe` |
-| caption-texture | component | N/A | `npx hyperframes add caption-texture` |
-| caption-weight-shift | component | N/A | `npx hyperframes add caption-weight-shift` |
-| caption-emoji-pop | component | N/A | `npx hyperframes add caption-emoji-pop` |
-| caption-neon-accent | component | N/A | `npx hyperframes add caption-neon-accent` |
-| caption-blend-difference | component | N/A | `npx hyperframes add caption-blend-difference` |
-
-### 3D/VFX 组件
-
-| 组件名 | 类型 | 描述 | 安装命令 |
-|--------|------|------|----------|
-| vfx-iphone-device | block | GLTF 3D 模型：iPhone 15 Pro Max + MacBook Pro，可旋转展示 | `npx hyperframes add vfx-iphone-device` |
-| ios26-liquid-glass | block | 3D iPhone + iOS 26 液态玻璃风格界面 | `npx hyperframes add ios26-liquid-glass` |
-| macos-tahoe-liquid-glass | block | 3D MacBook + macOS 桌面液态玻璃风格 | `npx hyperframes add macos-tahoe-liquid-glass` |
-| vfx-shatter | block | 元素碎裂解体效果，适合对比/反差镜头 | `npx hyperframes add vfx-shatter` |
-| vfx-portal | block | 传送门视觉特效 | `npx hyperframes add vfx-portal` |
-| vfx-liquid-background | block | WebGL 流体模拟背景，适合氛围/情绪镜头 | `npx hyperframes add vfx-liquid-background` |
-| vfx-text-cursor | block | 色散阴影文字 + 光标辉光，打字机风格，适合 Hook 开场 | `npx hyperframes add vfx-text-cursor` |
-| vfx-magnetic | block | 磁吸动效，元素跟随鼠标/触摸点 | `npx hyperframes add vfx-magnetic` |
-| app-showcase | block | 3 个悬浮手机屏幕展示 App 界面 | `npx hyperframes add app-showcase` |
-
-### Liquid Glass 系列
-
-| 组件名 | 类型 | 描述 | 安装命令 |
-|--------|------|------|----------|
-| liquid-glass-notification | block | iOS 液态玻璃风格通知卡片 | `npx hyperframes add liquid-glass-notification` |
-| liquid-glass-context-menu | block | 液态玻璃风格右键菜单 | `npx hyperframes add liquid-glass-context-menu` |
-| liquid-glass-media-controls | block | 液态玻璃风格媒体控制面板，适合流程/步骤镜头 | `npx hyperframes add liquid-glass-media-controls` |
-| liquid-glass-widgets | block | 液态玻璃风格小组件集合，适合概念具象化 | `npx hyperframes add liquid-glass-widgets` |
-
-### 数据可视化
-
-| 组件名 | 类型 | 描述 | 安装命令 |
-|--------|------|------|----------|
-| data-chart | block | 带动画的柱状图 + 折线图，适合数据揭示和概念镜头 | `npx hyperframes add data-chart` |
-| flowchart | block | 决策树 + SVG 连线，适合流程/步骤展示 | `npx hyperframes add flowchart` |
-| world-map | block | 世界地图可视化 | `npx hyperframes add world-map` |
-| us-map | block | 美国地图（基础版） | `npx hyperframes add us-map` |
-| us-map-bubble | block | 美国地图气泡版 | `npx hyperframes add us-map-bubble` |
-| us-map-hex | block | 美国地图六边形热力版 | `npx hyperframes add us-map-hex` |
-| us-map-flow | block | 美国地图流向图 | `npx hyperframes add us-map-flow` |
-| spain-map | block | 西班牙地图可视化 | `npx hyperframes add spain-map` |
-
-### 社交媒体
-
-| 组件名 | 类型 | 描述 | 安装命令 |
-|--------|------|------|----------|
-| instagram-follow | block | Instagram 关注按钮动效 | `npx hyperframes add instagram-follow` |
-| tiktok-follow | block | TikTok 关注按钮动效 | `npx hyperframes add tiktok-follow` |
-| yt-lower-third | block | YouTube 风格下三分之一字幕条 | `npx hyperframes add yt-lower-third` |
-| x-post | block | X（Twitter）帖子卡片 | `npx hyperframes add x-post` |
-| reddit-post | block | Reddit 帖子卡片 | `npx hyperframes add reddit-post` |
-| spotify-card | block | Spotify 播放卡片 | `npx hyperframes add spotify-card` |
-| macos-notification | block | macOS 风格通知弹窗 | `npx hyperframes add macos-notification` |
-
-### 展示案例
-
-| 组件名 | 类型 | 描述 | 安装命令 |
-|--------|------|------|----------|
-| apple-money-count | block | Apple 风格金额跳动计数动画 | `npx hyperframes add apple-money-count` |
-| vpn-youtube-spot | block | VPN 主题 YouTube 广告位 | `npx hyperframes add vpn-youtube-spot` |
-| blue-sweater-intro-video | block | 蓝色毛衣产品介绍视频模板 | `npx hyperframes add blue-sweater-intro-video` |
-| nyc-paris-flight | block | 纽约→巴黎航班路线动画 | `npx hyperframes add nyc-paris-flight` |
-| north-korea-locked-down | block | 朝鲜封锁主题数据可视化 | `npx hyperframes add north-korea-locked-down` |
-| ui-3d-reveal | block | 3D UI 界面揭示动画 | `npx hyperframes add ui-3d-reveal` |
-
-### 氛围/装饰
-
-| 组件名 | 类型 | 描述 | 安装命令 |
-|--------|------|------|----------|
-| grain-overlay | component | CSS 关键帧驱动的胶片颗粒叠加层，配合 vignette 建立氛围 | `npx hyperframes add grain-overlay` |
-| shimmer-sweep | component | CSS 渐变遮罩光泽扫过效果 | `npx hyperframes add shimmer-sweep` |
-| vignette | component | 电影级径向暗角效果 | `npx hyperframes add vignette` |
-| grid-pixelate-wipe | component | 网格像素化擦除效果，也可作转场 | `npx hyperframes add grid-pixelate-wipe` |
-| texture-mask-text | component | 66 种 PBR 纹理遮罩文字（素材来自 ambientCG） | `npx hyperframes add texture-mask-text` |
-| parallax-zoom | component | 视差推进效果，适合段落间过渡/桥接 | `npx hyperframes add parallax-zoom` |
-| parallax-unzoom | component | 视差拉远效果，parallax-zoom 的反向变体 | `npx hyperframes add parallax-unzoom` |
-
-### 品牌/收尾
-
-| 组件名 | 类型 | 描述 | 安装命令 |
-|--------|------|------|----------|
-| logo-outro | block | 电影级 Logo 揭示 + 辉光绽放，适合 CTA 收尾 | `npx hyperframes add logo-outro` |
-
-## 安装说明
-
-所有组件统一通过 `npx hyperframes add <name>` 安装。
-
-- **block** 类型：安装后生成子合成（sub-composition），在 HTML 中通过 `data-composition-src` 属性引用
-- **component** 类型：安装后生成 CSS/JS 代码片段，引入到镜头对应的 HTML 元素中使用
-
-## 找不到匹配组件
-
-如果某个镜头在所有官方组件中都找不到匹配项，按以下优先级处理：
-
-1. **重新审视镜头设计**：是否可以用已有组件的组合来实现？例如 `grain-overlay` + `vignette` + 自定义文字可以构成多种氛围场景
-2. **使用 GSAP 手写**：参考 `references/gsap-patterns.md` 中的动画模式，用纯 HTML/CSS + GSAP 实现
-3. **极简处理**：如果镜头时长很短（<2s），纯文字 + 基础淡入淡出也是可接受的方案
-
-手写 CSS 是**最后手段**，优先始终是官方组件选型。

package/skills/video-script-builder/references/component-recipes.md

@@ -1,165 +0,0 @@
----
-name: 组件配方
-description: 叙事目的 → 组件组合配方表。每个场景类型 3 档能量配方 + 抽象概念组件化方法。用于防止 Agent 反复使用同一个组件（data-chart 连用 5 镜等）。第二步组件选型时必读。
----
-
-# 组件组合配方
-
-## 目录
-
-- [为什么需要配方](#为什么需要配方)
-- [场景类型与三档能量组合](#配方表场景类型--3-档能量组合)
-- [字幕组件切换模式](#字幕组件切换模式)
-- [转场搭配模式](#转场搭配模式)
-- [抽象概念到组件翻译](#抽象概念--组件翻译表)
-- [使用检查清单](#使用检查清单)
-
-## 为什么需要配方
-
-`component-catalog.md` 告诉你"有什么组件"，但不告诉你"怎么组合"。Agent 看到表格中"首选"列的第一个选项就停下来，导致全片 data-chart 连用 5 镜、light-leak 用 8 次、caption-pill-karaoke 全片不换。
-
-**本文件的规则**：为每个镜头选择组件时，先看本表。不要直接取 `component-catalog.md` 场景映射表的"首选"列。
-
----
-
-## 配方表：场景类型 → 3 档能量组合
-
-每个场景类型给出 3 档组合。全片中每档至少用 1 次，确保视觉多样性。
-
-### 数据展示
-
-| 档位 | 组件组合 | 适合情绪 | 时长建议 |
-|------|---------|---------|---------|
-| 🔋 低能量 | `liquid-glass-widgets` + 数字大字（CSS）| 冷静、介绍 | 4-6s |
-| ⚡ 中能量 | `data-chart` + `shimmer-sweep` | 正常、展示 | 5-8s |
-| 💥 高能量 | `vfx-shatter` 碎裂 → 碎片重组为数据 + `light-leak` | 紧张、揭示 | 4-7s |
-
-🔒 **data-chart 专用规则**：如果叙事需要进度条从 0% 填到 100%，不要用同一个 data-chart 连做 5 镜。拆成 3 段——低能量引入（widgets）、中能量爬坡（data-chart ×2 镜 max）、高能量冲刺+碎裂（shatter）。每段换一种视觉手段。
-
-### 概念/定义
-
-| 档位 | 组件组合 | 适合情绪 |
-|------|---------|---------|
-| 🔋 低能量 | `liquid-glass-widgets` + 标签文字 | 解释、建立认知 |
-| ⚡ 中能量 | `flowchart` + `vfx-text-cursor` | 结构化展示 |
-| 💥 高能量 | `texture-mask-text` (66 种 PBR 纹理) + `parallax-zoom` | 冲击力、印象 |
-
-🔒 **抽象概念具象化铁律**：不要用 CSS 手写矩形/card 表达核心概念（如"白纸=上下文窗口"）。优先查上表找合适的组件组合。`texture-mask-text` 有 66 种 PBR 纹理（纸纹/金属/布料等），极其适合将抽象概念编译为可感知的材质。
-
-### 产品/界面展示
-
-| 档位 | 组件组合 | 适合情绪 |
-|------|---------|---------|
-| 🔋 低能量 | `app-showcase` (3 设备悬浮) | 首次露面 |
-| ⚡ 中能量 | `vfx-iphone-device` + 旋转动画 | 功能演示 |
-| 💥 高能量 | `ios26-liquid-glass` + `ui-3d-reveal` | 品牌高潮 |
-
-### 流程/步骤
-
-| 档位 | 组件组合 | 适合情绪 |
-|------|---------|---------|
-| 🔋 低能量 | `liquid-glass-media-controls` + 数字 | 简洁指引 |
-| ⚡ 中能量 | `flowchart` (决策树+SVG连线) | 结构化解释 |
-| 💥 高能量 | `grid-pixelate-wipe` 擦除旧步骤 → 新步骤浮现 | 戏剧化过渡 |
-
-### 对比/反差
-
-| 档位 | 组件组合 | 适合情绪 |
-|------|---------|---------|
-| 🔋 低能量 | 左右分屏 + 2 组 `liquid-glass-widgets` | 理性对比 |
-| ⚡ 中能量 | `data-chart` 双组 + 颜色对立（绿 vs 红）| 数据对比 |
-| 💥 高能量 | `vfx-shatter` 左侧碎裂 → `vfx-portal` 右侧浮现 | 戏剧化反转 |
-
-### Hook 开场
-
-| 档位 | 组件组合 | 适合情绪 |
-|------|---------|---------|
-| 🔋 低能量 | `vfx-text-cursor` 打字机 + `vignette` | 悬疑、好奇 |
-| ⚡ 中能量 | `caption-kinetic-slam` + `shimmer-sweep` | 冲击、震惊 |
-| 💥 高能量 | `vfx-portal` + 核心关键词从传送门中推出 | 科幻、颠覆 |
-
-### CTA 收尾
-
-| 档位 | 组件组合 | 适合情绪 |
-|------|---------|---------|
-| 🔋 低能量 | `logo-outro` + 辉光 | 品牌、稳重 |
-| ⚡ 中能量 | `caption-kinetic-slam`（CTA 大字）+ `parallax-unzoom` 拉远 | 号召力 |
-| 💥 高能量 | `vfx-liquid-background` 流体脉冲 + `apple-money-count`（数字跳动） | 转化驱动 |
-
-### 氛围/情绪建立
-
-| 档位 | 组件组合 | 适合情绪 |
-|------|---------|---------|
-| 🔋 低能量 | `grain-overlay` + `vignette` + 纯色底 | 基础氛围 |
-| ⚡ 中能量 | `vfx-liquid-background` + `shimmer-sweep` | 流动、有机 |
-| 💥 高能量 | `vfx-liquid-background` + `chromatic-radial-split` 转场进入 | 不安、紧张 |
-
----
-
-## 字幕组件切换模式
-
-🔒 全片至少用 2 种 caption 组件。切换时机 = 叙事段落切换点（即情绪曲线拐点处）。
-
-### 情绪 → 字幕 对照表
-
-| 情绪拐点 | 切换到的 caption | 效果 |
-|---------|-----------------|------|
-| Hook/开场 | `caption-kinetic-slam` 或 `vfx-text-cursor`（大字+底部字幕组合） | 建立冲击力 |
-| 解释/建立认知 | `caption-pill-karaoke` 或 `caption-weight-shift` | 温和、易懂 |
-| 数据/事实 | `caption-highlight` 或 `caption-clip-wipe` | 信息感、干净 |
-| 紧张/危机 | `caption-glitch-rgb` 或 `caption-matrix-decode` | 不安、技术感 |
-| 转折/方案 | `caption-editorial-emphasis` 或 `caption-gradient-fill` | 权威、自信 |
-| 金句/高潮 | `caption-kinetic-slam` 或 `caption-particle-burst` | 最大冲击 |
-| CTA/收尾 | `caption-weight-shift` 或 `caption-neon-accent` | 精致、品牌 |
-
-### 反例
-
-❌ 全片 14 镜只用 `caption-pill-karaoke`——观众在第 5 镜就视觉疲劳了。pill-karaoke 适合"解释/建立认知"段，到了"紧张/危机"段（如百分比超过 50%）就应该切成 `caption-glitch-rgb`，到了金句段切 `caption-kinetic-slam`。
-
----
-
-## 转场搭配模式
-
-### 三段式转场策略
-
-| 段落 | 推荐转场 | 使用次数上限 |
-|------|---------|------------|
-| Hook → 主体 | `cinematic-zoom` 或 `glitch` | 1 次 |
-| 主体内段落递进 | `light-leak` 或 `transitions-dissolve` | ≤ 全片镜数 × 25% |
-| 情绪转折 | `glitch` 或 `chromatic-radial-split` | 1-2 次 |
-| 危机→方案 | `flash-through-white` 或 `ridged-burn` | 1-2 次 |
-| 方案→金句 | `cinematic-zoom` 或 `swirl-vortex` | 1 次 |
-| 金句→CTA | `light-leak` 或 `parallax-unzoom` | 1 次 |
-
-### 反例
-
-❌ `light-leak` 全片用 8 次——段落内递进、情绪转折、高潮收束全用同一种。Agent B 看到 14 镜 spec 中 8 个 `light-leak` 转场，不会觉得"这是精心设计的"，会觉得"Agent A 只认识这一种转场"。
-
----
-
-## 抽象概念 → 组件翻译表
-
-当逐字稿中出现抽象概念时，不要用 CSS 手写矩形模拟。查下表找组件化方案：
-
-| 抽象概念 | 组件化方案 | 示例 |
-|---------|-----------|------|
-| 白纸/纸张/书写 | `texture-mask-text` (PBR 纸纹理) + `grid-pixelate-wipe` (擦除) | "上下文窗口像一张白纸" |
-| 容量/进度/百分比 | `data-chart` + `liquid-glass-widgets` 分段 | "上下文用了 15%" |
-| 碎裂/崩溃/破坏 | `vfx-shatter` + `transitions-destruction` | "100% 直接罢工" |
-| 重组/方案/重建 | `liquid-glass-widgets` 依次浮现 + `light-leak` | "怎么管理？开新对话" |
-| 流动/变化/时间 | `vfx-liquid-background` 加速/减速 + `shimmer-sweep` | "随着对话越来越多" |
-| 对比/A vs B | `data-chart` 双色 + `vfx-shatter` 左侧碎裂 | "AI 变聪明 vs 变笨" |
-| 聚焦/揭示/真相 | `cinematic-zoom` + `caption-kinetic-slam` | "不是它变笨了" |
-| 记忆/遗忘 | `grid-pixelate-wipe` 擦除文字 → 空白 | "把纸腾出来" |
-
----
-
-## 使用检查清单
-
-对每个 Scene 选完组件后，快速过：
-
-- [ ] 这个组件在本片中已经连续用了 3 镜吗？→ 是：换高/低一档能量配方
-- [ ] 这个场景类型在配方表中有 3 档，我只用了同一档吗？→ 是：选不同能量档位
-- [ ] 核心视觉锚点（hook/金句/首尾呼应）用了 CSS fallback 吗？→ 是：回上表找组件化方案
-- [ ] 当前段落是情绪拐点吗？→ 是：查字幕切换表，换 caption 组件
-- [ ] 下个转场已经在本片中用了 >25% 镜数吗？→ 是：换能量匹配的另一种转场

package/skills/video-script-builder/references/gsap-patterns.md

@@ -1,112 +0,0 @@
----
-name: gsap-patterns
-description: GSAP 编排 Pattern 代码示例。v1.2：GSAP 是胶水，不是画笔。组件负责自身动画，GSAP 只负责跨组件编排。
----
-
-# GSAP 编排 Pattern
-
-## 目录
-
-- [核心理念](#核心理念)
-- [Pattern 速查](#pattern-速查)
-- [旧 Pattern 迁移指引](#旧-pattern-迁移指引)
-- [Easing 速查](#easing-速查)
-- [禁止事项](#禁止事项)
-
-## 核心理念
-
-**GSAP 是胶水，不是画笔。**
-
-v1.2 开始，动画不再手写。官方组件（通过 `data-composition-src` 引用）负责自身的入场/退场/循环动画。GSAP 的唯一职责：协调组件之间、素材之间、字幕之间的时序关系。
-
-- 组件自己动 → GSAP 只管什么时候让它出现/消失
-- 素材（图片/视频）→ GSAP 负责入场微动效（scale + autoAlpha）
-- 字幕 → GSAP 负责在正确的时间点切换文本
-
-## Pattern 速查
-
-```javascript
-// ═══════════════════════════════════════
-// Pattern 1: 组件入场编排
-// 组件自身有入场动画，GSAP 只控制显示时机
-// ═══════════════════════════════════════
-// HTML: <div data-composition-src="compositions/data-chart.html"
-//       data-start="12.0" data-duration="8.0">
-tl.set("#scene-03", { autoAlpha: 1 }, 12.0);
-
-// ═══════════════════════════════════════
-// Pattern 2: 素材交叉淡入淡出
-// 淡出旧素材，同时淡入新素材（overlap = crossfade）
-// ═══════════════════════════════════════
-tl.to("#scene-A-material", { autoAlpha: 0, duration: 0.4 }, 8.5);
-tl.from("#scene-B-material", { autoAlpha: 0, duration: 0.4 }, "<");
-
-// ═══════════════════════════════════════
-// Pattern 3: 字幕文本切换
-// 在旁白时间点切换字幕内容
-// ═══════════════════════════════════════
-tl.call(() => {
-  document.getElementById("caption-text").textContent = "新的字幕";
-}, [], 15.0);
-
-// ═══════════════════════════════════════
-// Pattern 4: Shader 转场触发
-// Shader 转场作为子 composition 引用，GSAP 只管显隐
-// ═══════════════════════════════════════
-tl.set("#transition-glitch", { autoAlpha: 1 }, 20.0);
-tl.set("#transition-glitch", { autoAlpha: 0 }, 24.0);
-
-// ═══════════════════════════════════════
-// Pattern 5: 素材/截屏入场
-// 图片或视频素材入场，微 scale 增加纵深感
-// ═══════════════════════════════════════
-tl.from("#scene-material", {
-  scale: 1.05,
-  autoAlpha: 0,
-  duration: 0.6,
-  ease: "power2.out"
-}, 5.0);
-
-// ═══════════════════════════════════════
-// Pattern 6: 组件退场编排
-// 组件自身有退场动画，GSAP 控制在何时触发隐藏
-// ═══════════════════════════════════════
-tl.set("#scene-03", { autoAlpha: 0 }, 20.0);
-```
-
-## 旧 Pattern 迁移指引
-
-v1.1 手写动画 pattern 已被官方组件取代：
-
-| v1.1 Pattern | v1.2 替代方案 |
-|-------------|-------------|
-| anim-slam | `caption-kinetic-slam`（全屏大字 slam）或 GSAP `back.out(1.7)` 手动实现 |
-| anim-cascade | `caption-clip-wipe`（逐词 clip-path 揭示）或 `caption-pill-karaoke`（逐词高亮） |
-| anim-breathe | 任何组件自带呼吸态；若需手写，按 Scene 时长计算有限 `repeat`，禁止无限循环 |
-| anim-flash | `caption-highlight`（TikTok 式高亮扫过）或 GSAP 颜色 flash |
-| anim-weight | `caption-weight-shift`（字重渐变过渡） |
-| anim-track | `caption-editorial-emphasis`（字距/大小对比）或 GSAP `letterSpacing` |
-| anim-scribe | `caption-gradient-fill`（下划线效果）或 GSAP `scaleX` 手写 |
-| 手写 crossfade | `light-leak` 或 `transitions-dissolve`（shader 转场，视觉效果远超 CSS） |
-| 手写 line-sweep | `whip-pan` 或 `transitions-push`（shader 转场替代扫换） |
-| 手写 卡片光晕 | `shimmer-sweep` + `vignette` 组合，或 `liquid-glass-widgets` |
-
-## Easing 速查
-
-| ease | 感觉 | 适用场景 |
-|------|------|---------|
-| `"power2.out"` | 减速停止 | 最常用，通用入场 |
-| `"power3.out"` | 更强减速 | 需要力度感的入场 |
-| `"power4.in"` | 加速启动 | 退场、消失 |
-| `"back.out(1.7)"` | 超出再回弹 | 弹入效果，强调元素 |
-| `"elastic.out(1,0.3)"` | 弹性晃动 | 趣味性入场，少用 |
-| `"sine.inOut"` | 平滑对称 | 呼吸态、循环动画 |
-
-## 禁止事项
-
-- ❌ 不用 `delay` 链式调用 — 用 timeline position parameter
-- ❌ 不用 `opacity` — 用 `autoAlpha`
-- ❌ 不动 `width/height/top/left` — 用 `x/y/scale`
-- ❌ 不创建 tweens 在 DOM 元素存在之前
-- ❌ 不手写组件内部动画 — 交给官方组件
-- ❌ 不用 GSAP 做复杂视觉特效 — 用 shader 转场组件

package/skills/video-script-builder/references/pacing-rules.md

@@ -1,78 +0,0 @@
----
-name: pacing-rules
-description: 三档节奏参数 + 平台对照表 + 素材时长规则 + 节奏校验清单。分镜第二步"节奏分配"时对照使用。
----
-
-# 节奏系统
-
-## 三档节奏
-
-| 节奏档 | 每镜时长 | 中文旁白密度 | 典型平台 |
-|--------|---------|-------------|---------|
-| Hook 型 | 1.5-2.5s | 1.5-2 字/秒 | 抖音, TikTok, Shorts |
-| 教程型 | 3-5s | 2-3 字/秒 | B站, YouTube |
-| 纪录型 | 5-8s | 1.5-2.5 字/秒 | 品牌片, 纪录片 |
-
-## 平台参数对照
-
-| 平台 | 比例 | width × height | 节奏 | 字幕策略 |
-|------|------|-------------------------|------|---------|
-| 抖音/TikTok | 9:16 | 1080x1920 | Hook 型 | 常驻字幕（70% 用户静音） |
-| B站知识区 | 16:9 | 1920x1080 | 教程型 | 常驻字幕 |
-| YouTube | 16:9 | 1920x1080 | 教程型/纪录型 | 常驻字幕（可选） |
-| 小红书 | 9:16 或 4:3 | 1080x1920 或 1440x1080 | Hook 型 | 强制常驻字幕 |
-
-## 逐字稿时长估算
-
-- 基准：中文 4 字/秒
-- 口播总字数 / 4 = 预估总时长（秒）
-- 加 10-15% buffer 给停顿/转场/纯视觉镜
-
-## 三段分配
-
-| 段 | 镜头数 | 时长占比 | 职责 |
-|----|--------|---------|------|
-| 开 (hook) | 1-3 镜 | 15-20% | 抓注意力，**必须含视觉锚点** |
-| 中 (核心) | 5-15 镜 | 60-70% | 信息传递 |
-| 收 (cta) | 1-2 镜 | 10-15% | 行动召唤/收束 |
-
-**Hook 镜头硬性要求**：开段至少有一个视觉锚点——素材（截图/视频）、官方组件、或动态背景。不允许纯文字 Hook 镜。
-
-## 素材镜头时长
-
-素材镜头（含截图、视频、组件展示）需要比纯文字镜更多的停留时间：
-
-| 镜头类型 | 建议时长 | 说明 |
-|---------|---------|------|
-| 素材/截图镜 | 3-6s | 观众需要时间看清内容 |
-| 组件展示镜 | 3-6s | 组件自身有动画，需完整播放 |
-| 纯文字镜 | 1.5-3s | 现在属于少数派，仅在信息密集段落使用 |
-
-纯文字镜是例外，不是规则。全片纯文字镜占比应 ≤ 20%。
-
-## 实现单元预加载
-
-部分 3D/VFX 或远程媒体需要预加载。处理方式按框架分开：
-
-- HyperFrames：渲染端可将组件 `data-start` 提前 1-2s，让加载与前一镜重叠。
-- Remotion：在 spec 标记需要 premount/预加载的媒体或组件，由渲染端按当前 API 实现；不要为加载插入无叙事职责的假镜头。
-
-不可以在组件加载过程中出现白屏或空白帧。
-
-## 节奏校验清单
-
-```yaml
-□ 第一镜 hook 落在 0-3s 内（教程型放宽至 5s）
-□ Hook 镜含视觉锚点（素材/组件/动态背景），非纯文字
-□ 节奏曲线不是全片均速（有快慢对比）
-□ 素材/组件镜头时长 ≥ 3s，纯文字镜 ≤ 3s（且 ≤ 20% 总数）
-□ 反白闪屏 ≤ 2 次，间隔 ≥ 8s
-□ glitch 转场 ≤ 2 次全片
-□ bridge 占比 ≤ 15% 总镜头数
-□ 每镜都有信息载荷（不存在空帧）
-□ 旁白字数与时长匹配（按 3-4 字/秒估算）
-□ 节奏类型与平台匹配
-□ HF: 最后镜 data-start + data-duration = 目标时长 ± 0.5s
-□ Remotion: 总帧数 = Σ Scene 帧 - Σ Transition 帧；Overlay 不扣帧
-□ 需要预加载的实现单元已标注，无空白帧
-```

package/skills/video-script-builder/references/quality-checklist.md

@@ -1,98 +0,0 @@
----
-name: quality-checklist
-description: 输出 HyperFrames 或 Remotion 分镜 spec 前的 12 条硬性自检清单。任何一条未通过，不交付。
----
-
-# 双后端质量自检清单
-
-先锁定 `renderer`，再检查共同门禁和对应框架门禁。一次只检查并交付一种 spec。
-
-## 1. 框架绑定
-
-- [ ] `hyperframes` 只输出 `video-spec-hf.md`；`remotion` 只输出 `video-spec-remotion.md`。
-- [ ] 开篇明确声明目标框架、时间模型与下游交接对象。
-- [ ] spec 没有混写两套实现：HF Scene 不出现 `useCurrentFrame()`；Remotion Scene 不出现 GSAP timeline 或 `data-start`。
-- [ ] 迁移任务生成目标框架新 spec，不做字符串替换式“伪迁移”。
-
-## 2. 单一交付
-
-- [ ] 本次只交付一个 `.md` spec。
-- [ ] 未创建 `index.html`、`Root.tsx`、composition、脚手架、配置、素材下载或 MP4。
-- [ ] spec 不包含可直接复制成完整项目的 HTML/TSX。
-
-## 3. 结构完整
-
-- [ ] 意图卡 5 字段齐全：视觉人格、情绪-视觉映射、视觉母题、参考拆解、反调预警。
-- [ ] §1–10 全部存在；未知内容写 `[待用户确认]`、`[待获取]`、`[待转录]` 或 `[需渲染端实现/复核]`，不留空。
-- [ ] 核心信息 ≤12 字；同质化反例至少覆盖视觉、叙事、节奏。
-- [ ] 品味自检说明全片最空镜、最满镜与金句前的“吸气点”。
-
-## 4. 时间闭合
-
-- [ ] Scene 起点、时长均非负，按顺序覆盖全片，不存在无意的空洞。
-- [ ] 结尾与目标总时长一致（允许人类参考秒数 ±0.5s）。
-- [ ] 旁白字数与 Scene 时长匹配；停顿有明确用途。
-- [ ] HF：最后镜 `data-start + data-duration = 总时长`。
-- [ ] Remotion：`startFrame`、`durationInFrames`、转场均为整数帧；普通 Sequence 才将 startFrame 映射为 `from`，TransitionSeries 的 startFrame 只作派生审计坐标；`总帧数 = Σ sceneFrames - Σ transitionFrames`，Overlay 不扣时长。
-
-## 5. 镜头覆盖
-
-- [ ] 每镜至少绑定一个真实素材、HF 官方组件，或 Remotion 组件契约。
-- [ ] 所有“已有/本地”素材路径真实；待获取项写清来源、关键词、用途、许可/验收和 fallback。
-- [ ] 纯文字镜 ≤20%；素材/视觉主导镜 ≥80%。
-- [ ] 不存在把占位图、虚构组件或未核实包名说成可用实现的情况。
-
-## 6. 开镜锚点
-
-- [ ] Hook 落在前 3 秒（教程型最多放宽到 5 秒）。
-- [ ] Hook 有占主体面积的组件/素材/可实现组件契约，不是纯文字或只有底板。
-- [ ] 金句与首尾呼应也有真实视觉方案和 fallback。
-
-## 7. 字幕去重
-
-- [ ] 屏显文字只有 1–4 个关键词，不逐字重复字幕/旁白。
-- [ ] 全片至少两种字幕表现，切换理由与段落情绪一致。
-- [ ] 无真实词级时间戳时标 `[待转录]`，未按字数伪造精确时间。
-- [ ] 字幕安全区、行宽、字号与画幅适配。
-
-## 8. 动画确定性
-
-- [ ] 所有动画输入区间落在 Scene 局部时间内。
-- [ ] HF：只用绝对 position、transform + `autoAlpha`；无链式 delay、布局属性 tween、`opacity` 或 `repeat:-1`。
-- [ ] HF：GSAP 只编排跨组件显隐/切换，不重写组件内部动画。
-- [ ] Remotion：只用 `useCurrentFrame()` + `interpolate()` / `spring()` 等帧驱动值；无 CSS transition、`setTimeout`、wall-clock 或未设 seed 的随机数。
-- [ ] Remotion：每个 `interpolate()` 说明 clamp；spring 写清 fps、局部 frame、config 或时长边界。
-
-## 9. 多样性与真实能力
-
-- [ ] 同一主组件/构图连续不超过 3 镜；连续两镜不靠同一理由选型。
-- [ ] 全片至少两种转场；任一强转场 ≤镜数 30%，闪白与 glitch 各 ≤2 次。
-- [ ] 转场不是每镜强制添加；普通 cut 有明确位置。
-- [ ] HF：组件名在 catalog/官方 registry 中可核对，无法核对就标 `[需渲染端复核]`；L1 3D/VFX 至少两种（底板不计）。
-- [ ] HF：每个依赖逐项写完整 `npx hyperframes add <真实组件名>`；交付文件中不存在 `<name>`、`<组件名>` 等模板占位。
-- [ ] Remotion：自定义组件写清 props、素材、动画与验收；3D/WebGL/额外库标 `[需渲染端选库/复核许可]`。
-
-## 10. 意图一致
-
-- [ ] 每镜的“为什么”≤20 字，并对应意图卡中的具体一条。
-- [ ] 视觉母题在 hook、主体、收尾至少各出现一次，且形态有变化。
-- [ ] 删除母题后叙事会损失含义，而不是装饰性贴图。
-- [ ] 参考拆解写的是可执行特征，不是只报品牌/作者名。
-
-## 11. 节奏与密度
-
-- [ ] 最空镜与最满镜密度差 ≥2 档；密镜 ≤总镜数 25%。
-- [ ] 连续两镜不完全同密度；连续三镜不完全同冷暖。
-- [ ] 相邻镜时长有变化；素材镜有足够阅读时间。
-- [ ] 至少有一段 ≥2 秒的“空/疏”呼吸区；高潮前有蓄力。
-- [ ] 音效只强调关键动作，不盖过旁白；BGM、旁白、音效起止与音量齐全。
-
-## 12. 可交接
-
-- [ ] 每镜的路径、依赖、fallback、开放问题无歧义。
-- [ ] HF：安装命令与 GSAP 胶水可由 HyperFrames 渲染 Agent 复核执行。
-- [ ] Remotion：Composition 参数、Sequence 帧区间、组件契约、素材绑定、转场 overlap 与音频帧区间齐全。
-- [ ] §10 留给对应渲染 Agent 回填：直接可执行项、修改项、理解偏差和框架版本。
-- [ ] 收尾只报告 spec 统计与下一步交接，然后停止。
-
-任何一项失败都先修正，不把问题推给渲染端。