mikeOnBreeze/cc-crossbeam

产品演示视频

为技术项目生成2分钟产品演示视频，支持并行构建选项和结构化评论审查。

何时使用

• 演示GitHub代码库、API或技术产品
• 需要快速制作专业的解说视频
• 希望获得多种制作方案（动画版 vs 简易版）

工作流（7个阶段）

发现 → 脚本 → 并行构建 → 并行评论 → 迭代 → 终审 → 交付
   │       │         │            │           │       │      │
 5-10分钟  10-15分钟  30-60分钟    10-15分钟   0-3轮   门控   发货

---

阶段1：发现

克隆并分析代码库：

gh repo clone <owner/repo> /tmp/<repo>

提取内容：

• 项目功能（一句话）
• 目标用户
• 3-5个关键特性
• 架构/流程
• 视觉素材（Logo、示意图）

询问（或使用默认值）：

问题	默认值
时长	2分钟
受众	混合（技术+业务）
语气	专业-对话式
格式	动画解说

---

阶段2：脚本

使用 references/script-template.md 的结构：

场景1：钩子（0:00-0:15）— 问题陈述
场景2：背景（0:15-0:30）— 为什么这很重要
场景3-5：特性（0:30-1:30）— 3个关键能力，每个20秒
场景6：技术（1:30-1:50）— 架构/可信度
场景7：行动号召（1:50-2:00）— 接下来做什么

指导原则：

• 150词/分钟
• 每句最多20词
• 主动语态
• 具体而非模糊

---

阶段3：并行构建

同时生成2个子代理以构建两个选项：

// 选项A：Remotion（动画）
sessions_spawn({
  label: "demo-video-option-a",
  task: `使用Remotion构建动画演示视频。
  
  脚本：[粘贴脚本]
  旁白：使用ElevenLabs，语音ID CcEB0ARKH8qIyzh2I1OR
  输出：/tmp/demo-video/option-a.mp4
  
  方法：
  1. 按场景生成旁白（ElevenLabs API）
  2. 创建包含场景组件的Remotion项目
  3. 同步动画与音频时间
  4. 以1080p 30fps渲染`
})

// 选项B：幻灯片 + ffmpeg（简易）
sessions_spawn({
  label: "demo-video-option-b", 
  task: `构建基于幻灯片的演示视频。
  
  脚本：[粘贴脚本]
  旁白：使用ElevenLabs，语音ID CcEB0ARKH8qIyzh2I1OR
  输出：/tmp/demo-video/option-b.mp4
  
  方法：
  1. 生成旁白（ElevenLabs API）
  2. 使用Puppeteer创建幻灯片（HTML → PNG）
  3. 使用ffmpeg合并，同步音频
  4. 添加简单过渡效果`
})

等待两者完成。 向用户展示选项，或根据质量自动选择。

---

阶段4：并行评论

生成2个评论者角色（详见 references/ 中的完整评分标准）：

// 商业评论者
sessions_spawn({
  label: "critic-business",
  task: `以商业评论者“Mike”的身份审阅演示视频。
  
  视频：[路径]
  脚本：[内容]
  
  详见 references/critic-business.md 了解完整角色和评分标准。
  
  评分：清晰度、专业性、商业价值（每项1-10分）
  输出：结构化审阅，包含总评分和具体修改建议。`
})

// 技术评论者  
sessions_spawn({
  label: "critic-technical",
  task: `以技术评论者“资深工程师”的身份审阅演示视频。
  
  视频：[路径]
  脚本：[内容]
  
  详见 references/critic-technical.md 了解完整角色和评分标准。
  
  评分：技术准确性、可信度、完整性（每项1-10分）
  输出：结构化审阅，包含总评分和具体修改建议。`
})

---

阶段5：迭代

质量门控：

门控	操作
双评论者评分均≥7.5，且无严重问题	→ 发货
任一评论者评分<7.0 或存在严重问题	→ 迭代
经过3轮迭代仍然失败	→ 升级给人工处理

迭代循环：

1. 收集所有严重/重要问题
2. 按严重程度顺序修复
3. 仅重新渲染受影响的场景（如果可能）
4. 重新运行评论者

---

阶段6：终审

在发货前，验证：

• 双评论者均已通过（7.5+）
• 无严重问题残留
• 音频同步正确
• 所有场景渲染完好
• 行动号召清晰

---

阶段7：交付

输出：

✅ 演示视频完成！

📹 视频：demo-video-final.mp4（2:03）
🎯 受众：[目标受众]
📊 评分：商业 8.2/10 | 技术 7.8/10

涵盖内容：
1. [关键点1]
2. [关键点2]  
3. [关键点3]

文件保存至：[位置]

交付至：

• Slack频道（如果指定）
• 保存到 workspace/outputs/

---

工具与依赖

工具	用途	是否必需
ElevenLabs	旁白生成	是
Remotion	React视频框架（选项A）	A/B中选一
ffmpeg	视频处理（选项B）	A/B中选一
Puppeteer	幻灯片截图（选项B）	A/B中选一
sessions_spawn	并行子代理	是

默认语音： CcEB0ARKH8qIyzh2I1OR（Jeremy - 技术教程旁白）

---

文件参考

• references/critic-business.md — 商业评论者角色与评分标准
• references/critic-technical.md — 技术评论者角色与评分标准
• references/script-template.md — 逐场景脚本结构
• templates/remotion/ — Remotion项目脚手架及组件
• scripts/generate-voiceover.py — ElevenLabs TTS辅助脚本
• scripts/render-slides.sh — ffmpeg幻灯片转视频合成器