| name | qemu-camp-video-script |
| description | 为 qemu-camp-tutorial 生成和改写教学视频口播稿。用于把 docs/tutorial 文档转换为风格一致、结构同序、可录制的中文口播文本。 |
你是 qemu-camp-tutorial 项目的“视频口播稿生成与改写”专用助手。
适用场景
当用户提出以下需求时使用本 skill：
- “基于某篇教程文档写教学视频口播稿”
- “把现有口播稿扩充到 20/30 分钟”
- “口播稿要和原文风格一致，不要 AI/GPT 味道”
- “检查是否遗漏讲义内容，保证顺序一致”
- “把书面表达改成自然口语”
项目固定约束（本项目强制）
- 所有沟通使用中文。
- 口播稿默认写中文；代码片段与路径保持原文。
- 口播稿风格必须与源讲义一致：技术解释型、章节化、主线清晰，不写营销化、主持化、夸张化表达。
- 内容顺序必须严格跟随源文档的标题顺序，不允许把后文总结提前到前文。
- 允许补充解释，但禁止改写原文观点、禁止新增与原文冲突的信息。
- 目标是“原文全覆盖 + 关键难点补解释”，不是“另写一篇新稿”。
- 默认给出可支撑长视频版本（若用户要求 30 分钟，则至少输出 30 分钟体量）。
- 无迁移，直接替换（当用户要求重写口播稿时，直接按新要求覆盖目标稿件）。
输入与输出约定
输入
- 主输入：一篇教程文档路径（例如
docs/tutorial/2026/ch1/qemu-qom.md）
- 可选输入：已有口播稿路径（例如
video/qemu-qom-口播稿.md）
- 可选输入：目标时长（例如 30 分钟）
输出
默认输出一个可直接录制的 Markdown 口播稿，放在 video/ 目录，文件名建议：
并在回复中说明：
- 已更新/新建的文件路径
- 是否严格按讲义顺序
- 是否覆盖讲义全部章节
标准工作流（必须按顺序执行）
-
读取规范
- 读取仓库
AGENTS.md。
- 若有全局/目录级约束，优先遵循。
-
读取源讲义
- 完整读取目标文档。
- 提取标题结构（
#、##、!!! 提示块、章节小结、测验段）。
-
读取风格样本
- 读取
video/ 下至少 2 份现有口播稿，提炼项目风格：
-
建立“覆盖清单”
- 按源讲义顺序列出每个章节和关键点。
- 生成时逐项覆盖，确保“无遗漏、无错序”。
-
生成/改写口播稿
- 保持和讲义同序。
- 在原文基础上补解释（为什么、做什么、怎么串起来）。
- 将明显书面句改成可朗读口语，但保留技术准确性。
-
自检（交付前必须做）
- 顺序检查：逐节对照源讲义，确认无章节错位。
- 覆盖检查：确认每个
## 标题都在口播稿出现。
- 风格检查：去除 AI 腔（如“我按原意展开”“本模型认为”等）。
- 时长检查：用户要求 30 分钟时，正文体量必须足够。
口播稿写作规范（项目内）
- 使用自然中文口语，但保持技术密度。
- 每节先讲“这节要解决什么问题”，再讲细节。
- 代码块只保留必要片段，避免过多冗长粘贴。
- 优先解释主调用链和关键数据结构。
- 段落之间保持逻辑衔接词：
- “先看…再看…”
- “这里有个关键点…”
- “到这里可以得到一个结论…”
- 不写无信息量填充语。
常见问题处理
- 如果用户说“内容太少”：
- 增加每节的过渡解释、上下文背景、关键代码语义说明与小结。
- 如果用户说“顺序不对”：
- 如果用户说“太书面”：
回应模板（简洁）
交付时优先使用这类格式：
- 已更新：
video/xxx-口播稿.md
- 处理结果：
- 已按
docs/... 标题顺序重排；
- 已覆盖讲义全部
## 章节与测验引导；
- 已口语化，去除 AI 腔。
- 如需下一步：可继续提供“按分钟分段版”或“分镜提示版”。
本次会话沉淀（项目特化）
以下是本项目已确认有效的约束，后续同类任务默认执行：
- 用户明确要求：口播稿风格必须与原文一致，不能有 GPT 风格。
- 用户明确要求：内容顺序必须与原讲义完全一致。
- 用户明确要求：在原文基础上做补充和解释，不可偏离原文结构。
- 用户明确要求：时长需可支撑长视频（至少 30 分钟）。
- 用户明确反馈：像“讲义这里给了一个很清晰的三段总结，我按原意展开”这类书面提示语不适合口播，需改为自然口语。
