Loading...
正在加载...
请稍候

TeachAny:把学习科学封装成 AI 教学系统的开源实践

小凯 (C3P0) 2026年05月24日 00:21

GitHub: weponusa/teachany | 137+ 课件 | 2,378 知识节点 | AGPL-3.0 + 商业双授权

定位:每个学校、每个教师、每个家长,都能零成本定制属于每个孩子的可汗学院


一、AI 生成教育内容的通病

用 ChatGPT 或 Claude 生成教学材料,输出通常长这样:

📝 关于二次函数的 5 个要点……
📋 测验:y = x² + 2x + 1 的顶点是什么?
   A) (1, 0)   B) (-1, 0)   C) (0, 1)   D) (-1, 1)

扁平、无生命、没有教学设计。学生拿到一堵文字墙,末尾贴一道选择题。没有动机设计,没有错误诊断,没有学习闭环。

问题的根源不是 LLM 不够聪明,而是提示工程缺乏教育学框架。大多数教育类 prompt 只是把"生成教案"当成信息整理任务,忽略了学习科学已经研究了几十年的结论:人是怎么学会的。

TeachAny 的解法不是更复杂的 prompt,而是把教育学理论直接写进 AI 的工作流


二、六大学习科学理论的系统嵌入

TeachAny 不是让 AI"参考"这些理论,而是把它们变成了强制执行的规则。

2.1 ABT 叙事结构(And-But-Therefore)

每个模块开篇遵循 ABT 叙事:

  • And:你已知道什么(建立关联)
  • But:矛盾点或认知缺口(制造张力)
  • Therefore:为什么要学这个(赋予意义)

这比"今天我们学习二次函数"有效得多。ABT 来自 Randy Olson 的《Houston, We Have a Narrative》,最初用于科学传播,TeachAny 把它改造成了课件的开场模板。

2.2 Bloom 认知分类法

练习必须覆盖全部 6 个认知层级:

层级 动词示例 题型设计
记忆 回忆、识别 概念卡片
理解 解释、分类 填空题
应用 执行、实施 计算题
分析 区分、归因 过程拆解
评价 判断、检验 论证题
创造 生成、计划 设计任务

普通 AI 生成的题目通常停留在"记忆→理解"两层。TeachAny 的设计系统强制要求至少覆盖 3 个层级。

2.3 ConcepTest(Mazur 同伴教学法)

概念检测题的设计目标是 30-70% 正确率——这是 Eric Mazur 在哈佛大学物理教学中验证过的"甜蜜点"。正确率太高说明题目太简单,没有讨论价值;太低则挫败感过强。TeachAny 的评估系统会检查题目难度是否落在这个区间。

2.4 认知负荷理论(Sweller)

三张硬约束:

  • 每张信息卡片 ≤ 75 字
  • 每个模块只承载 1 个核心问题
  • 新概念出现 → 立即配例子

这是 John Sweller 认知负荷理论的直接应用。工作记忆容量有限,信息过载会让学习效果断崖式下跌。

2.5 Mayer 多媒体学习原则

七个原则被强制应用于每一个版面决策:

  • 邻近性原则:图文相邻,而非分离
  • 信号原则:用视觉标记突出关键信息
  • 分割原则:复杂内容分步呈现
  • 预训练原则:先教组件,再讲整体
  • 等等

Richard Mayer 的研究表明,遵守这些原则的多媒体材料能让学习效果提升 50-100%。TeachAny 把它从"建议"变成了"规范"。

2.6 脚手架策略

三级支架系统:

  • Level 1:提供完整模板,学生填空
  • Level 2:只给提示,学生自行推导
  • Level 3:完全独立工作

学生从 Level 1 起步,逐渐撤除支持。这是 Wood、Bruner 和 Ross 1976 年提出的经典 tutoring 模型,TeachAny 把它变成了课件内部的自适应机制。


三、九学科专属框架:不做一刀切

TeachAny 最务实的决策是拒绝通用模板。9 个学科各有专属的教学路径:

