Communitygithub.com

trident-archive

为技术项目(GitHub 仓库、API、技术产品)生成2分钟产品演示视频。并行构建多个选项,并执行结构化评论审查。适用于演示代码、解释架构或制作讲解视频。

trident-archive 是什么?

trident-archive 是一个 AI Agent 技能(Skill),专为快速生成技术产品的专业演示视频而设计。它能自动将 GitHub 仓库、API 或任何技术产品转化为一段约2分钟的高质量解说视频。该技能的核心优势在于其并行处理能力:它会同时创建两个不同风格的视频版本(例如一个使用 Remotion 的动画版本和一个使用幻灯片+FFmpeg 的简洁版本),然后自动或提示用户选择最优方案。生成视频后,技能会启动两个并行的“评论家”(商业评论家和技术评论家)对每个视频版本进行结构化评分和质量审查。只有同时通过两位评论家严格审查(评分达7.5分以上且无重大问题)的视频才会被最终交付,否则会进入迭代修复循环。整个过程遵循一个7阶段的端到端工作流(发现→脚本→并行构建→并行评论→迭代→终审→交付),运行在支持并行子任务(如 sessions_spawn)的 AI 代理平台上,如 Claude Code、Cursor 或 Codex。它集成了 ElevenLabs 进行语音合成,并依赖 Remotion 或 Puppeteer/FFmpeg 进行视频渲染。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mfrancime/trident-archive/tree/HEAD/repos/trident_cc-crossbeam_hackathon_project/.claude/skills/product-demo-video

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

产品演示视频

为技术项目生成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: `以商业评论家“迈克”的身份审查演示视频。
  
  视频:[路径]
  脚本:[内容]
  
  完整角色和评分标准请参阅 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画外音生成是
RemotionReact 视频框架(选项 A)二选一
ffmpeg视频处理(选项 B)二选一
Puppeteer幻灯片截图(选项 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 幻灯片转视频合成器

相关技能