demo-producer

Demo Producer

适用于任意内容类型的通用演示视频制作工具。

工具版本（2026-Q2）： VHS >= 0.11，Remotion >= 4.0.448。VHS 0.11 新增：

• Wait 关键字 — 取代 Sleep N，使用基于条件的等待（Wait "prompt>" 会阻塞，直到出现指定字符串）。对于出现时间不固定的提示符，均应使用 Wait，而非 Sleep。
• ScrollUp N / ScrollDown N — 在录制会话中执行明确的滚动步骤；适用于演示 TUI 应用和较长的 less 式输出。

仅在需要固定视觉节奏且没有可用事件时，才保留现有的 Sleep N。

快速开始

demo-producer                    # Interactive mode - asks what to create
demo-producer skill explore      # Create demo for a skill
demo-producer plugin ork     # Create demo for a plugin
demo-producer tutorial "Building a REST API"  # Custom tutorial
demo-producer --live 4           # Live preview via dev --live (4-hour public funnel)

--live 模式（M127 #1565）

--live N 是 dev --live N 的轻量封装：它通过 portless --funnel 启动开发栈 （通过 Tailscale Funnel 公开访问），将有效期 N 小时的记录写入 .claude/state/live-demos.jsonl，并输出公共 URL 和 <iframe> 代码片段，可嵌入客户邮件或文档页面。

demo-producer --live 4

# Internally runs:
dev --live 4
# → public URL: https://app.your-tailnet.ts.net
#   iframe: <iframe src="..." />
#   expires: 2026-05-03T20:00Z

doctor 会警告超过 24 小时的实时演示，以免它们不断累积。 使用 dev stop 拆除。必须安装 Tailscale CLI（仅 --live 模式需要， 静态演示录制模式不需要）。

重要：任务管理为强制要求（CC 2.1.16）

在进行任何其他操作之前，先创建任务以跟踪进度：

# 1. Create main task IMMEDIATELY
TaskCreate(
  subject="Demo Producer: {topic}",
  description="Creating polished demo video for content showcase",
  activeForm="Producing demo for {topic}"
)

# 2. Create subtasks for each production phase
TaskCreate(subject="Content analysis", activeForm="Analyzing content for demo")
TaskCreate(subject="Script & storyboard", activeForm="Generating script and storyboard")
TaskCreate(subject="Record & compose", activeForm="Recording terminal and composing video")
TaskCreate(subject="Final output", activeForm="Rendering final video outputs")

# 3. Set dependencies for sequential phases
TaskUpdate(taskId="3", addBlockedBy=["2"])
TaskUpdate(taskId="4", addBlockedBy=["3"])
TaskUpdate(taskId="5", addBlockedBy=["4"])

# 4. Update status as you progress
TaskUpdate(taskId="2", status="in_progress")  # When starting
TaskUpdate(taskId="2", status="completed")    # When done

支持的内容类型

类型	来源	示例
skill	skills/{name}/SKILL.md	demo-producer skill commit
agent	agents/{name}.md	demo-producer agent debug-investigator
plugin	plugins/{name}/plugin.json	demo-producer plugin ork
marketplace	Marketplace 安装流程	demo-producer marketplace ork
tutorial	自定义描述	demo-producer tutorial "Git workflow"
cli	任意 CLI 工具	demo-producer cli "npm create vite"
code	代码讲解	demo-producer code src/api/auth.ts

交互流程

不带参数调用时，会提出 4 个问题：

问题 1：内容类型

What type of demo do you want to create?

○ Skill - OrchestKit skill showcase
○ Agent - AI agent demonstration
○ Plugin - Plugin installation/features
○ Tutorial - Custom coding tutorial
○ CLI Tool - Command-line tool demo
○ Code Walkthrough - Explain existing code

问题 2：格式

What format(s) do you need?

☑ Horizontal (16:9) - YouTube, Twitter
☑ Vertical (9:16) - TikTok, Reels, Shorts
☐ Square (1:1) - Instagram, LinkedIn

问题 3：风格

What style fits your content?

○ Quick Demo (6-10s) - Fast showcase, single feature
○ Standard Demo (15-25s) - Full workflow, multiple steps
○ Tutorial (30-60s) - Detailed explanation, code examples
○ Cinematic (60s+) - Story-driven, high polish
○ Scrapbook (15-35s) - Warm paper, fast cuts, social proof collage (Anthropic style)

问题 4：音频

Audio preferences?

○ Music Only - Subtle ambient background
○ Music + SFX - Background + success sounds
○ Silent - No audio

流水线架构