学科 教学路径 交互类型 评估风格
数学 直观可视化 → 代数推理 → 推广 作图、拖拽、逐步推导 标准题 + 解释题
物理 观察 → 建模 → 定量分析 参数滑块、实验预测 预测 + 计算 + 解释
生物 结构 → 过程 → 功能 标注、排序、流程图 图解 + 过程解释
地理 空间分布 → 成因 → 区域比较 地图交互、因果链 材料分析 + 比较
历史 时间线 → 因果 → 证据 → 多视角 排序、史料对比、立场分析 史料题 + 论述
语文 细读 → 表达技法 → 主题迁移 批注、改写、仿写 批注 + 写作 + 评分量规
英语 输入 → 支架输出 → 情境应用 对话卡片、填空、角色扮演 综合技能评估
化学 宏观现象 → 微观解释 → 符号表征 实验流程、方程式配平 实验解释 + 结构化应答
信息技术 任务驱动 → 分步演示 → 调试 点击操作、流程图、代码执行 任务完成 + 过程检查

这个矩阵的价值在于:当教师说"做一个物理课件"时,AI 知道该用参数滑块而不是填空题;说"做历史课件"时,AI 会自动引入史料对比和多视角分析。


四、原创方法论

4.1 五镜头法(Five-Lens Method)

对任何难点概念,强制选择 2-3 个镜头:

👁️ See It      → 观察现象、例子、数据
🔧 Break It    → 拆解结构、步骤、组件
💡 Explain It  → 澄清成因、机制、规则
⚖️ Compare It  → 与相似/相反/错误案例对比
🎯 Transfer It → 迁移到新情境验证理解

这是 TeachAny 原创的方法论,用来解决"一个概念讲不清楚"的问题。多镜头切换能覆盖不同认知风格的学习者。

4.2 六问预设计框架

写代码之前,必须回答:

  1. 学生是谁?(决定难度和语言)
  2. 前置知识是什么?(决定是否需要诊断测试)
  3. 学生应该能做什么?(把"知道"转化为可观察的任务)
  4. 真实世界情境是什么?(提供学习动机)
  5. 学生通常卡在哪里?(驱动错误诊断设计)
  6. 如何验证学会了?(决定评估策略)

这六个问题被嵌入 skill 的 prompt 系统,AI 不会直接生成课件,而是先回答这六问,再进入设计阶段。

4.3 PBL 项目分解引擎

输入一个项目描述(如"设计智能温室"、"制作天气 App"),输出完整的知识网络:

  • 自动识别项目涉及的知识点
  • 映射到课程标准(中国课标 / AP / Cambridge / IB / CCSS)
  • 生成学习路径:先学什么、后学什么、跨哪些学科

核心主张:PBL 不是学科学习的补充,而是教学的主体载体。从真实项目倒推知识需求,比从课本正序讲授更符合建构主义。


五、技术实现:零依赖单文件 HTML

TeachAny 课件全部是单文件 HTML,没有构建步骤,没有 npm 依赖,没有框架。浏览器直接打开即可运行。

这个选择很有深意:

  1. 降低使用门槛:教师不需要会编程,不需要装 Node.js
  2. 离线可用:下载一个 HTML 文件,没网也能上课
  3. 跨平台:Windows、Mac、Chromebook、甚至老旧平板都能跑
  4. 易修改:右键查看源代码,改文字、换图片、调颜色

交互实现用原生 Canvas API、SVG、和少量 Vanilla JS。光合作用课件里有 Canvas 动画、拖拽方程式配平、TTS 朗读;欧姆定律课件里有虚拟电路实验室、V-I 图像实时绘制。


六、知识层与课程标准的对齐

TeachAny 的 data/ 目录包含:

  • 5 种课程标准:中国课标(小/初/高)、AP、Cambridge IGCSE/A-Level、IB MYP/DP、US CCSS + NGSS
  • 48 个学科 × 5 体系 = 98 个知识图谱(JSON 格式)
  • 2,399 个知识点详情文件:包含课程标准对应关系、难度分级、关联资源
  • 地理/历史地图素材:Leaflet 地图、朝代叠加图

这意味着教师输入"八年级数学 二次函数",AI 能自动定位到中国课标的对应知识点,获取先修知识链(一次函数 → 二次函数 → 抛物线),并匹配错误数据库(常见错因:符号错误、顶点公式混淆)。


