自学教练

SKILL.md

---
name: self-study-coach
displayName: 自学教练
description: >-
  自考/成考/职业考试的一站式自学工具。由"学习指南"和"刷题应用"两大能力组成。
  老师上传讲义和真题，自动生成可视化学习指南网页和交互式刷题网页，
  学生双击即可使用，无需安装任何软件，实现"学完就练，练完就过"的闭环。
  当用户提到"制作学习指南""生成刷题网页""把讲义做成网页""把题目做成考试页面"
  "互动教学页面""复习资料网页化""给学生做练习""生成测试工具"等内容时，触发此技能。
version: "1.0.0"
type: skill
tags: ["教育", "自学", "刷题", "学习指南", "自考", "交互式网页", "单文件HTML"]
author: duzhilei951
---

# 📚 自学教练

## 学完就练，练完就过

---

## 是什么

「自学教练」是一个专为自考/成考/职业考试教师设计的 AI 教学工具，由两个配合使用的能力组成：

- **能力一 · 学习指南**：将抽象的讲义知识点转化为可视化、交互式的单文件 HTML 学习网页
- **能力二 · 刷题应用**：将真题/模拟题转化为带四种练习模式的交互式刷题网页

两个能力组合形成完整的学习闭环：**老师上传讲义 → 生成学习指南 → 学生自学 → 生成刷题网页 → 学生练习 → 通过率提升**。

> **核心理念**：不是替代老师，而是让老师的知识以最友好的方式到达学生手中。

---

# 能力一：学习指南

## 把抽象知识变成看得见、点得开的交互式网页

### 核心设计理念

1. **拒绝密集文字**：大字号、宽行距、宽内边距，留白呼吸感
2. **沉浸式交互**：知识点不全部摊开，通过"点击、切换、展开"逐步曝光
3. **讲师友好**：标注"互动提示"，方便老师引导学生
4. **单文件交付**：所有代码封装在一个 HTML 文件中

### 5 大核心交互组件

| 组件 | 适用场景 | 效果 |
|:---|:---|:---|
| **渐变沉浸式头部** | 网页顶部标题区 | 主色+辅助色渐变，视觉冲击力强 |
| **横向标签页切换** | 步骤/原则/方法论 | 点击切换内容，带淡入动画 |
| **情景连线高亮测试** | 案例与理论匹配 | 点击场景，对应知识点放大高亮 |
| **魔法反转** | 对比错误vs正确示例 | 点击按钮，低分答案升级为满分卷面 |
| **互动自测翻牌** | 简答题/问答题复习 | 点击展开标准答案，带淡入动画 |

### 技术规格

- **Tailwind CSS (CDN)** + **FontAwesome (CDN)** + **Vanilla JS**
- 配色系统可自定义（主色/辅助色/点缀色/背景色）
- 响应式设计：桌面/平板/手机均适配
- 文件大小：约 50-100KB

### 输入输出

**输入**：任意格式的教学资料
- Markdown / Word / PDF 讲义
- 真题解析 / 复习提纲
- 纯文本知识点

**输出**：单文件 HTML 学习指南网页
- 双击即可打开
- 可通过微信/邮件/网盘分享
- 老师用记事本就能改内容

---

# 能力二：刷题应用

## 把真题变成学生愿意刷的交互式应用

### 四种练习模式

| 模式 | 交互要点 |
|:---|:---|
| **刷题模式** | 做一题即时显示答案和解析，标记对/错/未答 |
| **考试模式** | 全程隐藏答案，交卷后统一出成绩与考试报告 |
| **背题模式** | 直接展示所有题目+高亮正确答案+完整解析 |
| **错题本** | 自动汇总错题，支持"一键只刷错题" |

### 核心特性

1. **智能解析题目**：用户粘贴任意格式题目，AI 自动解析为标准结构
2. **题库数据在文件顶部**：`QUESTION_BANK` 常量置于代码第一行，老师用记事本就能改
3. **学习进度持久化**：localStorage 保存错题和成绩，支持导出/导入 JSON 跨设备迁移
4. **零外部依赖**：不引入任何 CDN，纯内联 CSS/JS，机房断网也能用
5. **精美交互反馈**：答对绿色渐变+勾动画，答错轻微抖动+红色标记+自动展开解析

### 支持的题型

| 类型 | 代码 |
|:---|:---|
| 单选题 | `single` |
| 多选题 | `multiple` |
| 判断题 | `judge` |
| 简答题 | `qa` |

### 输入输出

**输入**：任意格式的题目
- 从 Word 拷贝的题目
- 截图/笔记中的题目
- 真题 PDF 中的题目

**输出**：单文件 HTML 刷题应用
- 双击即可打开
- 学生可在机房/手机/家用电脑使用
- 学习记录可跨设备迁移

---

# 两个能力如何配合

```
老师的工作流：

  讲义/知识点              真题/模拟题
      ↓                       ↓
  学习指南能力              刷题应用能力
      ↓                       ↓
  可视化学习网页            交互式刷题网页
      ↓                       ↓
      └────── 发给学生 ──────┘
                ↓
         学完就练，练完就过
                ↓
           通过率提升
```

**学习指南**解决"看不懂"的问题：把抽象知识变成可视化、可交互的学习体验。
**刷题应用**解决"记不住"的问题：把枯燥题目变成有反馈、有成就感的练习体验。

两者组合，就是一个完整的教学闭环。

---

# 工作流程

## 场景一：老师备课

```
老师：
  "这是《马克思主义基本原理》第三章的讲义，帮我做一个学习指南网页"
  "这是近5年的真题，帮我做一个刷题网页"

AI：
  → 解析讲义，提取知识点，生成学习指南 HTML
  → 解析真题，构建题库，生成刷题应用 HTML

老师拿到两个文件，发到班级群，学生双击就能用。
```

## 场景二：学生自学

```
学生打开学习指南：
  → 看到精美的知识点页面
  → 点击标签页切换不同章节
  → 点击"查看答案"自测
  → 点击"魔法按钮"看满分答案 vs 低分答案对比

学生打开刷题网页：
  → 选择"刷题模式"逐题练习
  → 做对的题标绿，做错的自动展开解析
  → 考前切换到"考试模式"模拟真实考试
  → 考前最后看"错题本"，只刷做错的题
```

## 场景三：考试前突击

```
考前3天：
  1. 打开学习指南，快速过一遍知识点（标签页切换）
  2. 打开自测翻牌，遮住答案自问自答
  3. 打开刷题网页，进入"考试模式"模拟一次
  4. 打开错题本，只刷做错的题
  5. 进考场 ✅
```

---

## 报告输出格式

所有生成的网页都是**单文件 HTML**：

| 类型 | 技术栈 | 特点 |
|:---|:---|:---|
| 学习指南 | Tailwind CSS + FontAwesome CDN + Vanilla JS | 视觉冲击力强，交互丰富 |
| 刷题应用 | 纯内联 CSS/JS（零外部依赖） | 断网也能用，机房友好 |

共同特点：
- 单文件交付，双击即可打开
- 响应式布局，手机/电脑/平板均可使用
- 可通过微信/邮件/网盘分享
- 老师用记事本就能修改内容
- 可部署到 COS/Netlify 生成在线链接

---

## 信号灯系统

本技能不涉及信号灯（非成长跟踪类工具）。

## 数据安全

- 所有数据存储在浏览器本地（localStorage）
- 不上传任何数据到服务器
- 学习记录可导出为 JSON 文件备份
- 学生的做题数据完全在本地，保护隐私