weponusa/teachany

🎓 TeachAny（教我学）

把任意知识点变成一节能讲、能玩、能练的互动课。 中文为主、英文辅助，面向中国教师、家长和学生；也支持国际课程与英文学习场景。 Turn any K-12 topic into an interactive lesson with explanation, practice, feedback, and learning paths.

在线课件库 Gallery · 快速开始 Quick Start · 安装指南 Getting Started · 方法论 Methodology · 商标政策 Trademark · 参与共建 Contributing

⚖️ 商标说明 · Trademark Notice：TeachAny™ 和 教我学™ 是项目作者持续公开使用的项目标识，自 2026-04-07 起使用。标识尚未注册，但作者保留在先使用权益。Fork 或二次发行请更名；完整规则见 TRADEMARK.md。

---

🚀 快速开始 · Quick Start

⚡ 推荐方式：稀疏克隆（标准预设） · Sparse Clone

标准预设包含 TeachAny Skill 核心、知识树、课标知识点数据，以及地理/历史地图资产（工作目录约 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

# 将 TeachAny Skill 连接到你的 AI 工具
ln -sfn "$PWD/teachany" ~/.codebuddy/skills/teachany   # CodeBuddy
ln -sfn "$PWD/teachany" ~/.agents/skills/teachany      # Claude Code / Cursor / Codex CLI

💡 为什么推荐稀疏克隆？ 完整仓库约 1.6 GB，包含 420+ 社区课件及音视频资产。标准预设已经足够用于制作课件，不需要下载全部社区课件。

备选方式：完整克隆（适合贡献者） · Full Clone

git clone https://github.com/weponusa/teachany.git
cd teachany
ln -sfn "$PWD/teachany" ~/.codebuddy/skills/teachany

🌐 不克隆也能用：所有课件都已发布到 **https://www.teachany.cn/**，可直接在线浏览。

🧠 AI 工具用户：见 teachany/SKILL.md。本仓库仅含 Skill；完整网站在 teachany-courseware → www.teachany.cn。

国内用户 🇨🇳 · TeachAny.cn

国内访问请直接使用正式站点：

https://www.teachany.cn/

详细安装指南：

• 🌐 国际用户：See Getting Started
• 🇨🇳 国内用户：查看 一键安装指南（推荐）

包含内容 · What’s included：覆盖数学、物理、化学、生物、历史、地理、语文、英语、科学、信息技术等 14+ 学科；420+ 互动课件；支持中国课标、IB、Cambridge、AP 等多套课程体系。

---

🤔 我们要解决什么问题 · The Problem

现在很多 AI 生成的教学内容，看起来往往是这样：

📝 Here are 5 key points about quadratic functions...
📋 Quiz: What is the vertex of y = x² + 2x + 1?
   A) (1, 0)   B) (-1, 0)   C) (0, 1)   D) (-1, 1)

问题不在“内容不够多”，而在“没有教学设计”。 学生看到的是一堵文字墙，最后再配几道选择题；缺少问题情境、认知脚手架、错误诊断和完整学习闭环。

✨ TeachAny 怎么做 · The TeachAny Approach

TeachAny 不是提示词模板，而是一套完整的 AI 课件教学设计系统。它把 6+ 学习科学理论嵌入到课件结构里，让 AI 生成的不只是“内容”，而是一节真正可学、可练、可反馈的课：

🧠 基于学习科学 · Built on Learning Science

---

🖼️ 在线课件库 · Live Gallery

所有课件都可以直接在线打开体验：TeachAny 课件库。

官方精选课件 · Featured official courseware:

420+ 课件，覆盖 14+ 学科，包含官方示范课与社区共创课件。课件以 HTML 形式发布，浏览器打开即可学习，也方便教师二次改造。

---

🚀 使用方式 · How to Use

方式一：作为 AI Skill 使用（推荐） · AI Skill

TeachAny 可以作为 AI 编程助手的 Skill 使用（推荐 WorkBuddy，也兼容 CodeBuddy、Cursor、Claude Code 等）：

1. 按上文稀疏克隆安装 TeachAny，并把 skill/ 软链接到你的 AI 工具 Skill 目录。
2. 开始对话，例如：

   为“光合作用”（七年级生物）做一个互动课件。
   Create an interactive courseware for "Photosynthesis" (Grade 7 Biology).
   

3. AI 会按 TeachAny 的教学设计流程，生成完整的互动 HTML 课件。

说明：Skill 安装只需要 skill/ + data/。社区课件已在线发布在 TeachAny 课件库，不需要全部打包进 Skill。