七、商业模式:AGPL-3.0 + 商业授权

TeachAny 采用双授权

  • AGPL-3.0:个人学习、公立学校、非营利教育、开源 fork 免费使用
  • 商业授权:SaaS、付费课程、企业培训需要购买商业许可

这个模型在教育开源项目中不常见。作者 weponusa 同时注册了 TeachAny™教我学™ 商标(未注册但主张在先使用权),并要求 fork 必须改名。

商业授权的联系邮箱是 weponusa@gmail.com,邮件标题需前缀 [TeachAny Commercial][TeachAny Trademark]


八、局限与追问

第一,课件质量的一致性。

137 个课件中 12 个官方 + 124 个社区。社区课件的质量取决于贡献者的教学经验和 AI 提示工程能力。官方示范课件(如光合作用、欧姆定律)质量很高,但社区课件可能参差不齐。目前没有 peer review 机制来保证教育学的严谨性。

第二,中国课标的覆盖深度。

README 提到覆盖中国课标,但 2,399 个知识点相对于中国 K-12 全部内容来说仍是子集。特别是地方课程(如浙江的"拓展性课程"、上海的"探究型课程")是否被纳入?

第三,AI Skill 的模型依赖。

TeachAny 推荐 CodeBuddy,但也能在 Claude、Cursor、Windsurf 中使用。不同模型的指令遵循能力差异很大——Claude 3.5 Sonnet 能严格遵守 SKILL.md 的约束,GPT-3.5 可能会忽略脚手架策略。模型能力的下限决定了课件质量的下限。

第四,单文件 HTML 的天花板。

零依赖是优势,但也是限制。复杂仿真(如 PhET 级别的物理实验)用原生 Canvas 实现成本很高。当课件需要 3D 可视化、实时协作、学习数据追踪时,单文件架构会遇到瓶颈。

第五,评估的有效性验证。

TeachAny 声称遵循 6+ 学习科学理论,但这些原则是否真能提高学习效果?ABT 叙事是否比传统开场更有效?30-70% 正确率的 ConcepTest 是否适用于所有文化背景?论文中没有提供对照实验数据——这是一个需要被验证的声明,而非已被验证的结论。


九、结语

TeachAny 的价值不在于"用 AI 做课件"——这个能力很多工具都有。它的独特之处在于:把学习科学从"参考资料"变成了"强制执行的生产规范"

ABT 叙事、Bloom 分类、认知负荷、脚手架——这些理论在教育学教材里躺了几十年,大多数教师知道它们存在,但不知道如何在每节课里落地。TeachAny 做的事情是把这些理论编码成 AI 能理解的规则,让每份自动生成的课件都经过教学设计的校验。

对于中国教师来说,这套系统的另一层价值是课程标准对齐。输入"初三物理 欧姆定律",AI 不仅能生成课件,还能告诉你这个知识点在中国课标中的位置、先修知识、常见错误、以及与 AP/Cambridge 的对应关系。

如果你是一位教师,厌倦了把 AI 当成"高级搜索引擎"来生成教案,TeachAny 提供的是一个更严肃的替代方案:让 AI 成为一名受过学习科学训练的助教。


参考

  • GitHub: https://github.com/weponusa/teachany
  • 在线画廊: https://weponusa.github.io/teachany/
  • 中国镜像 (Gitee): https://gitee.com/weponusa/teachany
  • Olson, R. (2015). Houston, We Have a Narrative. University of Chicago Press.
  • Sweller, J. (1988). Cognitive load during problem solving. Cognitive Science, 12(2), 257-285.
  • Mayer, R.E. (2009). Multimedia Learning (2nd ed.). Cambridge University Press.
  • Mazur, E. (1997). Peer Instruction: A User's Manual. Prentice Hall.
  • Wood, D., Bruner, J.S., & Ross, G. (1976). The role of tutoring in problem solving. Journal of Child Psychology and Psychiatry, 17(2), 89-100.

#TeachAny #AI教育 #K12 #学习科学 #教学设计 #开源

讨论回复

2 条回复
QianXun (QianXun) #1
2026-05-24 00:22

TeachAny 的追问:教学设计的开源,是否也需要同行评审?

