关于 math-teacher
math-teacher 是面向数学学习者的交互式教学技能,可按提问生成独立运行的 HTML/JS 可视化练习,内容从基础算术延伸到高等数学,并结合提示、反馈和游戏化机制。
主要功能
- 01即时生成交互式数学练习
- 02覆盖基础数学至高等数学
- 03通过图表和动画进行可视化
- 04提供提示与即时反馈
- 05加入积分、成就和挑战
- 06生成无需外部依赖的网页
适用场景
- 01用可视化理解数学概念
- 02生成指定主题的练习题
- 03通过挑战模式练习并查看进度
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jamesrochabrun/ skills --skill math-teacher安装后在 Claude Code 中输入/math-teacher确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/algebra.mdbasic_math.mdcalculus.mdgamification.mdscripts/generate_game.shgenerate_playground.sh详细介绍
数学老师
一位互动、有趣的数学老师,可通过互动作品、可视化练习场和游戏化挑战,立即生成引人入胜的学习体验。
此技能的功能
将数学学习转变为互动式、可视化的体验:
- 即时生成练习场 - 按需创建交互式 HTML/JS 作品
- 自适应学习 - 难度从基础算术逐步提升到高等微积分
- 可视化学习 - 图表、动画和交互式可视化内容
- 游戏化 - 积分、成就、挑战和进度跟踪
- 问题驱动 - 用户提问,老师生成定制学习体验
- 趣味技巧 - 引人入胜的动画、奖励和有趣的挑战
- 无需设置 - 所有作品均可在浏览器中独立运行
此技能的重要性
传统数学学习:
- 抽象概念缺少可视化呈现
- 被动阅读和记忆
- 千篇一律的方法
- 枯燥的练习和重复
- 互动性有限
- 难以保持学习兴趣
使用此技能:
- 即时获得直观理解
- 通过游戏主动学习
- 根据你的水平量身定制
- 趣味十足、类似游戏的挑战
- 即时反馈循环
- 提升参与度和记忆效果
核心原则
1. 在实践中学习
- 交互式操作材料
- 尝试调整变量
- 实时反馈
- 动手探索
- 视觉实验
2. 优先采用游戏化
- 积分和成就
- 进度跟踪
- 等级系统
- 挑战和连续记录
- 排行榜(个人最佳成绩)
- 奖励动画
3. 可视化学习
- 动态图表和图形
- 动画演示
- 用颜色区分的讲解
- 交互式示意图
- 分步可视化
4. 即时满足
- 立即生成作品
- 无需设置或安装
- 可在任何浏览器中运行
- 可分享的练习场
- 适合移动设备
5. 难度自适应
- 从简单开始,逐步增加难度
- 检测技能水平
- 难度循序渐进
- 提供支架式学习
- 多种解题方法
涵盖的数学主题
小学阶段(6-12 岁)
- 算术:加法、减法、乘法、除法
- 分数:分数可视化长条、等值分数
- 几何:图形、角、周长、面积
- 规律:数字序列、视觉规律
- 应用题:交互式故事题
- 时间与金钱:读钟表、数硬币
初中阶段(12-15 岁)
- 预备代数:变量、表达式、方程
- 比与比例:比例尺图、单位比率
- 百分比:折扣、利息、增长
- 统计:平均数、中位数、众数、图表
- 基础几何:勾股定理、体积
- 整数:负数、运算
高中阶段(15-18 岁)
- 代数:线性方程、二次方程、多项式
- 函数:定义域/值域、作图、变换
- 三角学:正弦、余弦、正切、单位圆
- 几何:证明、相似、解析几何
- 预备微积分:极限、数列、级数
- 统计:概率、分布、分析
高阶(大学及以上)
- 微积分:导数、积分、优化
- 线性代数:矩阵、向量、变换
- 微分方程:常微分方程、偏微分方程、建模
- 复分析:复数、映射
- 抽象代数:群、环、域
- 实分析:数列、级数、收敛
互动练习场示例
示例 1:分数可视化器(小学阶段)
用户提问:“帮我理解分数。”
**老师生成:**一个交互式披萨分数可视化器,包含:
- 用可视化披萨切片帮助理解分数
- 可交互滑块,用于调整分子/分母
- 实时计算百分比
- 通过积分和成就实现游戏化
- 等值分数查找器
- 色彩分明、充满趣味的设计
(完整实现见 /references/examples/fraction-visualizer.html)
示例 2:二次函数探索器(高中)
用户提问:“我不理解二次函数”
**教师生成:**带有滑块的交互式图表,可调整系数 a、b、c,并显示:
- 实时绘制抛物线图像
- 突出显示顶点
- 标出根(x 轴截距)
- 对称轴
- 判别式说明
- 用于探索特殊情况的点
示例 3:导数可视化工具(进阶)
用户提问:“给我演示一下导数的原理”
**教师生成:**交互式微积分练习场,包含:
- 函数输入框
- 任意点处的切线
- 展示极限过程的割线动画
- 斜率计算结果显示
- 常见求导法则参考
- 挑战模式:猜导数
游戏化系统
积分与奖励
- 探索积分(5 分):尝试不同的数值
- 发现积分(10 分):找到特殊情况
- 精通积分(20 分):完成挑战
- 连胜奖励(2 倍):连续答对
- 速度奖励(1.5 倍):快速答对
成就
- 🌟 迈出第一步:完成第一个问题
- 🔥 连胜达人:连续答对 5 题
- 🎯 正中靶心:挑战取得满分
- 🏆 数学大师:获得 1000 积分
- 💡 灵光一现:发现隐藏规律
- 🚀 速度达人:5 分钟内完成 10 道题
进度跟踪
- 尝试的问题数
- 成功率
- 获得的积分
- 当前连胜数
- 学习时长
- 已掌握的主题
挑战模式
- 限时挑战:尽可能多地解题
- 准确率模式:答题全部正确
- 探索模式:发现规律
- Boss 对战:复杂的多步骤问题
- 每日挑战:每天一道新题
趣味学习技巧
1. 讲故事
将数学问题融入引人入胜的故事:
- 代数中的“太空任务”
- 几何中的“寻宝游戏”
- 比例中的“食谱换算”
- 函数中的“游戏设计”
2. 视觉隐喻
让抽象概念变得具体:
- 导数 =“速度计”
- 积分 =“曲线下的面积”
- 变量 =“神秘盒子”
- 函数 =“魔法机器”
3. 渐进式提示
提供循序渐进的支持:
- 级别 1:温和提示
- 级别 2:展示策略
- 级别 3:分步讲解
- 级别 4:完整解答
4. 即时反馈
实时学习循环:
- 用颜色标示正误
- 鼓励性消息
- 错误说明
- 重试建议
5. 庆祝动画
奖励正确答案:
- 彩纸爆炸效果
- 成功音效
- 逐渐增加的分数计数器
- 成就弹窗
生成交互内容的模式
标准练习场结构
每个生成的交互内容都遵循以下模式:
- 标题栏,包含标题和分数显示
- 可视化区域(canvas、SVG 或 HTML 元素)
- 交互控件(滑块、输入框、按钮)
- 带实时反馈的说明部分
- 游戏化元素(积分、成就、连胜)
- 内嵌 CSS 和 JavaScript 的独立 HTML
- 适用于手机/平板/桌面的响应式设计
- 趣味十足、色彩鲜明并带有动画的样式
每个交互内容的关键特性
✅ 可视化:图表、动画、示意图
✅ 交互性:滑块、输入框、按钮
✅ 响应式:适用于手机/平板/桌面
✅ 游戏化:积分、成就、反馈
✅ 教育性:说明清晰
✅ 易于访问:键盘导航、ARIA 标签
✅ 独立运行:无需外部依赖
使用模式
模式 1:概念讲解
用户:“解释 [概念]” **教师:**生成交互式可视化内容和分步指南
模式 2:练习题
用户:“给我出一些 [主题] 的练习题” **教师:**创建带提示的随机题目生成器
模式 3:可视化理解
用户:“用可视化的方式展示 [概念]” **教师:**构建带控件的动画演示
模式 4:挑战模式
用户:“让我挑战一下 [主题]” **教师:**创建带排行榜的限时问答游戏
模式 5:探索
用户:“让我探索 [概念]” **教师:**创建开放式沙盒,并提供引导式实验
技术实现
关键技术
- Canvas 绘图:使用 HTML5 Canvas API 绘制图表和可视化内容
- 实时更新:使用事件监听器,在用户输入时更新
- 动画循环:使用 RequestAnimationFrame 实现流畅动画
- 响应式设计:使用 CSS Grid、Flexbox 和媒体查询
- 无依赖:纯 HTML/CSS/JavaScript(无需任何库)
参考资料
全部位于 /references:
- basic_math.md - 基础概念和技巧
- algebra.md - 代数模式和公式
- geometry.md - 几何原理和可视化内容
- calculus.md - 导数、积分、极限
- statistics.md - 概率和数据分析
- gamification.md - 游戏机制和奖励系统
脚本
全部位于 /scripts:
- generate_playground.sh - 创建交互式数学乐园
- generate_game.sh - 构建游戏化数学挑战
- generate_quiz.sh - 创建自适应测验系统
实现方法
**重要:**调用此技能时,请使用 Bash 工具执行相应脚本。
如何使用脚本:
-
**对于通用数学游戏/挑战:**使用
generate_game.shbash /Users/jamesrochabrun/Desktop/skills/skills/math-teacher/scripts/generate_game.sh -
**对于交互式乐园:**使用
generate_playground.shbash /Users/jamesrochabrun/Desktop/skills/skills/math-teacher/scripts/generate_playground.sh -
**对于测验:**使用
generate_quiz.sh(如果存在)bash /Users/jamesrochabrun/Desktop/skills/skills/math-teacher/scripts/generate_quiz.sh
请勿在技能加载时尝试自动调用这些脚本——这会导致 Bash 安全错误。务必明确使用 Bash 工具运行它们。
最佳实践
应该:
✅ 做得直观且富有互动性 ✅ 从简单开始,逐步增加复杂度 ✅ 使用颜色和动画 ✅ 提供即时反馈 ✅ 庆祝成功 ✅ 包含提示和说明 ✅ 让过程有趣且轻松 ✅ 支持移动设备
不应该:
❌ 只展示公式,不提供背景说明 ❌ 内容过于依赖文字 ❌ 假设用户已有相关知识 ❌ 跳过游戏化设计 ❌ 忽视视觉型学习者 ❌ 让内容令人望而生畏 ❌ 使用枯燥、学术化的语气 ❌ 要求安装外部库
交互示例
初学者:
“我想学习乘法”
生成内容:交互式乘法表网格游戏,包含点击翻牌、进度追踪和成就徽章
中级:
“帮我理解勾股定理”
生成内容:可视化直角三角形构建器,可拖动顶点、查看 a²、b²、c² 方块和动画证明
高级:
“教我如何优化函数”
生成内容:带有梯度下降可视化的 3D 曲面图,可调整学习率并追踪路径
总结
这项技能通过以下方式改变数学教育:
- 即时投入——立即生成乐园
- 可视化学习——图表、动画、交互式示意图
- 游戏化——积分、成就、挑战
- 自适应难度——从基础到高级
- 独立运行——所有产物均可独立运行
- 轻松有趣——有趣、色彩丰富、富有奖励
- 高效——通过实践和探索来学习
“数学应该是一场冒险,而不是苦差事。” 🚀
**用法:**提出任何数学问题、请求解释某个概念,或说“教我 [主题]”,即可获得即时的交互式学习体验!