mcpField
M
math-teacher

math-teacher

github.com/jamesrochabrun其他221874 次安装41 周前更新
代码仓库

关于 math-teacher

math-teacher 是面向数学学习者的交互式教学技能,可按提问生成独立运行的 HTML/JS 可视化练习,内容从基础算术延伸到高等数学,并结合提示、反馈和游戏化机制。

主要功能

  1. 01即时生成交互式数学练习
  2. 02覆盖基础数学至高等数学
  3. 03通过图表和动画进行可视化
  4. 04提供提示与即时反馈
  5. 05加入积分、成就和挑战
  6. 06生成无需外部依赖的网页

适用场景

  1. 01用可视化理解数学概念
  2. 02生成指定主题的练习题
  3. 03通过挑战模式练习并查看进度

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jamesrochabrun/skills --skill math-teacher

安装后在 Claude Code 中输入/math-teacher确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
algebra.md
basic_math.md
calculus.md
gamification.md
scripts/
generate_game.sh
generate_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 工具执行相应脚本。

如何使用脚本:
  1. **对于通用数学游戏/挑战:**使用 generate_game.sh

    bash /Users/jamesrochabrun/Desktop/skills/skills/math-teacher/scripts/generate_game.sh
    
  2. **对于交互式乐园:**使用 generate_playground.sh

    bash /Users/jamesrochabrun/Desktop/skills/skills/math-teacher/scripts/generate_playground.sh
    
  3. **对于测验:**使用 generate_quiz.sh(如果存在)

    bash /Users/jamesrochabrun/Desktop/skills/skills/math-teacher/scripts/generate_quiz.sh
    

请勿在技能加载时尝试自动调用这些脚本——这会导致 Bash 安全错误。务必明确使用 Bash 工具运行它们。

最佳实践

应该:

✅ 做得直观且富有互动性 ✅ 从简单开始,逐步增加复杂度 ✅ 使用颜色和动画 ✅ 提供即时反馈 ✅ 庆祝成功 ✅ 包含提示和说明 ✅ 让过程有趣且轻松 ✅ 支持移动设备

不应该:

❌ 只展示公式,不提供背景说明 ❌ 内容过于依赖文字 ❌ 假设用户已有相关知识 ❌ 跳过游戏化设计 ❌ 忽视视觉型学习者 ❌ 让内容令人望而生畏 ❌ 使用枯燥、学术化的语气 ❌ 要求安装外部库

交互示例

初学者:

“我想学习乘法”

生成内容:交互式乘法表网格游戏,包含点击翻牌、进度追踪和成就徽章

中级:

“帮我理解勾股定理”

生成内容:可视化直角三角形构建器,可拖动顶点、查看 a²、b²、c² 方块和动画证明

高级:

“教我如何优化函数”

生成内容:带有梯度下降可视化的 3D 曲面图,可调整学习率并追踪路径

总结

这项技能通过以下方式改变数学教育:

  • 即时投入——立即生成乐园
  • 可视化学习——图表、动画、交互式示意图
  • 游戏化——积分、成就、挑战
  • 自适应难度——从基础到高级
  • 独立运行——所有产物均可独立运行
  • 轻松有趣——有趣、色彩丰富、富有奖励
  • 高效——通过实践和探索来学习

“数学应该是一场冒险,而不是苦差事。” 🚀


**用法:**提出任何数学问题、请求解释某个概念,或说“教我 [主题]”,即可获得即时的交互式学习体验!

评论

支持 Markdown