# 专属家教

**Repository Path**: billyjack/exclusive-tutoring

## Basic Information

- **Project Name**: 专属家教
- **Description**: 🚀 一行代码快速创建针对特定学习主题的个人专属 AI 学习导师，结合西蒙学习法、启发式教学/苏格拉底式问答、 费曼学习法，以融会贯通和输出为目的快速学习中英文新知识。
- **Primary Language**: Shell
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-02-21
- **Last Updated**: 2026-04-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 专属家教/AI Learning Tutor 🎓

> 🚀 一键创建你的 AI 学习导师 - 基于中西学习法，快速掌握新知识

[![快速开始](https://img.shields.io/badge/快速开始-2步即可-brightgreen)](./快速开始.md)
[![支持平台](https://img.shields.io/badge/支持平台-任何LLM环境-blue)](#)
[![学习方法](https://img.shields.io/badge/学习方法-费曼×西蒙-orange)](#)

## ✨ 核心特性

- 🎯 **一键创建** - 2步完成配置，无需环境变量
- 🤖 **AI 导师** - 费曼学习法 + 启发式问答（苏格拉底 × 孔子）
- 📚 **方法科学** - 费曼学习法 × 西蒙学习法
- 🔄 **以教为学** - 通过教授他人深度理解知识
- 🌍 **跨平台** - 支持任何 LLM 环境（如 Claude、Trae、CodeBuddy、Qoder 等）
- 🌐 **双语支持** - 可创建中文或全英文学习环境（`--en` 参数）
- 🚀 **开箱即用** - 克隆到任意位置即可使用

## 🎯 这个工具能帮你做什么？

快速创建一个 AI 学习助手，它会：
- 📖 **引导学习** - 用简单语言解释复杂概念
- ❓ **苏格拉底问答** - 通过提问帮你深度理解
- 📊 **跟踪进度** - 记录学习路径和知识盲区
- 👨‍🏫 **准备教学** - 帮你整理教学材料
- ✍️ **输出文章** - 将学习成果转化为公众号文章

## 🌐 支持的平台

| 平台 | 支持方式 | 配置文件 |
|------|---------|---------|
| **Claude** (网页版/App) | ✅ 完全支持 | `CLAUDE.md` |
| **Trae** | ✅ 完全支持 | `.trae/` 目录 |
| **CodeBuddy** | ✅ 完全支持 | `.codebuddy/` 目录 |
| **Qoder** | ✅ 完全支持 | `.qoder/` 目录 |
| **Cursor** | ✅ 可适配使用 | 可配置 |
| **其他 LLM IDE** | ✅ 可适配使用 | 可配置 |

> **核心**：只要你的环境支持 LLM（大语言模型），比如 Qoder 等任何平台，就可以使用本项目！

### 如何在不同平台使用

#### Claude (网页版/App)

**方式1：自定义指令**
1. 打开 Claude 设置
2. 找到 "Custom Instructions" 
3. 复制 `CLAUDE.md` 的内容
4. 开始对话："我想学习 [主题]"

**方式2：项目特定配置**
1. 在学习项目文件夹中放置 `CLAUDE.md`
2. Claude 会自动读取配置

#### Trae IDE

```bash
# 创建项目
./scripts/init-learning-project.sh 我的学习主题

# 在 Trae 中打开项目文件夹
# 开始对话："我想学习 [主题]"
```

#### CodeBuddy

```bash
# 创建项目
./scripts/init-codebuddy-project.sh 我的学习主题

# 在 CodeBuddy 中打开项目文件夹
# 开始对话："我想学习 [主题]"
```

#### Cursor / 其他 LLM IDE

1. 创建项目（使用任意初始化脚本）
2. 根据你的 IDE 配置规则，调整配置文件
3. 使用 Skills 中的指导原则开始学习

> **提示**：Skills 是通用的，核心是费曼学习法和苏格拉底问答，可在任何 LLM 环境中使用！

## 目录结构

```
你的克隆位置/                          # 例如：~/Documents/Tools/
├── skills/                           # 【全局】可复用的 Skill 模板
│   ├── learning-session/             # 会话协调器（顶层 Skill）
│   ├── learning-guide/               # 学习引导 Skill（费曼学习法）
│   ├── learning-tracker/             # 学习进度跟踪 Skill（双层架构）
│   ├── simon-learning/               # 西蒙学习法 Skill（6个月掌握理论）
│   └── knowledge-sharing-writer/     # 知识变现 Skill（公众号文章等）
├── scripts/                          # 管理脚本
│   ├── init-learning-project.sh      # 一键初始化学习项目
│   ├── copy-skill.sh                # 复制 Skill 到项目
│   └── list-skills.sh               # 列出可用 Skills
├── CLAUDE.md                         # Claude 学习导师配置
├── CLAUDE使用指南.md
├── CodeBuddy配置指南.md
├── README.md                         # 本文件
├── Trae项目创建指南.md              # Trae 项目创建指南
└── 快速开始.md                      # 安装和快速开始指南
```

> **核心架构**：Skills 全局共享 + 双层 tracker（项目专属进度 + 全局汇总索引）。可在任意 LLM IDE 平台部署，跨平台无缝迁移。

---

## 快速开始（2步即可！）

### 1. Clone 仓库（克隆到任意位置）

```bash
# 推荐：克隆到 Documents 目录
git clone https://gitee.com/billyjack/exclusive-tutoring.git ~/Documents/Tools

# 或者：任意你喜欢的位置
git clone https://gitee.com/billyjack/exclusive-tutoring.git ~/my-tools
```

### 2. 添加执行权限

```bash
chmod +x ~/Documents/Tools/scripts/*.sh
```

> **🎉 脚本会自动检测自身位置，无需配置环境变量！**

---

## 使用方式

### 方式 1：直接使用完整路径（推荐）

```bash
# 创建学习项目
~/Documents/Tools/scripts/init-learning-project.sh ai-study

# 指定主题
~/Documents/Tools/scripts/init-learning-project.sh ai-study --topic '深度学习'

# 指定保存位置
~/Documents/Tools/scripts/init-learning-project.sh python-learning ~/Documents/Study/

# 英文项目
~/Documents/Tools/scripts/init-learning-project.sh english-course --en
```

### 方式 2：配置 PATH（可选，更方便）

将以下内容添加到 `~/.zshrc`：

```bash
# 将 scripts 添加到 PATH（替换为你的实际路径）
export PATH="$HOME/Documents/Tools/scripts:$PATH"
```

然后执行：
```bash
source ~/.zshrc
```

配置后可以在任意位置使用：
```bash
# 创建学习项目
init-learning-project.sh ai-study

# 查看帮助
init-learning-project.sh --help
```

---

## 参数说明

| 参数 | 说明 | 示例 |
|------|------|------|
| `project-name` | 项目名称（必填） | `'ai-study'` |
| `project-path` | 项目路径（可选，默认 ~/Documents/Projects/） | `'/Users/xxx/Study/'` |
| `--topic` | 学习主题（可选，默认使用项目名称） | `--topic '深度学习'` |
| `--en` | 使用英文版（可选，默认中文） | `--en` |

---

## 项目文件夹结构

### 不提供 `--topic`
```
~/Documents/Projects/
└── ai-study/                    # 项目名称作为文件夹
    ├── .trae/                   # Trae 项目
    ├── .codebuddy/              # 或 CodeBuddy 项目
    ├── README.md
    └── ...
```

### 提供 `--topic`
```
~/Documents/Projects/
└── ai-study/                    # 项目名称
    └── 深度学习/                # 主题作为子文件夹（自动创建）
        ├── .trae/
        ├── README.md
        └── ...
```

---

## 可用 Skills

### learning-session（会话协调器）
- **功能**：顶层协调者，管理会话生命周期和 hooks
- **特点**：会话开始加载 tracker、会话结束更新 tracker + 写 notes
- **触发**：自动执行，无需手动调用

### learning-guide（学习引导者）
- **功能**：基于费曼学习法，引导学习过程
- **方法**：费曼技巧、苏格拉底问答、举一反三
- **触发**："我想学习 [主题]"

### learning-tracker（学习进度跟踪器）
- **功能**：双层进度视图（项目专属 + 全局汇总）
- **特点**：
  - 项目内 `progress/tracker.md` 快速查看
  - 全局 `skills/learning-tracker/tracker.md` 跨项目总览
- **触发**："记录今天的学习"、"更新学习进度"

### simon-learning（西蒙学习法）
- **功能**：基于赫伯特·西蒙的6个月掌握理论
- **特点**：
  - 制定6个月高强度学习计划
  - 提供核心书籍推荐（涵盖计算机、经济学、心理学、政治学、社会学、文学等领域）
  - 设计刻意练习体系
- **触发**："我想用西蒙学习法学习 [主题]"

### knowledge-sharing-writer（知识变现）
- **功能**：将学习成果转化为文章、PPT、社交媒体内容
- **特点**：支持多平台发布（公众号、知乎、B站等）
- **触发**："写一篇关于 [主题] 的公众号文章"

---

## 跨平台说明

所有 Skills 和脚本**统一架构**，可在任意 LLM IDE 平台使用：

| 平台 | 配置目录 | 初始化脚本 |
|------|---------|-----------|
| **Trae** | `.trae/` | `init-learning-project.sh` |
| **CodeBuddy** | `.codebuddy/` | 同上脚本 |
| **其他 IDE** | 根据平台调整 | 同上脚本 |

> **核心**：Skills 是平台无关的，脚本会自动适配。只要 IDE 支持 LLM，就能使用本学习系统。

---

## 添加新的 Skill

1. 在 `skills/` 目录创建新目录（如 `my-new-skill/`）
2. 添加 `SKILL.md` 文件，包含：
   - Description（功能描述）
   - Invocation（调用时机）
   - Workflow（工作流程）
   - Core Principles（核心原则）
3. 更新 `init-learning-project.sh` 中的 `SKILLS_LIST` 数组以自动安装

---

## 开始使用

创建项目后：
```
"我想学习 [主题]"
```

AI 会自动调用相应的 Skill 开始引导学习。

---

## 维护

```bash
# 更新到最新版本
cd ~/Documents/Tools  # 或你的克隆位置
git pull

# 添加执行权限
chmod +x scripts/*.sh

# 版本控制
git add .
git commit -m "更新说明"
git push
```

---

## 故障排除

### 命令找不到（未配置 PATH）

**解决方案1：使用完整路径**
```bash
~/Documents/Tools/scripts/init-learning-project.sh my-project
```

**解决方案2：配置 PATH**
```bash
echo 'export PATH="$HOME/Documents/Tools/scripts:$PATH"' >> ~/.zshrc
source ~/.zshrc
```

### 权限问题
```bash
chmod +x ~/Documents/Tools/scripts/*.sh
```

### Skill 没有自动触发
直接说：
```
"使用 learning-guide"
或
"调用 simon-learning"
或
"调用 knowledge-sharing-writer"
```

---

## 两种安装方式对比

| 特性 | 直接使用（推荐） | 配置 PATH |
|------|----------------|----------|
| 安装步骤 | 2步 | 3步 |
| 使用方式 | 完整路径 | 直接命令 |
| 灵活性 | 可克隆到任意位置 | 可克隆到任意位置 |
| 适用场景 | 偶尔使用 | 频繁使用 |

---

**提示**：
- ✅ **可克隆到任意位置**
- ✅ **无需配置环境变量**
- ✅ **脚本自动检测位置**
- ✅ **开箱即用**