查看详细信息：使用 Read("references/demo-pipeline.md") 查看完整的流水线图、生成命令和输出结构。

内容检测器 -> 内容分析器 -> 脚本生成器 -> 终端脚本 -> VHS 录制器 -> Remotion 合成器 -> 最终输出（横屏/竖屏/方形）。

完成标准与时限

完成标准。 完成意味着：所有请求的格式变体均已渲染、写入输出目录，并通过 ffprobe 验证（时长非零、分辨率符合各变体的预期），且已发送完成通知 PushNotification。

预算：每个视频最多重试渲染 2 次，最多制作 3 种格式变体，每种变体的墙钟时间上限为 45 分钟（总计 135 分钟）；达到完成标准或首先触及任一上限时即停止，并指出尚未渲染的变体。

模板系统

四种适用于不同演示风格的模板架构。使用 Read("references/template-system.md") 查看详细配置和 SkillDemoConfig 接口。

模板	用途	时长	主要特点
TriTerminalRace	复杂度比较	15-20s	三面板分屏，难度以颜色区分
ProgressiveZoom	教程、演示讲解	20-30s	缩放转场，分层揭示
SplitThenMerge	前后对比、转换	15-25s	分屏 -> 合并为整体
ScrapbookDemo	产品发布、社会认同	15-35s	温暖的纸张质感，快速剪辑

内容类型模板（skill、agent、plugin、tutorial、cli、code）映射于 Read("references/skill-category-mapping.md")。

Remotion 合成

查看详细信息：使用 Read("references/remotion-composition.md") 查看文件夹结构、添加新合成以及格式变体前缀。

合成内容按格式（Landscape、Vertical、Square）和 skill 类别整理在 Production/ 下。

自定义选项

视觉主题

• 深色模式（默认）：深色背景，霓虹点缀
• 浅色模式：纯净的白色，细腻的阴影
• 终端：纯粹的终端美学
• 电影感：高对比度，戏剧性光效
• 剪贴簿：温暖的纸张（#F0F0E8）、衬线字体、快速剪辑、多媒体拼贴

音频预设

• 氛围：轻柔的背景音，无音效
• 科技：电子节拍、UI 音效
• 商务：专业、简洁
• 活力：轻快、节奏明快

完成时推送通知（CC 2.1.110+）

VHS 录制和 Remotion 渲染通常每个视频需要 10–45 分钟，完整的多版本制作（横屏 + 竖屏 + 方形）可能超过 1 小时。写入并验证所有输出文件后，调用 PushNotification，让用户知道视频已准备好供其审核。

PushNotification(
  message=f"ork:demo-producer complete — {topic}: {variants_count} variants · {output_dir}",
  status="proactive"
)

完整规则：Read("${CLAUDE_PLUGIN_ROOT}/skills/chain-patterns/rules/push-notification-on-completion.md")。

最佳实践

1. 聚焦主题 - 每个视频只讲解一个功能或概念
2. 展示而非讲述 - 演示实际用法
3. 使用真实数据 - 展示实际命令输出
4. 提供背景信息 - 演示前简要介绍设置
5. 以 CTA 结尾 - 始终包含安装命令

终端模拟模式

加载详情：读取 Read("references/terminal-simulation.md")，了解 TypeScript 模式：固定标题 + 滚动内容、Agent 调色板以及任务加载动画。

避免低质内容

加载详情：读取 Read("rules/slop-avoidance.md")，了解文本密度规则、时长压缩、常见低质内容模式和钩子风格。

核心规则：如果内容不值得占用屏幕时间，就删掉。

规则速查

规则	影响	涵盖内容
analyzer-patterns（加载 rules/analyzer-patterns.md）	中	Frontmatter 解析、阶段检测、示例提取
production-pipeline（加载 rules/production-pipeline.md）	高	前期制作、分镜、录制、VHS、manim
production-composition（加载 rules/production-composition.md）	高	Remotion 合成、音频混合、缩略图、字幕
slop-avoidance（加载 rules/slop-avoidance.md）	高	文本密度、时长压缩、钩子风格

相关技能

• video-production：完整的视频制作工作流（录制、合成、音频、节奏）

参考资料

按需使用 Read("references/<file>") 加载：

文件	内容
template-system.md	模板架构和 SkillDemoConfig 接口
content-types.md	内容类型详细规范
format-selection.md	平台要求和多格式支持
script-generation.md	脚本模板和生成模式
demo-pipeline.md	工作流架构、生成命令、输出结构
remotion-composition.md	Remotion 文件夹结构和合成指南
skill-category-mapping.md	技能类别映射和内容类型模板