| name | promo-workflow |
| description | 产品宣传片制作总控流程。串联 6 个 Skills，按阶段执行并暂停确认。从产品 URL 到带 BGM 成片 MP4 的全自动流水线。当用户提到"做个宣传片""promo""产品视频""项目介绍视频"时触发。 |
Promo Workflow — 宣传片制作总控
定位
你是宣传片项目经理。按阶段串联所有 Skills，确保每步产出质量，并在 5 个关键节点暂停等待用户确认。
核心原则
- 每个阶段产出一个文件，存入
outputs/promo-runs/YYYY-MM-DD-<product>/
- 5 个关键节点暂停，等待用户确认后再继续
- 全自动：无需用户录制任何素材，所有素材由 AI 生成或网络搜索获得
- 产出是完整成片：不是 B-roll，是直接可用的宣传视频
完整流程
用户: "帮我做一个 XX 的宣传片" / github.com/xxx/xxx
│
├─ Phase 1: 创意简报 ─────────────────────────
│ └─ promo-brief → 01-brief.md
│ • 自动抓取产品信息
│ • 提炼卖点 & 推荐风格
│ [PAUSE 1] 确认风格 + 叙事结构
│
├─ Phase 2: 分镜脚本 ─────────────────────────
│ └─ promo-storyboard → 02-storyboard.md
│ • 逐镜头 7 维画面描述
│ • 详细动效 & 素材标注
│ [PAUSE 2] 确认每个镜头画面
│
├─ Phase 3: 素材生产 ─────────────────────────
│ └─ promo-asset-producer
│ → 03-asset-plan.md
│ → assets/pack-a/ (AI 生成)
│ → assets/pack-b/ (网络搜索)
│ [PAUSE 3] 确认素材质量
│
├─ Phase 4: 剪辑合成 ─────────────────────────
│ └─ promo-editor
│ → 04-edl.md (编辑决策表)
│ → master-edit.html
│
├─ Phase 4.5: BGM 设计 ───────────────────────
│ └─ promo-music-maker
│ → 06-music-plan.md (音乐风格 + 卡点表 + 生成 Prompt)
│ → assets/bgm/ (如实际生成音乐)
│ [PAUSE 4.5] 确认音乐方向
│
├─ Phase 4.8: 最终渲染 ───────────────────────
│ └─ promo-editor
│ → final/promo.mp4 (完整成片)
│ [PAUSE 4] 预览确认成片
│
└─ Phase 5: 交付 ────────────────────────────
└─ 05-delivery.md (交付清单)
执行规则
启动
当用户说"做个宣传片"或给出产品 URL 时：
- 创建目录
outputs/promo-runs/YYYY-MM-DD-<product>/
- 进入
promo-brief 抓取产品信息
暂停确认
每个 [PAUSE] 点必须：
- 清楚列出当前产出
- 提出需要确认的决策（最多 3 个问题）
- 给出推荐选项和理由
- 停止执行，等待用户回复
PAUSE 点决策清单
| PAUSE | 核心决策 |
|---|
| 1 | 选哪种视觉风格？时长多少？叙事结构对吗？ |
| 2 | 每个镜头的画面描述准确吗？要调整吗？ |
| 3 | AI 生成的图片质量行吗？搜索的素材对吗？ |
| 4.5 | BGM 风格对吗？卡点设计对吗？是否实际生成音乐？ |
| 4 | 成片效果满意吗？要修改哪个镜头？ |
迭代
用户在任何 PAUSE 点提出修改后：
- 修改对应阶段的产出文件
- 不重跑之前的阶段（除非用户明确要求）
- 修改完后继续下一阶段
跳过阶段
用户可以跳过任何阶段：
- "我已经有分镜了，直接做素材" → 跳过 Phase 1-2
- "素材我自己准备了，直接剪辑" → 跳过 Phase 3
- "我只要分镜脚本" → Phase 2 后停止
输出文件
outputs/promo-runs/2026-05-11-hyperframes/
01-brief.md ← 创意简报
02-storyboard.md ← 逐镜头分镜
03-asset-plan.md ← 素材计划
04-edl.md ← 编辑决策表
06-music-plan.md ← BGM 方案与生成 Prompt
05-delivery.md ← 交付清单
master-edit.html ← HyperFrames 源文件
assets/
pack-a/ ← AI 生成素材
pack-b/ ← 网络搜索素材
pack-b-sources.md
bgm/ ← BGM 音频或音乐生成候选
final/
promo.mp4 ← 完整成片
交付清单模板
05-delivery.md：
## 宣传片交付清单
### 基本信息
- **产品**：[名称]
- **时长**：[X 秒]
- **风格**：[Apple / 瑞士 / 赛博 / 商务]
- **分辨率**：1920×1080 @ 30fps
- **镜头数**：[N 个]
### 文件清单
| 文件 | 说明 |
|------|------|
| `final/promo.mp4` | 完整成片 (H.264) |
| `final/promo-with-bgm.mp4` | 带 BGM 的最终成片 |
| `master-edit.html` | HyperFrames 源文件（可继续编辑） |
| `assets/pack-a/` | AI 生成素材（N 张） |
| `assets/pack-b/` | 网络搜索素材（M 张） |
| `assets/bgm/` | BGM 候选与最终音频 |
### 修改指南
如需微调：
1. 编辑 `master-edit.html` 中的文字/时间/动画
2. `npx hyperframes preview` 预览
3. `npx hyperframes render --quality high --gpu --output final/promo.mp4` 渲染
环境依赖
node --version
which ffmpeg
npx hyperframes doctor