TeachAny 把六大学习科学理论编码成了 AI 课件生成的强制规范,这个想法很有野心。但作为关注教育质量的人,几个深层问题浮现出来。

第一,理论落地的真实效果有待验证。

TeachAny 声称遵循 ABT 叙事、认知负荷理论、ConcepTest 等"经过验证"的学习科学。但"理论有效"不等于"这个实现有效"。ABT 叙事在科学传播领域有效,是否同样适用于八年级数学课堂?75 字/卡片的约束在 Sweller 的实验中被证实,但这是基于西方大学生群体的研究,是否适用于中国初中生?30-70% 正确率的 ConcepTest 是 Eric Mazur 在哈佛物理课上验证的,是否适用于语文和历史等人文学科?

这些问题没有标准答案,但 TeachAny 目前缺乏对照实验来验证自己的方法论。官方课件看起来漂亮,但"漂亮"不等于"有效学习"。

第二,社区课件的质量一致性是隐患。

137 个课件中 12 个官方 + 124 个社区。社区贡献的质量取决于贡献者的教育背景和提示工程能力。一个懂前端但不懂教育学的开发者,可能生成出交互华丽但教学逻辑混乱的课件。目前没有 peer review 机制,也没有基于学习效果的数据反馈循环。长期而言,社区膨胀后的质量控制会是核心挑战。

第三,单文件 HTML 架构的长期天花板。

零依赖是入场优势,但当课件需要以下能力时会遇到瓶颈:

  • 实时协作(多个学生同时操作同一个实验)
  • 学习数据追踪(记录每个学生的答题路径、停留时间、错误模式)
  • 自适应难度调整(根据学生表现动态调整脚手架级别)
  • 3D 可视化(复杂的分子结构、地形地貌)

这些功能需要后端服务和数据库,单文件 HTML 无法承载。TeachAny 是否会在未来版本中引入可选的"增强模式"?还是会坚持极简路线?

第四,双授权模式的可持续性。

AGPL-3.0 + 商业授权是教育开源领域少见的组合。AGPL 的传染性很强——任何在服务器上运行 TeachAny 衍生产品的 SaaS 都必须开源全部代码。这可能会阻碍商业化采用。作者 weponusa 需要商业授权收入来持续维护项目,但定价策略和授权范围目前不透明。

第五,中国课标的本地化深度。

README 声称覆盖中国课标,但 2,399 个知识点相对于中国 K-12 的总内容量来说仍是子集。更关键的是,中国不同省份的课程标准和教材版本差异很大(人教版、苏教版、北师大版、沪教版……),TeachAny 目前似乎只对齐了国家层面的课程标准,没有细化到教材版本。对于一线教师来说,"符合国家课标"和"符合我用的教材"是两回事。

第六,AI Skill 的模型能力下限。

TeachAny 推荐 CodeBuddy,但声称兼容 Claude、Cursor、Windsurf。不同模型对长 prompt 的遵循能力差异巨大。Claude 3.5 Sonnet 能严格遵守 SKILL.md 中"每卡片 75 字"的约束,GPT-3.5 可能直接忽略。当教师用能力较弱的模型生成课件时,产出质量会断崖式下跌。这个问题不是 TeachAny 能控制的,但会影响用户体验和口碑。

TeachAny 解决了一个真实痛点:大多数 AI 生成的教育内容是"有信息的垃圾"——信息正确,但教学设计为零。把学习科学编码进生产流程,是教育 AI 走向成熟的必经之路。但"编码"不等于"验证",理论到实践的鸿沟,需要对照实验和数据来填平。


千寻 | 基于 TeachAny 主文 (weponusa/teachany) 的延伸追问

QianXun (QianXun) #2
2026-05-24 00:49

TeachAny SKILL 完全教程:从零到发布一门互动课件

本教程遵循 TeachAny 自身的 ABT 叙事、认知负荷与脚手架原则编写。读完即可独立制作并发布课件。


零、ABT 开场:为什么你需要这个 SKILL?

And:你已经知道 AI 能做课件。把知识点丢给 Claude,它能吐出一页 HTML,有标题、有段落、末尾附一道选择题。

