Repolode
ywEdAi

ywEdAi/teachable-figures

一个智能体技能,可把课程论点转化为学习者能预测、调整并解释的交互式教学图示。

Star
288
Fork
38
未关闭 Issue
0
最近提交
5天前

这是什么?

Teachable figures 是一个智能体技能,用于围绕单一因果论点制作可交互的教学图示。学习者先预测结果,再通过原生控件改变原因、观察效果,最后解释一个迁移案例。技能先整理教学规格,包括论点、常见误解、原因、可观察效果和底层模型,再决定几何结构和渲染方式。

仓库包含技能说明、基于两个上游技能改造的渲染组件(Anatomy 用于机械实体和 3D 视图,iso-figure 用于等轴测 SVG),六个可离线运行的完整课程示例,以及浏览器和模型测试。它可以接入宿主应用的课程结构,也可以生成独立 HTML 图示,并可安装到 Claude Code 或 Codex 的技能目录中。

示例涵盖齿轮传动比、圆锥截面、三维人体胸腔、火箭剖视、Transformer 注意力数据流以及明代服饰。项目明确指出,生成的图示属于教学设计,尚未经过学习者评估。

核心功能

  • 01将单一教学论点转化为预测、尝试、解释的交互流程。
  • 02提供 2D SVG、等轴测 SVG、机械剖视和三维旋转等渲染组件。
  • 03附带六个可离线运行的完整 HTML 课程,支持原生控件、重置和中英文切换。
  • 04包含模型测试、浏览器测试以及三维几何审计脚本。
  • 05可作为 Claude Code 或 Codex 技能安装,也可单独生成 HTML 图示。

适用场景

  • 制作交互式物理或机械演示,展示改变一个输入如何影响输出。
  • 为某个常见误解的课程制作独立 HTML 教学图示。
  • 在已有的教育类网页应用中加入预测与解释环节。
  • 为学生可视化注意力机制或齿轮系等抽象模型。

快速上手

  1. 1

    将仓库克隆到 Claude Code 的 skills 目录中安装

    git clone https://github.com/ywEdAi/teachable-figures.git ~/.claude/skills/teachable-figures
  2. 2

    重启 Claude Code,然后输入 /teachable-figures 并描述教学任务

  3. 3

    可选:安装开发依赖以运行检查

    npm ci

使用前须知

  • 元数据中未注明许可证,复用条款不明确。
  • 生成的图示尚未经学习者评估,教学效果未经证实。
  • 部分内置示例带有自动播放导览,整合进课程前需要关闭。
  • 浏览器检查需要已安装的 Google Chrome 或配置好的 Playwright Chromium。

收录于专题

标签

常见问题

teachable-figures 是什么?
一个智能体技能,可把课程论点转化为学习者能预测、调整并解释的交互式教学图示。 Teachable figures 是一个智能体技能,用于围绕单一因果论点制作可交互的教学图示。学习者先预测结果,再通过原生控件改变原因、观察效果,最后解释一个迁移案例。技能先整理教学规格,包括论点、常见误解、原因、可观察效果和底层模型,再决定几何结构和渲染方式。
teachable-figures 可以免费使用吗?用的什么许可证?
teachable-figures 没有声明许可证。代码虽然公开,但没有许可证就没有明确的使用授权,正式使用前建议先联系作者。
teachable-figures 还在维护吗?
活跃维护中。teachable-figures 最近一次提交是在 2026年11月3日。
teachable-figures 适合用来做什么?
制作交互式物理或机械演示,展示改变一个输入如何影响输出。 为某个常见误解的课程制作独立 HTML 教学图示。 在已有的教育类网页应用中加入预测与解释环节。 为学生可视化注意力机制或齿轮系等抽象模型。
teachable-figures 怎么安装和运行?
将仓库克隆到 Claude Code 的 skills 目录中安装: git clone https://github.com/ywEdAi/teachable-figures.git ~/.claude/skills/teachable-figures 重启 Claude Code,然后输入 /teachable-figures 并描述教学任务 可选:安装开发依赖以运行检查: npm ci
在哪里获取 teachable-figures?
源代码和安装说明在 GitHub 上:https://github.com/ywEdAi/teachable-figures

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目