edu-math-tutorial
agentscope-ai/QwenPaw · Agent Skill
生成分步數學教程影片,將問題分解為階段,並提供旁白指令碼和視覺指導。
前往安裝 ↓總覽
| 發布者 | |
|---|---|
| 儲存庫 | agentscope-ai/QwenPaw ↗ |
| 技能資料夾 | edu-math-tutorial |
| 星 | 35,046 |
| 附帶檔案 | 1 |
| 授權 | Apache-2.0 |
| 最近更新 | 2026年8月10日 |
| 連結 | 技能原始碼 ↗ · 儲存庫 ↗ |
Mozgi 檢查
我們在技能檔案中發現的內容。詳細資訊需訂閱。
安裝
技能就是一個含 SKILL.md 的資料夾。選擇你的代理,在專案根目錄的終端機(macOS、Linux 或 Windows 的 Git Bash)執行指令。
把提示貼到 Claude、Codex 或其他助理:它會自行檢查並安裝技能。
Install the “edu-math-tutorial” skill from mozgi.io (https://mozgi.io/skills/edu-math-tutorial/) for me. 1. Download the archive: https://mozgi.io/skills/edu-math-tutorial/download If it fails, take the skill folder from the source: https://github.com/agentscope-ai/QwenPaw/tree/main/plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial 2. Read SKILL.md and the other files. Check the skill is safe: no hidden commands, no sending data elsewhere, no scripts doing something other than described. If anything looks suspicious, stop and tell me. 3. Put the “edu-math-tutorial” folder into your agent's skills folder: .claude/skills/ for Claude Code, .agents/skills/ for Codex, .cursor/skills/ for Cursor, .gemini/skills/ for Gemini CLI. Inside the project if we are in one, otherwise in the home folder (~/.claude/skills/ etc.). 4. Make sure <skills folder>/edu-math-tutorial/SKILL.md exists. 5. Briefly tell me what this skill does and offer to try it on my task. If you cannot do a step yourself, tell me what to click or type.
git clone --depth 1 --branch main https://github.com/agentscope-ai/QwenPaw.git /tmp/QwenPaw mkdir -p .claude/skills cp -r /tmp/QwenPaw/plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial .claude/skills/edu-math-tutorial
重新啟動 Claude Code — 技能就會出現在清單中,手動呼叫:/edu-math-tutorial。要套用到所有專案,請放在 ~/.claude/skills。
git clone --depth 1 --branch main https://github.com/agentscope-ai/QwenPaw.git /tmp/QwenPaw mkdir -p .agents/skills cp -r /tmp/QwenPaw/plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial .agents/skills/edu-math-tutorial
Codex 會從目前資料夾往上到儲存庫根目錄,在 .agents/skills 中尋找技能;用 /skills 或 $edu-math-tutorial 呼叫。所有專案:~/.agents/skills。
git clone --depth 1 --branch main https://github.com/agentscope-ai/QwenPaw.git /tmp/QwenPaw mkdir -p .cursor/skills cp -r /tmp/QwenPaw/plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial .cursor/skills/edu-math-tutorial
Cursor 啟動時會載入技能;在 Agent 聊天輸入「/」呼叫。Cursor 也會讀取 .claude/skills 與 .agents/skills。所有專案:~/.cursor/skills。
git clone --depth 1 --branch main https://github.com/agentscope-ai/QwenPaw.git /tmp/QwenPaw mkdir -p .gemini/skills cp -r /tmp/QwenPaw/plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial .gemini/skills/edu-math-tutorial
任務符合時,Gemini CLI 會提議啟用技能,由你確認。所有專案:~/.gemini/skills。
安裝前請先檢視 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_director 到 timeline:<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. 自查:逐场景核对公式推导正确、画面标注全中文且与本段旁白一致、每句旁白
都有字幕且不与面板重叠、字幕样式全篇一致、场景时长覆盖对应旁白。
常見問題
edu-math-tutorial 技能有什麼用途?
生成分步數學教程影片,將問題分解為階段,並提供旁白指令碼和視覺指導。
如何安裝 edu-math-tutorial?
打開本頁的「安裝」區塊並選擇你的代理 — Claude Code、Codex、Cursor 或 Gemini CLI:那裡有把技能資料夾複製到正確位置的現成指令。也可以複製「透過助理」分頁中的提示,讓助理自行檢查並安裝技能。
edu-math-tutorial 適用哪些 AI 模型?
技能是純 Markdown 指示(Agent Skills 格式),因此 edu-math-tutorial 適用任何讀取 SKILL.md 的代理:Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode 等。只有在任務符合技能描述時,模型才會載入指示。
edu-math-tutorial 是免費的嗎?
此技能由 agentscope-ai 公開發布,採用 Apache-2.0 授權。技能本身免費 — 你只需向 AI 供應商支付實際使用的 token 費用。
安裝技能安全嗎?
技能是代理會遵循的指示,安裝前請閱讀 SKILL.md 及相關檔案。技能資料夾中的腳本只有在代理執行時才會運行 — 留意它的動作,不要授予多餘權限。
技能和 MCP 伺服器或外掛有何不同?
MCP 伺服器或外掛為模型提供新工具 — 會執行並回傳結果的程式碼。技能提供的是知識與流程:如何處理任務、要遵循哪些步驟、好的成果長什麼樣子。它不需要伺服器或 API 金鑰。