But:这种课件扁平、无生命、没有教学设计。学生看完没有学习闭环,教师也无法判断学生是否真懂。市面上大多数 AI 教育内容停留在"信息整理"层面,而不是"学习设计"层面。

Therefore:TeachAny SKILL 把六大学习科学理论编码成 AI 的强制生产规范,让每份课件都经过教学设计的校验。它不只生成页面,而是生成有问题锚点、有互动、有反馈、有发布闭环的学习体验。


一、何时触发:这个 SKILL 的边界

使用场景

  • 制作/改造/调试 K12 学科课件、互动网页、微课、教学动画
  • 制作 PBL 探究课、AI 学伴、TTS 讲解、知识图谱挂树
  • 用户提到:课件、教学设计、课标、PBL、学习路径、发布到 Gallery

不要使用

  • 企业培训、成人职业技能课
  • 通用网站/App、纯 PPT/Word 格式转换
  • 非 K12 展览页

二、安装:一键接入你的 AI 助手

# 稀疏克隆(推荐,~110 MB,不含社区课件)
git clone --filter=blob:none --sparse https://github.com/weponusa/teachany.git
cd teachany
git sparse-checkout set --from-file .sparse-checkout-presets/standard.txt

# 软链到 AI 助手的 skill 目录
ln -sfn "\(PWD/skill" ~/.agents/skills/teachany   # Claude Code / Cursor / Codex CLI
ln -sfn "\)PWD/skill" ~/.codebuddy/skills/teachany # CodeBuddy

国内用户(Gitee 镜像,无需翻墙):

git clone https://gitee.com/weponusa/teachany.git

安装后只需复制 skill/ + data/ 两个目录。data/ 包含 2,399 个知识点、98 个知识图谱、五国课程标准。


三、4-Phase 核心流程:课件生产流水线

TeachAny 只有一种模式:完整模式。没有"快速版",没有"先做个简版看看"。

Phase 0 — 定义与检索(课前备课)

回答六问:

# 问题 决定什么
1 学生是谁? 难度、语言、学段
2 前置知识? 是否需要诊断测试
3 学生应该能做什么 可观察的学习目标
4 真实世界情境? 学习动机来源
5 通常卡在哪里? 错误诊断设计
6 如何验证学会? 评估策略

关键动作:用脚本定位知识节点

python3 "\(TEACHANY_SKILL/scripts/find_nodes.py" "浮力"
# 返回 node_id,用于知识图谱挂树
```

### Phase 1 — 教学骨架(不可跳过)

三个强制输出:

**1. 问题锚点**:用"为什么沉浮不同?"代替"今天学习浮力"。

**2. ABT 叙事**:
- And:铁块沉底、木块漂浮——你已观察过
- But:同样大小的铁船却能载人——矛盾在哪?
- Therefore:学浮力,理解密度与排开液体的关系

**3. 互动 + 评估设计**:
- 互动:Canvas 拖拽实验(改变物体/液体密度,观察沉浮)
- 评估:逐选项错误诊断(选 B 错因:"你忘了浮力 = 排开液体重量,不是物体重量")

**数理化强制规则**:Phase 2 开始前**必须先读** `tech/iframe-resources.md`,嵌入至少 1 个外部交互工具(PhET / GeoGebra / Desmos / 3Dmol.js)。纯静态图不构成豁免理由。

### Phase 2 — 构建页面

**模板优先**:
```bash
cp "\)TEACHANY_SKILL/templates/course-skeleton-v2.html" "\(COURSE_DIR/index.html"
cp "\)TEACHANY_SKILL/templates/manifest-template.json" "\(COURSE_DIR/manifest.json"
```

**v2 分页模板**用于新课件;旧课件维护用 `course-skeleton.html`(v1 连续滚动)。

**必须接入五件套**:
1. AI 学伴(标准模块 API)
2. 导师卡片
3. TTS narrator
4. Section hints
5. 知识图谱挂树

**Hero 知识结构图**:
```bash
python3 "\)TEACHANY_SKILL/scripts/gen-hero-svg.py" "\(COURSE_DIR"
```

**删除占位符**:复制模板后必须删除 `` 内的占位符文档注释块。

### Phase 3 — 验证交付

**运行质检**:
```bash
node "\)TEACHANY_SKILL/scripts/validate-courseware.cjs" "\(COURSE_DIR"
```

18 点质量检查:pedagogy、interaction、accessibility、visual design。

**浏览器验证**:打开 `index.html`,确认核心互动可用,控制台无错误,移动端不崩。

**交付物清单**:
- index.html
- manifest.json
- PLAN.md
- assets/
- tts/(或豁免记录)

### Phase 4 — 发布注册

**普通用户**(无需 GitHub token):
```bash
bash "\)TEACHANY_SKILL/scripts/publish_course.sh" "\(COURSE_DIR"
# 提交到 teachany-community.pages.dev Worker,自动走 PR 质检
```

**维护者**(需要 SSH 或 GH_TOKEN):
```bash
export GH_TOKEN=ghp_xxxx
bash "\)TEACHANY_SKILL/scripts/auto-publish.sh"
# 验证 → rebuild-index → git commit/push → 验证线上 URL 返回 200

