# Study Buddy

> AI-powered learning companion for creating personalized study plans, tracking progress, and providing feedback. Use when user wants to start learning something new, create a study plan, track learning progress, get study reminders, or receive learning feedback. Triggers include "帮我制定学习计划", "我要学XX", "追踪我的学习进度", "学习打卡", "study plan", "learn programming", "track my progress".

- Skill: `dvcrn/study-buddy` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add dvcrn/study-buddy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/study-buddy/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/study-buddy

---


# Study Buddy - 智能学习伴侣

帮你制定学习计划、追踪进度、提供反馈的 AI 学习伴侣。

## 核心功能

1. **用户档案** - 交互式收集学习目标、时间、水平、偏好
2. **学习计划** - 基于背景生成个性化阶段性计划
3. **每日打卡** - 记录学习时长和内容
4. **进度跟踪** - 统计学习天数、连续打卡、阶段评估
5. **学习报告** - 生成周期性学习总结和评级
6. **错题本** - 记录、复习、掌握错题
7. **反馈建议** - 基于数据给出个性化建议

## 命令入口

```bash
# 开始学习之旅（交互式收集背景）
python3 scripts/study-buddy.py start

# 查看今日学习任务
python3 scripts/study-buddy.py today

# 学习打卡
python3 scripts/study-buddy.py checkin "学习了Python基础语法" --duration "45分钟"

# 查看学习进度
python3 scripts/study-buddy.py progress

# 查看学习计划
python3 scripts/study-buddy.py plan

# 生成学习报告
python3 scripts/study-buddy.py report

# 错题本管理
python3 scripts/study-buddy.py wrong add "二次函数求根错误"
python3 scripts/study-buddy.py wrong list
python3 scripts/study-buddy.py wrong review "错题ID"
python3 scripts/study-buddy.py wrong master "错题ID"

# 获取反馈建议
python3 scripts/study-buddy.py feedback

# 查看学习数据存储位置
python3 scripts/study-buddy.py data
```

## 数据存储

用户数据存储在: `~/.study-buddy/`
- `profile.json` - 学习背景档案
- `plans/` - 学习计划目录
- `logs/` - 学习记录日志
- `wrong_questions/` - 错题本
- `report_YYYYMMDD.json` - 学习报告

## 使用流程

1. **初始化**: 运行 `start` 创建学习档案
2. **制定计划**: 根据背景自动生成学习计划，使用 `plan` 查看
3. **每日执行**: 使用 `today` 查看任务，`checkin` 打卡
4. **定期复盘**: 使用 `progress` 查看进展，`report` 生成报告
5. **错题管理**: 使用 `wrong` 命令管理错题本

## 目标用户

优先聚焦：**高中生及家长**

## 安全边界

- ✅ 学习计划制定、进度跟踪、打卡、反馈、学习报告
- ❌ 不提供具体学科教学内容（如数学题解答）
- ❌ 不替代老师/家长决策
- ❌ 不接外部教育平台
- ❌ 不做夸张的学习效果承诺
- ❌ 不收集敏感隐私
- ✅ 尊重用户隐私，数据本地存储
- ✅ 建议用户结合真人教师或专业课程

## 扩展计划（未来规划，非当前版本）

以下功能为后续迭代方向，当前 MVP 版本未实现：

- [ ] Feishu集成
- [ ] 可视化报告
- [ ] 智能提醒功能
- [ ] 多计划管理
- [ ] 数据导出功能
- [ ] 更智能的计划生成算法

## 参考文档

- 命令详细说明: [references/commands.md](references/commands.md)
- 开发待办清单: [references/todo.md](references/todo.md)