说明：从 v6.0 起，TeachAny 基础 Skill 已内置验证、打包和社区分享流程，不再需要单独的 admin skill 或 GITHUB_TOKEN。

方式二：浏览并改造 · Browse and Remix

1. 打开 在线课件库
2. 选择一个接近你教学目标的课件
3. 查看源码或克隆仓库，改成自己的课堂版本

---

📖 它如何工作 · How It Works

TeachAny 采用结构化的 4 阶段流程，从教学目标出发，逐步生成可交互、可评估、可发布的课件：

阶段 0：定义目标        阶段 1：教学设计        阶段 2：学科适配        阶段 3：构建发布
Phase 0: Define      Phase 1: Design      Phase 2: Adapt      Phase 3: Build
┌─────────────┐    ┌──────────────────┐    ┌──────────────────┐    ┌────────────────┐
│ 回答 6 个问题 │    │ ABT 叙事结构       │    │ 学科专属框架       │    │ HTML/CSS/JS    │
│ 学生/目标/场景│───▶│ 内容审查          │───▶│ 五镜头方法         │───▶│ 互动课件        │
│ 难点/验证方式 │    │ 先备知识链        │    │ 脚手架设计        │    │ 练习与反馈      │
└─────────────┘    └──────────────────┘    └──────────────────┘    └────────────────┘

课前 6 问 · The 6 Pre-Design Questions

写代码之前，TeachAny 会先把教学问题问清楚：

学科专属框架 · Subject-Specific Frameworks

TeachAny 不用一套模板打天下。不同学科有不同的讲解方式、互动形态和评价方式：

五镜头方法 · The Five-Lens Method

遇到难概念时，从下面 5 个角度中选 2-3 个来设计讲解：

👁️ 看见它 See It      → 观察现象、例子和数据
🔧 拆开它 Break It    → 拆结构、步骤和组成部分
💡 解释它 Explain It  → 讲清原因、机制和规则
⚖️ 比较它 Compare It  → 和相似/相反/错误例子对照
🎯 迁移它 Transfer It → 换个情境应用，验证是否真懂

🧩 PBL 项目拆解 · Project Decomposition

TeachAny 可以把任意 PBL 项目目标，自动拆成系统化的知识网络：

• 输入：一个项目描述，例如“设计智能温室”“制作天气 App”
• 输出：映射到课标的完整学习路径，支持中国课标、AP、Cambridge、IB、US CCSS 等体系
• 理念：PBL 不只是学科学习的补充，而可以成为教学主体，用真实项目反向组织知识学习

这样教师可以从真实项目出发，倒推学生需要补哪些知识节点、按什么顺序学、涉及哪些学科。

---

🏗️ 项目结构 · Project Structure