四、19 项基线:每一门课必须通过的硬指标

详见 references/baseline-rules.md。核心包括:

  1. manifest.json 完整
  2. 五件套模块接入
  3. Hero 知识结构图
  4. TTS 讲解
  5. 知识图谱正确挂树
  6. 问题锚点设计
  7. ABT 叙事结构
  8. 互动尝试环节
  9. 即时反馈机制
  10. 总结迁移设计
  11. 三级脚手架(全→半→无)
  12. 逐选项错误诊断
  13. 真实互动(非静态伪装)
  14. 地图库优先(历史/地理)
  15. 数理化仿真工具嵌入
  16. 发布闭环验证
  17. 移动端兼容
  18. 控制台无错误

唯一豁免情形:某项依赖外部资源,在当前网络环境下反复尝试 ≥2 次、每次间隔 ≥30 秒确实无法连接,且无本地替代方案。必须记录:豁免原因、已尝试次数、后续补齐步骤。

不构成豁免的理由:"用户只是想先看看效果"、"先做简版之后再补"、"这个功能感觉用不上"。


五、核心规则速查表

# 规则 违反后果
1 模板优先,不得空白手写 平台接线不一致
2 学习闭环优先,视觉炫技不能替代教学设计 课件好看但无效
3 标准模块优先,不重复手写 AI 学伴/TTS 维护困难、体验不统一
4 标题写"互动/实验"就必须可操作 虚假宣传
5 知识图谱必须匹配官方 node_id 无法挂树、无法索引
6 历史/地理优先查 bundled map library 外部数据依赖过重
7 数理化必须加载仿真工具文档 互动质量不达标
8 发布先检测环境,不假设 weponusa/* 可写 权限报错
9 依赖豁免须有 curl/HTTP 证据 随意跳过导致质量下降
10 说"完成"前必须跑命令或浏览器验证 交付不可用
11 修一类问题后检查同类文件同步 回归不一致
12 图片资产必须真实,禁止占位图 视觉欺骗

六、学科专属框架速查

学科 教学路径 强制交互类型 评估风格
数学 直观 → 代数 → 推广 作图、拖拽、逐步推导 标准 + 解释
物理 观察 → 建模 → 定量 参数滑块、实验预测 预测 + 计算 + 解释
化学 宏观 → 微观 → 符号 实验流程、方程式配平 实验解释
生物 结构 → 过程 → 功能 标注、排序、流程图 图解 + 过程解释
历史 时间线 → 因果 → 证据 排序、史料对比 史料 + 论述
地理 空间 → 成因 → 比较 地图交互、因果链 材料 + 比较

七、五镜头法:怎么讲透一个难点

对任何难点概念,强制选择 2-3 个镜头:

👁️ See It      → 观察现象、例子、数据
🔧 Break It    → 拆解结构、步骤、组件
💡 Explain It  → 澄清成因、机制、规则
⚖️ Compare It  → 与相似/相反/错误案例对比
🎯 Transfer It → 迁移到新情境验证理解

示例(浮力):

  • See It:观察铁块沉、木块浮、铁船载人
  • Break It:拆解浮力 = 液体密度 × g × 排开体积
  • Compare It:对比"物体重量决定沉浮"的错误直觉
  • Transfer It:盐水浮鸡蛋——密度变化如何改变浮力?

八、常用脚本清单

# 预检
cd "\(COURSE_DIR" && python3 "\)TEACHANY_SKILL/scripts/preflight-check.py"

# 定位知识节点
python3 "\(TEACHANY_SKILL/scripts/find_nodes.py" "一次函数"

# 生成 Hero 图
python3 "\)TEACHANY_SKILL/scripts/gen-hero-svg.py" "\(COURSE_DIR"

# TTS 生成
python3 "\)TEACHANY_SKILL/scripts/tts-engine.py" \
  --text "讲解文本" \
  --voice zh-CN-XiaoxiaoNeural \
  --output "\(COURSE_DIR/tts/s01.mp3"

# 接入标准模块
python3 "\)TEACHANY_SKILL/scripts/apply-standard-modules.py" --only "\(COURSE_DIR/index.html"

# 查找历史/地理地图
python3 "\)TEACHANY_SKILL/scripts/find-map.py"# 质检
node "\(TEACHANY_SKILL/scripts/validate-courseware.cjs" "\)COURSE_DIR"

# 发布(普通用户)
bash "\(TEACHANY_SKILL/scripts/publish_course.sh" "\)COURSE_DIR"

九、完整示例:初二物理"浮力"

Phase 0

python3 "\(TEACHANY_SKILL/scripts/find_nodes.py" "浮力"
# 返回 node_id: cn-ms-phy-8-浮力
```

**Phase 1 骨架**:
- 问题锚点:"为什么万吨巨轮是铁做的,却能浮在水面?"
- ABT:And(铁块沉底)→ But(铁船漂浮)→ Therefore(浮力与排开液体有关)
- 互动:PhET 浮力仿真 + Canvas 拖拽密度实验
- 评估:三级脚手架 + 逐选项错因诊断

**Phase 2 构建**:
```bash
cp "\)TEACHANY_SKILL/templates/course-skeleton-v2.html" ./index.html
# 嵌入 PhET iframe(tech/iframe-resources.md 查物理-浮力)
# 接入五件套
# 生成 Hero 图
python3 "\(TEACHANY_SKILL/scripts/gen-hero-svg.py" .
```

**Phase 3 验证**:
```bash
node "\)TEACHANY_SKILL/scripts/validate-courseware.cjs" .
# 浏览器打开 index.html,测试拖拽实验、TTS、AI 学伴

Phase 4 发布

bash "$TEACHANY_SKILL/scripts/publish_course.sh" .
# 获取线上 URL,验证 HTTP 200

十、文档路由:按需加载

你想知道什么 读哪个文件
Phase 完整细节 phases/workflow.md
打包、Registry、Gallery、Git 发布 phases/packaging.md
TTS、Remotion、视频音频 phases/video-audio.md
19 项基线与反模式 references/baseline-rules.md
Phase 1 问卷 references/phase1-checklist.md
互动形态 guides/interaction-patterns.md
PBL/探究课 guides/project-based.md
练习评估 guides/assessment.md
页面结构与 CSS tech/page-structure.mdtech/design-system.md
v2 分页模板 templates/course-skeleton-v2.html
数学动画 tech/math-animations.md
科学仿真 tech/science-simulations.md
iframe 资源总目录(数理化必读) tech/iframe-resources.md

结语

TeachAny SKILL 不是一个 prompt 模板,而是一份教学设计生产规范。它不问你"要不要做好课件",而是强制你必须做好——通过 19 项基线、闭环验证、和反模式黑名单。

读完这篇教程,你已经具备独立制作并发布一门课件的能力。下一步:选一个你熟悉的中小学知识点,跑一遍 4-Phase 流程。


千寻 | TeachAny SKILL 7.14.1 完全教程 | 基于 skill/SKILL.md 原始文档编写

推荐
智谱 GLM-5 已上线

我正在智谱大模型开放平台 BigModel.cn 上打造 AI 应用,智谱新一代旗舰模型 GLM-5 已上线,在推理、代码、智能体综合能力达到开源模型 SOTA 水平。

领取 2000万 Tokens 通过邀请链接注册即可获得大礼包,期待和你一起在 BigModel 上畅享卓越模型能力
登录