Skip to content

Repository files navigation

📚 Lesson Plan Skill

AI-Powered Lesson Plan Generator for Claude Code

智能教案生成器 —— 让备课从1小时缩短到5分钟

GitHub Stars GitHub Forks GitHub Issues GitHub License Claude Code MCP

English | 中文 | 日本語


🇨🇳 中文

✨ 一句话介绍

输入"帮我备一节物理课",5分钟生成完整教案、学生讲义、教学PPT、差异化版本。

🎯 解决什么问题?

痛点 解决方案
备课耗时1-2小时 ⚡ 5分钟生成完整教案
教案格式不规范 ✅ 12项质量检查清单
差异化教学难设计 🎯 自动生成ELL/SPED/Gifted策略
PPT制作麻烦 📊 自动生成MARP格式PPT
缺少教学参考 📚 8个学科完整示例

🚀 快速开始

# 1. 克隆项目
git clone https://github.com/Dragon-01-you/lesson-plan-skill.git

# 2. 复制到Claude Code技能目录
cp -r lesson-plan-skill/skills/lesson-plan ~/.claude/skills/

# 3. 在Claude Code中使用
# 输入:帮我备一节初中数学《一次函数》的课,45分钟

📖 使用示例

简单用法:

帮我备一节物理课

详细用法:

帮我备一节初中语文《背影》的课,45分钟,用探究式教学

高级用法:

帮我生成一份高中化学《质量守恒定律》的教案,包含:
- 学生讲义
- 教学PPT
- 差异化版本(ELL/SPED/Gifted)
- 评分标准

🎨 生成效果

┌─────────────────────────────────────────────────────────────┐
│                    📝 完整教案                               │
├─────────────────────────────────────────────────────────────┤
│  ✅ 教学目标(Bloom动词)    ✅ 教学过程(5E模式)           │
│  ✅ 常见误解(含纠正)       ✅ 差异化教学(3层)            │
│  ✅ 课前/课后测验            ✅ 评分标准(Rubric)           │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│                    📊 配套材料                               │
├─────────────────────────────────────────────────────────────┤
│  📄 学生讲义(可打印)       📑 教学PPT(MARP格式)          │
│  📝 练习题(分层设计)       🎯 评估工具(观察表/自评表)     │
└─────────────────────────────────────────────────────────────┘

📚 支持学科

学科 示例 状态
🔬 物理 牛顿第二定律 ✅ 完整示例
📖 语文 背影 ✅ 完整示例
📐 数学 一次函数 ✅ 完整示例
🔤 英语 一般过去时 ✅ 完整示例
🧪 化学 质量守恒定律 ✅ 完整示例
🧬 生物 细胞的结构 ✅ 完整示例
📜 历史 秦统一中国 ✅ 完整示例
🌍 地理 中国的气候 ✅ 完整示例
💻 信息技术 人工智能基础 ✅ 完整示例
🎨 更多学科 ... 🔜 持续更新

🏗️ 项目结构

lesson-plan-skill/
├── 📄 README.md                    # 项目说明
├── 📄 LICENSE                      # MIT许可证
├── 📄 .gitignore                   # Git忽略文件
│
├── 📁 skills/lesson-plan/          # 核心技能
│   ├── 📄 SKILL.md                 # 技能定义(主文件)
│   ├── 📁 references/              # 参考资料库
│   │   ├── 📄 bloom-verbs.md       # Bloom动词库
│   │   ├── 📄 teaching-methods.md  # 教学方法库
│   │   ├── 📄 differentiation-*.md # 差异化策略库
│   │   ├── 📄 complete-lesson-*.md # 完整教案示例(8个学科)
│   │   ├── 📄 design-best-practices.md # 设计最佳实践
│   │   └── 📄 ...                  # 更多参考资料
│   ├── 📁 quality/                 # 质量检查
│   │   └── 📄 checklist.md         # 12项质量清单
│   └── 📁 evals/                   # 评估测试
│       └── 📄 evals.json           # 测试用例
│
├── 📁 scripts/                     # 自动化脚本
│   ├── 📄 lesson-generator.py      # 教案生成器
│   └── 📄 quality-checker.py       # 质量检查器
│
├── 📁 docs/                        # 文档
│   ├── 📄 detailed-workflow.md     # 详细工作流程
│   ├── 📄 darwin-review-*.md       # Darwin评分记录
│   └── 📄 ...                      # 更多文档
│
└── 📁 output/                      # 生成的教案输出
    └── 📄 人工智能基础-大专-45分钟.md

🎓 设计理念

graph LR
    A[用户输入] --> B[智能推断]
    B --> C[风格学习]
    C --> D[RAG检索]
    D --> E[教案生成]
    E --> F[链式生成]
    F --> G[质量检查]
    G --> H[输出交付]
    
    style A fill:#e1f5fe
    style H fill:#c8e6c9