teachany/
├── README.md                    # English README (this file)
├── README_CN.md                 # Chinese README
├── LICENSE                      # Dual License (AGPL-3.0 + Commercial)
├── CONTRIBUTING.md              # Contribution guide (bilingual)
├── CHANGELOG.md                 # Version history
├── index.html                   # Gallery homepage (dynamically loads courseware)
├── path.html                    # Learning Path system (D3.js knowledge graph)
├── tree.html                    # Knowledge tree browser
├── courseware-registry.json     # 📋 Courseware registry (metadata index)
│
├── skill/                       # 🧠 TeachAny Skill (AI Prompt System)
│   ├── SKILL.md                 # Entry point (157 lines, loads modules on demand)
│   ├── README.md                # Skill installation guide
│   ├── RULES.md                 # Quality rules and constraints
│   ├── INSTALL.md               # Detailed install instructions
│   ├── guides/                  # Subject-specific guides
│   ├── phases/                  # 4-phase workflow definitions
│   ├── references/              # Heavy reference chapters (loaded on demand)
│   ├── scripts/                 # Skill-internal scripts (validate, pack, TTS, etc.)
│   ├── templates/               # Courseware starter templates
│   └── tech/                    # Technical implementation specs
│
├── data/                        # 📚 Knowledge Layer (~53 MB)
│   ├── trees/                   # Knowledge trees (5 curriculum systems × 48 subjects = 98 JSON files)
│   │   ├── cn/                  # 中国课标 (elementary / middle / high)
│   │   ├── ap/                  # AP (US Advanced Placement)
│   │   ├── cambridge/           # Cambridge IGCSE / A-Level
│   │   ├── ib/                  # IB (MYP / DP)
│   │   └── us/                  # US CCSS + NGSS
│   ├── kp/                      # 2,399 knowledge-point detail files (curriculum_points, difficulty, resources)
│   ├── geography/               # Geography map assets (world/China/terrain)
│   ├── history/                 # Historical dynasty map overlays
│   ├── curricula.json           # Curriculum system registry (v1.4)
│   ├── nodes-metadata.json      # Node metadata index
│   ├── node-index.json          # Fast node lookup index
│   └── source-mapping.json      # KP ↔ textbook page mapping
│
├── community/                   # 🌐 Community courseware (412 courses, ~238 MB)
│   └── /            # Each course: index.html + manifest.json [+ audio/video]
│
├── scripts/                     # 🔧 Build & maintenance scripts
│   ├── validate-courseware.cjs  # 18-point quality validator
│   ├── validate-courseware.py   # Python validator (media checks)
│   ├── pack-courseware.cjs      # Courseware packaging
│   ├── publish-courseware.cjs   # Publish to registry
│   ├── batch-validate.cjs      # Batch validation runner
│   ├── knowledge_layer.py      # Knowledge layer audit CLI
│   ├── learning-path.js        # Path system runtime
│   ├── pbl-path.js             # PBL decomposition runtime
│   └── ...                     # 130+ utility scripts
│
├── references/                  # 📖 Modular documentation chapters
│   ├── media-pipeline.md
│   ├── packaging-distribution.md
│   ├── technical-implementation.md
│   └── workflow-development.md
│
├── docs/
│   ├── methodology.md           # Deep dive into learning theories
│   ├── getting-started.md       # Step-by-step guide
│   ├── design-system.md         # Visual design specification
│   └── subject-guides/          # Per-subject usage guides
│
├── assets/                      # Logo, icons, shared assets
├── styles/                      # Shared CSS
├── gallery/                     # Gallery sub-page
├── pages/                       # Cloudflare Pages deployment config
│
├── .sparse-checkout-presets/    # Sparse checkout presets (standard / full)
│
└── .github/
    ├── ISSUE_TEMPLATE/
    └── workflows/

---

🎨 设计系统 · Design System

All TeachAny courseware shares a consistent visual language:

/* Core color tokens */
--bg: #0f172a;           /* Primary background */
--card: rgba(30,41,59,0.7);  /* Glassmorphism cards */
--primary: #3b82f6;      /* Blue: main accent */
--secondary: #8b5cf6;    /* Purple: secondary accent */
--accent: #f59e0b;       /* Yellow: highlights */
--success: #10b981;      /* Green: correct */
--danger: #ef4444;       /* Red: incorrect */

• Typography: 16px body, 1.7-1.8 line-height
• Cards: Semi-transparent glassmorphism (backdrop-filter: blur(10px)), 16px border-radius
• Grid: repeat(auto-fit, minmax(300px, 1fr)) responsive grid
• Formulas: Times New Roman, accent color

---

📚 文档入口 · Documentation

---

🤝 参与共建 · Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Ways to contribute:

• 🎓 Create a new course — Pick any K-12 topic and build an interactive courseware
• 📚 Expand the Knowledge Layer — Add knowledge graphs, error databases, and exercise banks for any subject (see data/schema.md)
• 🌐 Translate — Help translate the Skill or documentation to your language
• 🐛 Report issues — Found a pedagogical error or UI bug? Let us know
• 📝 Improve docs — Better examples, clearer explanations, more subject guides
• 🎨 Design components — Reusable quiz engines, interactive widgets, visualizations

---

💡 原创贡献 · Original Contributions

The following frameworks and methods are original creations of the TeachAny project:

The TeachAny Skill prompt and all associated documentation are released under a dual license: AGPL-3.0 for non-commercial use (personal, academic, non-profit education), and a Commercial License for commercial deployment. See COMMERCIAL-LICENSE.md.

---

📄 学术参考 · Academic References

TeachAny’s methodology is grounded in peer-reviewed learning science:

---

📜 授权与商标 · License & Trademark

Dual License:

• 🟢 Non-commercial use (personal, public schools, academic research, open-source forks): free under AGPL-3.0 — see license.html for an illustrated summary.
• 💰 Commercial use (SaaS, paid courses, enterprise training): requires a commercial license — see COMMERCIAL-LICENSE.md or commercial-license.html.

Trademark: TeachAny™ and 教我学™ are unregistered but actively-asserted trademarks under prior-use rights. Forks must rename; see docs/TRADEMARK.md for the full policy.

Contact: [email protected] (prefix subject with [TeachAny Commercial] or [TeachAny Trademark]).

---

Built with ❤️ for teachers and students everywhere. If TeachAny helps you create better learning experiences, give us a ⭐