# 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`

## 语言

永远使用中文。