edu-math-tutorial

agentscope-ai/QwenPaw · Agent Skill

生成分步数学教程视频,将问题分解为阶段,并提供旁白脚本和视觉指导。

前往安裝 ↓

安裝選項

預設為含檢閱步驟的提示。您可以切換到直接指令。

透過 Claude 或 Codex 安裝

複製提示,貼入 Claude、Codex 或其他助手,它會檢視技能頁面並安裝。

I'd like to install this Claude Code skill:
https://github.com/agentscope-ai/QwenPaw/tree/main/plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial

Please review the SKILL.md file, verify the skill is legitimate, then copy the skill folder into .claude/skills/ of my project.

技能檔案

1 個檔案 下載 ZIP

安裝前請先檢視 SKILL.md 與相關檔案。點擊檔案即可預覽。

SKILL.md 內容

作者原文 · 唯讀

数学讲解视频 · 领域知识

本 skill 指导如何把一道数学题组织成高质量的分步讲解视频。它不提供渲染脚本:

每个讲解场景是主时间轴上的一个 creation.type=motion_clip Element,旁白是

creation.type=audio Element,成片由 Creator 的确定性渲染管线合成。

1. 题目拆解方法

先完成解题分析,再规划视频。按顺序产出三层事实(写进委派任务书,不需要落盘):

1. 题面:完整题目文本,全部数学表达式用 LaTeX 表示;有图形时先文字化描述。

2. 解法链:选择最常规、面向学生的解法,把过程拆成 2–5 个原子步骤,每步

只做一件事。一元一次方程的标准链是:移项 → 合并同类项 → 系数化为 1;

几何题的标准链是:读图标注 → 引用定理 → 代入求解。

3. 易错点:每步至多标注一个学生最易犯的错误(如"移项要变号"),在旁白

与画面中同步提醒。

2. 视频结构与讲解节奏

固定五段式结构,每段一个场景(motion_clip Element):

| 段落 | 内容 | 时长基准 |

|------|------|---------|

| 开场 | 完整题面 + 一句目标("我们的目标是求出 x") | 6–10s |

| 步骤 N | 每个原子步骤一段:上一步结果 → 本步操作标注 → 本步结果 | 各 8–14s |

| 收尾 | 最终答案 + 一句验算或总结 | 5–8s |

节奏规则:

  • 旁白按语速约 4.5 字/秒估算时长;场景时长 = 对应旁白时长 + 1–2s 静读缓冲。
  • 每段旁白 1–3 句,单句不超过 25 字;步骤段先说操作依据,再报结果。
  • 相邻场景之间内容必须有承接:下一场景开头展示上一场景的结论("上一步"栏)。

3. 旁白文案规范

  • 全程中文口语,数学式读法固定:5x-7=13 读作"5x 减 7 等于 13";分数读作

"5 分之 20";除法读作"20 除以 5"。不读 LaTeX 符号本身。

  • 操作句式:"把常数项负 7 移到等号右边,移项要变号,所以右边变成 13 加 7。"
  • 每句都要能独立成字幕:不用"然后呢"“接下来我们再"之类的口头填充词。
  • 旁白文本写入对应 audio Element 的 creation.script,后续可改词重合成。
  • 旁白逐句同步上字幕:每一句旁白对应一张字幕卡(见第 5 节),字幕文本必须与该句旁白逐字一致。

4. 版式与画面风格(motion_clip 的 prompt 要点)

每个场景的 creation.prompt 用自然语言写清画面意图,包含以下要素,实际动效

文档由 design_motion_overlays 生成(不要手写 creation.motion):

  • 主题:默认"Aurora Scholar"——浅色淡紫/靛蓝渐变背景、柔和光斑;同一

视频内所有场景共用一个主题。

  • 教学面板:白色实心不透明圆角卡片承载公式与步骤(禁止半透明磨砂),

卡片带分层柔和阴影;步骤编号用紫色圆形徽标。

  • 公式排版:数学表达式按 KaTeX 风格排版(衬线斜体变量、正体数字与

运算符),题面/结果公式为视觉主体、居中放大;操作说明用小号胶囊标签放在

两个公式之间(如"将 -7 移到右边,变号为 +7")。

  • 步骤卡布局:"上一步"公式在上(浅灰底栏),操作标签居中,"得到"结果

在下(浅绿底栏高亮)。

  • 画面文字全中文:步骤徽标、操作标签、栏目标题("上一步""得到"等)一律

用中文,禁止出现英文标注;每段卡片内容必须与本段旁白所讲的步骤严格一致

(写 prompt 时把本段旁白原文附在后面作为对齐锚)。

  • 字幕:由独立的字幕 Overlay Element 承担(见第 5 节),不要画进

motion_clip 文档里;教学面板预留底部约 15% 高度的留白,确保字幕不与

面板重叠。

  • 动效:入场用轻柔上浮淡入,公式变化处做逐项高亮;不使用炫技转场。

5. 落地为 Creator 原生结构(执行流程)

1. 按第 1–2 节完成拆解与分段规划,估算每段旁白文本与时长。

2. 委派 ai_editing_directortimeline:<timelineId>,任务书写明:

  • 按分段各创建一个 creation.type=motion_clip 的主轨 Element(span 按

第 2 节时长基准顺序接排,creation.prompt 按第 4 节要点写足画面内容,

包含该段的具体公式 LaTeX、中文操作标注文字与本段旁白原文);

  • 为每段创建 creation.type=audio 的旁白 Element(creation.script

第 3 节规范的文案,span 与对应场景对齐);

  • 为每一句旁白创建一个 creation.type=overlay 的字幕 Element:text

填该句旁白原文(逐字一致,不改写不省略),span 按该句在本段内的

时间位置排布(按字数占比分配本段时长),location 用底部居中胶囊

默认值 x=0.50, y=0.88, width=0.80, height=0.14;字幕不可省略,

每句旁白都必须有对应字幕覆盖其时段;

  • 写入后调用 design_motion_overlays 生成各 motion_clip 的动效文档

与字幕卡样式,必须同时传 captionStyle="uniform"

sceneStyle="edu_steps":解说字幕全片用同一固定模板,只换文字;

教学场景用确定性推导卡模板(步骤徽章/上一步/推导行/结果高亮固定

骨架,底部自带字幕留白),模型只填内容文案且强制中文,全片版式

绝对一致。为此每个 motion_clip 的 prompt 只需写清本段要讲的内容

(步骤名、上一步公式、本步推导、结果),不需要描述视觉风格。

3. 成片合成走 Creator 确定性渲染(用户在 UI 上或由既有 compose 流程触发),

不在任何沙箱内渲染视频。

4. 自查:逐场景核对公式推导正确、画面标注全中文且与本段旁白一致、每句旁白

都有字幕且不与面板重叠、字幕样式全篇一致、场景时长覆盖对应旁白。