用途:编排完整教程生成流水线,从 VHS 磁带文件和 Playwright 浏览器规格生成或更新面向用户的教程,产出 GIF 录制与双版本 Markdown。不适合内部文档或无用户教程的项目,API 参考文档应改用 scribe:doc-generator。
主要能力:发现项目中的 tape 文件、manifest 与浏览器规格;校验 tape 语法与 CLI 标志、检查演示数据;检查并重建过期的二进制;用 VHS 录制终端会话、用 Playwright 录制浏览器会话;生成优化 GIF 并组合多组件媒体;为 docs/ 与 book/ 生成 dual-tone Markdown 并更新 README 演示区与 SUMMARY.md。
使用方式:命令包括 /update-tutorial quickstart(按名单个)、/update-tutorial sync mcp(多个)、/update-tutorial --all、--list、--scaffold,另有 --validate-only、--skip-validation、--skip-rebuild、--force-rebuild 等标志。流程分四阶段:discovery、validation、rebuild、recording、generation、integration,并用对应前缀的 TodoWrite 项跟踪进度。磁带标注 @step、@docs-brief、@book-detail 决定文档内容。
限制:需安装 VHS(go install github.com/charmbracelet/vhs@latest)与 Playwright(npm install -D @playwright/test && npx playwright install chromium);校验失败或重建失败须立即停止,不得进入录制;浏览器规格若依赖服务器须先启动。GIF 过大可调整 fps/scale。