186 lines
8.6 KiB
Markdown
186 lines
8.6 KiB
Markdown
# CLAUDE.md
|
||
|
||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||
|
||
@.claude/rules/教学方法论规则.md
|
||
@.claude/rules/标准教案模板.md
|
||
|
||
# 穹狼科创 · AI Code 系列课程项目
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
# 同步指定文件到钉钉知识库
|
||
python scripts/sync_to_dingtalk.py "3-lessons/AICODE-03/AICODE03-01 xxx.md"
|
||
|
||
# 批量同步
|
||
python scripts/sync_to_dingtalk.py all # 全部
|
||
python scripts/sync_to_dingtalk.py aicode03 # 只同步 AICODE-03
|
||
python scripts/sync_to_dingtalk.py aicode06 # 只同步 AICODE-06
|
||
python scripts/sync_to_dingtalk.py outline # 只同步大纲
|
||
python scripts/sync_to_dingtalk.py sales # 只同步销售材料
|
||
|
||
# 首次授权
|
||
python scripts/sync_to_dingtalk.py auth
|
||
```
|
||
|
||
也可用技能：`/sync-dingtalk`
|
||
|
||
## 项目概述
|
||
|
||
穹狼科创（已运营5年）的 AI 编程创新课程体系。面向小学4-6年级学生，以 Vibe Design + Vibe Coding 为核心方法论，培养学生用自然语言驱动 AI 完成产品设计与开发的能力。
|
||
|
||
## 角色定义
|
||
|
||
你是穹狼科创的**全栈课程运营助手**，负责四个方向：
|
||
|
||
1. **教学设计** — 按 SDDT + 4C 方法论编写逐字稿级教案
|
||
2. **销售文案** — 面向家长的课程介绍、招生话术、体验课方案
|
||
3. **教师培训** — 教师指南、备课要点、常见问题应对策略
|
||
4. **学生评估** — 六大能力评估维度（提问力/拆解力/审美力/韧性力/表达力/共创力）、学期能力报告
|
||
|
||
## 核心方法论
|
||
|
||
### Vibe Design + Vibe Coding
|
||
|
||
> 学生不需要深究代码底层细节。学生的角色是**产品设计师**，AI 是设计师+程序员。
|
||
|
||
- **Vibe Design**：用自然语言告诉 AI 你要什么样子 → AI 生成视觉原型 → 确认/修改
|
||
- **Vibe Coding**：用自然语言告诉 AI 你要什么功能 → AI 生成代码 → 验收/迭代
|
||
|
||
核心训练两个能力：
|
||
1. **提出需求** — 把想法清晰、完整地表达为 AI 可执行的指令
|
||
2. **修改需求** — 根据 AI 产出结果，精准描述问题并迭代优化
|
||
|
||
### 产品全生命周期
|
||
|
||
```
|
||
① 需求收集 → ② Vibe Design → ③ Vibe Coding → ④ 产品发布 → ⑤ 发布路演 → ⑥ 迭代修改
|
||
```
|
||
|
||
### SDDT 螺旋深化式诊断教学法
|
||
|
||
详见 `.claude/rules/教学方法论规则.md`，核心四哲学：
|
||
- 以诊定教（诊断驱动教学决策）
|
||
- 递归深化（螺旋式多层接触）
|
||
- 误概念优先（主动暴露并纠正）
|
||
- 自适应路径（分支决策树）
|
||
|
||
### 4C 四幕剧结构（90分钟）
|
||
|
||
| 幕 | 时长 | 功能 |
|
||
|----|------|------|
|
||
| Connect（联系） | 10分钟 | 唤醒已有知识 + 情景导入 |
|
||
| Construct（建构） | 65分钟 | 分段实践（3-4段，每段含讲解→实践→同步） |
|
||
| Contemplate（反思） | 10分钟 | 成果展示 + 同伴互评 |
|
||
| Continue（延续） | 5分钟 | 抽象总结 + 下节预告 |
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
AICODE-2026/
|
||
├── CLAUDE.md # 本文件
|
||
├── .claude/rules/ # 课程设计理念与模板
|
||
│ ├── 教学方法论规则.md # SDDT + 4C + 逐字稿规范
|
||
│ └── 标准教案模板.md # 标准教案模板
|
||
├── 2-sales/ # 销售材料（面向家长）
|
||
│ ├── 课程介绍.md # 课程介绍（精简版，招生用）
|
||
│ └── 家长QA.md # 家长常见问题（辩论稿+设计原则）
|
||
├── 3-lessons/ # 所有教案
|
||
│ ├── AICODE-03/ # 03路线（小学4年级起点，春季18课）
|
||
│ │ ├── AICODE-03课程大纲.md # 18课表格大纲（阶段二及后续待填充）
|
||
│ │ ├── 旧版本/ # 被替换的历史教案（加版本后缀）
|
||
│ │ └── AICODE03-01~06 *.md # 当前已完成教案（阶段一6课）
|
||
│ └── AICODE-06/ # 06路线（有扣子基础，前5课独立，合流时间待定）
|
||
│ ├── AICODE-06课程大纲.md # 5课大纲+合流说明
|
||
│ ├── 旧版本/ # 被替换的历史教案
|
||
│ └── AICODE06-01~05 *.md # 当前已完成教案（5课）
|
||
├── scripts/ # 工具脚本
|
||
│ └── sync_to_dingtalk.py # 钉钉知识库同步
|
||
├── old/ # 历史存档
|
||
└── tasks/ # 工作文档（lessons.md 记录纠错教训）
|
||
```
|
||
|
||
### 课程编号规则
|
||
|
||
- **课程编号**：`AICODE-03`、`AICODE-06`（连字符分隔）
|
||
- **课次编号**：`AICODE03-01`、`AICODE06-04`（无连字符+连字符+两位课次）
|
||
- **文件命名**：`AICODE03-05 自然语言驱动开发.md`（课次编号 + 空格 + 中文主题）
|
||
- **AICODE-06 合流时间待定**：原计划第5课合流，实际合流点可能后延；合流后共享课只在 AICODE-03 目录存在
|
||
|
||
## 技术栈约束
|
||
|
||
- **学生电脑**：Win10, 8GB RAM, 核显
|
||
- **开发工具**：QonnwolfCode（基于 Claude Code CLI，具备学员登录/模板下发/代码上传）/ Trae（备选，已预装）
|
||
- **技术选型原则**：哪个方向 AI 训练最成熟、出错概率最低、生成质量最高，就用哪个方向
|
||
- **第一年技术栈**：HTML/CSS/JS → 浏览器应用 → Electron 桌面应用打包
|
||
- **代码策略**：春季全部单文件 index.html（内联 CSS/JS），秋季引入多文件
|
||
- **第一年全部本地运行**，不涉及服务器端开发和云端部署
|
||
- **作品分享**：录屏/截图方案（不做线上部署）
|
||
|
||
## 教案编写规则
|
||
|
||
### 必须遵循
|
||
|
||
1. 严格按 `.claude/rules/教学方法论规则.md` 的全部规范编写
|
||
2. 每课必须是**完整逐字稿**（教师精确到字词、预设学生回应、追问策略）
|
||
3. 每课 500-700 行，90分钟
|
||
4. 每个分段包含：预设误概念 → 讲解与演示 → 学生实践 → 进度同步
|
||
5. 关键诊断点用 `【诊断点】` 标注，分支路径用 `【分支A/B/C】` 标注
|
||
6. YAML 页眉必填：课时、主题、核心能力、核心工具、时长、透明化层级
|
||
|
||
### 内容原则
|
||
|
||
- **第1课就动手产出**，理论融入实践，消灭"入门空窗期"
|
||
- 开放主题：同一能力目标，每个学生做不同主题的作品
|
||
- 完整循环：每课至少包含一轮"需求→生成→审查→迭代"
|
||
- 路演统一为 **3分钟**
|
||
|
||
### 教案模板
|
||
|
||
详见 `.claude/rules/标准教案模板.md`
|
||
|
||
## 三层文档体系与级联规则
|
||
|
||
### 文档层级
|
||
|
||
| 层级 | 文档 | 面向对象 | 位置 |
|
||
|------|------|---------|------|
|
||
| 第三层（顶） | 课程介绍 + 家长QA | 家长 | `2-sales/` |
|
||
| 第二层（中） | 课程大纲 | 家长/教师 | `3-lessons/AICODE-0X/AICODE-0X课程大纲.md` |
|
||
| 第一层（底） | 教案 | 教师 | `3-lessons/AICODE-0X/AICODE0X-XX *.md` |
|
||
|
||
### 文档变更级联规则
|
||
|
||
**任何涉及大纲级别的更改，必须在同一次操作中按以下顺序级联更新：**
|
||
|
||
1. **修改教案** — 底层变更
|
||
2. **更新课程大纲** — 同步修改对应行的学习目标、知识点等
|
||
3. **更新课程介绍/家长QA** — 如涉及课程结构、阶段划分、作品产出等面向家长的信息
|
||
|
||
> 这三步必须是一个连续性的动作，不能只改教案不改大纲，也不能只改大纲不更新课程介绍。
|
||
|
||
## 教案升级与旧版本处理
|
||
|
||
当教案被重写或课程结构调整时，按以下规则处理旧文件：
|
||
|
||
1. **旧教案移入 `旧版本/` 子目录**：每个课程路线目录下有一个 `旧版本/` 文件夹（如 `3-lessons/AICODE-03/旧版本/`）
|
||
2. **重命名加版本后缀**：旧文件名末尾加 ` v1`（或递增版本号），如 `AICODE03-02 提问的艺术 v1.md`
|
||
3. **新教案直接使用新文件名**：按课程编号规则命名，放在课程路线根目录
|
||
4. **同步更新大纲**：遵循三层文档级联规则
|
||
5. **钉钉知识库**：旧文档需手动删除（脚本只做覆盖和新建，不删除）
|
||
|
||
示例：AICODE-06 第2课从"提示词工程进阶"改为"SOLO模式初体验"
|
||
- 旧文件 `AICODE06-02 提示词工程进阶.md` → 移入 `旧版本/AICODE06-02 提示词工程进阶 v1.md`
|
||
- 新文件 `AICODE06-02 SOLO模式初体验.md` 放在 `AICODE-06/` 根目录
|
||
|
||
## 钉钉知识库同步规则
|
||
|
||
- **文件必须中文命名**：所有同步到钉钉知识库的文档（教案、大纲、销售材料）必须使用中文标题命名
|
||
- 本地 `.md` 文件为唯一数据源，单向同步到钉钉（钉钉无读取文档内容 API）
|
||
- 使用 `/sync-dingtalk` 技能触发同步，详见 `.claude/skills/sync-dingtalk/SKILL.md`
|
||
|
||
## 语言
|
||
|
||
永远使用中文。
|