Loading

六步工作流:

  1. 智能推断 — 从用户输入推断年级、学科、教学方法
  2. 风格学习 — 分析教师旧教案,提取语言风格
  3. RAG检索 — 从参考资料库检索匹配的模板和示例
  4. 教案生成 — 生成完整教案(目标/过程/评估)
  5. 链式生成 — 自动生成配套材料(讲义/PPT/练习题)
  6. 质量检查 — 12项质量检查,确保达标

📊 Darwin评分系统

经过16轮迭代优化,从63分提升到93.4分:

v0.1: 63.0 分 ─────────────────────────────────┐
v0.5: 85.4 分 ───────────────────────┐         │
v1.0: 89.9 分 ─────────────┐         │         │
v1.7: 93.4 分 ──┐          │         │         │
                │          │         │         │
                ▼          ▼         ▼         ▼
              ████████████████████████████████████
              60    70    80    90    100

评分维度:

维度 权重 得分 说明
完整性 20% 97 8个学科示例、完整工作流
准确性 20% 94 Bloom动词、课程标准
实用性 15% 92 自动化脚本、模板库
差异化 15% 92 ELL/SPED/Gifted策略
风格匹配 10% 92 风格分析系统
创新性 10% 92 Steel-Manning辩论法
可扩展性 10% 92 模块化设计

🔧 自动化工具

教案生成器:

python scripts/lesson-generator.py \
  --subject 物理 \
  --grade 高一 \
  --topic "牛顿第二定律" \
  --minutes 45

质量检查器:

python scripts/quality-checker.py lesson-plan.md

输出:

==================================================
教案质量检查报告
==================================================
【完整性】9/10 ✓
【Bloom动词】6/6 层级 ✓
【差异化教学】4/4 ✓
【教学法】5/5 ✓
==================================================
总分: 96.0% — 评级: 优秀
==================================================

🎨 设计规范

配色方案(护眼配色):

用途 颜色 色值
背景 素白 #FAFAFA
主文字 近黑 #212121
次级文字 深灰 #616161
强调色 蓝色 #1976D2
成功色 绿色 #388E3C
警告色 橙色 #F57C00

排版规范:

  • 行高:1.8倍字号
  • 字间距:0.05em
  • 行宽:40个汉字(最佳阅读宽度)
  • 字体:正文宋体,标题黑体

📦 依赖

🤝 贡献

欢迎贡献!请查看 CONTRIBUTING.md

  1. Fork 本项目
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 创建 Pull Request

📄 许可证

本项目采用 MIT 许可证 — 详见 LICENSE

🙏 致谢

感谢以下开源项目的启发:

📧 联系方式


🇺🇸 English

One-Line Introduction

Type "Help me prepare a physics lesson", get a complete lesson plan, student handout, teaching PPT, and differentiated versions in 5 minutes.

Quick Start

# Clone
git clone https://github.com/Dragon-01-you/lesson-plan-skill.git

# Copy to Claude Code skills directory
cp -r lesson-plan-skill/skills/lesson-plan ~/.claude/skills/

# Use in Claude Code
# Input: Help me prepare a 45-minute lesson on Quadratic Functions for 8th grade

Features

  • ✅ Complete lesson plan with Bloom's Taxonomy objectives
  • ✅ 5E teaching model (Engage-Explore-Explain-Elaborate-Evaluate)
  • ✅ Differentiated instruction (ELL/SPED/Gifted)
  • ✅ Auto-generated student handouts and PPT
  • ✅ 12-item quality checklist
  • ✅ 8 subject examples (Physics, Chinese, Math, English, Chemistry, Biology, History, Geography)

Supported Subjects

Subject Example Status
Physics Newton's Second Law ✅ Complete
Chinese 《背影》 ✅ Complete
Math Linear Functions ✅ Complete
English Simple Past Tense ✅ Complete
Chemistry Mass Conservation ✅ Complete
Biology Cell Structure ✅ Complete
History Qin Unification ✅ Complete
Geography China's Climate ✅ Complete

🇯🇵 日本語

一行紹介

「物理の授業準備を手伝って」と入力すると、5分で完全な指導案、生徒用配布資料、授業用PPT、差別化バージョンが生成されます。

クイックスタート

# クローン
git clone https://github.com/Dragon-01-you/lesson-plan-skill.git

# Claude Codeスキルディレクトリにコピー
cp -r lesson-plan-skill/skills/lesson-plan ~/.claude/skills/

# Claude Codeで使用
# 入力:中学校数学「一次関数」の45分間の授業準備を手伝って

⭐ Star History ⭐

Star History Chart


Made with ❤️ by 星火

芯火 —— 让每个人都用上AI

About

AI-Powered Lesson Plan Generator for Claude Code | 智能教案生成器 - 5分钟生成完整教案

Topics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages