repo-demo-recorder

解决什么问题 · Problem

手工录屏是一次性劳动:产品改个版就得从头再录,没有质检,开头常常是登录页、loading 和路由跳转,客户看不下去。

这件 skill 把录制固化成脚本 + scenario 配置,并强制「能力优先」的客户叙事——开场 5–10 秒先给稳定的产品画面和一句话定位,先讲核心工作流,登录部署配置放后段;数据来源必须显式声明(mock / staging / production 三档,生产数据默认不录)。iOS、Android、桌面原生等浏览器驱动不了的应用,用外部录屏接入同一条 TTS / 合并 / 封面 / 校验后期管线。

怎么用 · How to use

在目标项目根目录(SKILL.md 中的真实命令,<skill> 指本 skill 安装路径):

# 1. 建隔离录制 worktree,避免污染主工作树
node <skill>/scripts/prepare-recording-worktree.mjs --root . --name <flow>

# 2. scaffold 场景与 runner(必须显式指定数据来源)
node <skill>/scripts/scaffold-repo-demo.mjs \
  --root . --name <flow> --data-mode mock --language zh-CN \
  --subtitles open --audience qa-proof --polish formal-delivery --flows core

生成 docs/recordings/<flow>.scenario.json 与 scripts/recordings/<flow>.mjs 后,按真实业务补齐路由、选择器、字幕、旁白与断言再录制——scaffold 的占位流程不是最终交付。

适用场景 · When to use

• 客户可发版的产品演示视频(含中文/英文字幕与旁白)
• 把 UI QA 走查变成可复现的视频证据
• 移动端竖屏 demo(--surface mobile)
• 外部原生 App(iOS / Android / macOS / CLI)录屏的后期加工与质检