Vibe Learning

VibeLearning

边学习边编码 -人工智能编码代理的空间重复学习系统

把你的编程课程变成学习机会。VibeLearning会自动询问您正在使用的概念，帮助您真正理解在人工智能帮助下编写的代码。

目录

• 特性
• 运作原理
• 建筑
• 支持的平台
• 安装
• 用法

- 命令 - 学习模式 - 学习水平

• 常见问题解答
• 发展
• 卸载
• 许可证

特性

• 自动学习触发器：只需安装，即可在所有会话中运行
• SM-2算法：科学间隔重复（如Anki）
• 5级系统：认可→ 理解→ 比较→ 边缘案例→ 建筑
• 疲劳管理：15分钟冷却，连续跳跃后自动暂停
• 未知的未知：跟踪你不知道的概念
• 报告导出：将学习报告另存为markdown文件

运作原理

1. 请求任务 来自您的AI编码代理
2. AI会问2-3个问题 关于你的方法（高级模式）
3. 解释你的推理 -为什么采用这种方法？什么替代品？
4. AI实现 在你表现出理解之后
5. 任务后问题 强化学习（After Mode）
6. 跟踪进度 使用间隔重复以获得最佳保留

建筑

┌───────────────────────────────────────────────────────────┐
│                      VibeLearning                         │
├───────────────────────────────────────────────────────────┤
│                                                           │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐    │
│  │   OpenCode   │  │  Claude Code │  │    Cursor    │    │
│  │   (Plugin)   │  │(Plugin+Hooks)│  │    (MCP)     │    │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘    │
│         │                 │                 │             │
│         ▼                 ▼                 ▼             │
│  ┌───────────────────────────────────────────────────┐   │
│  │               MCP Server (Core)                   │   │
│  │  - SM-2 Algorithm                                 │   │
│  │  - SQLite Database                                │   │
│  │  - 14 Tools                                       │   │
│  └───────────────────────────────────────────────────┘   │
│                                                           │
└───────────────────────────────────────────────────────────┘

支持的平台

安装

开源代码

# Install VibeLearning for OpenCode
npx vibe-learning install opencode

# Restart OpenCode to apply changes

安装内容：

• MCP服务器中 ~/.config/opencode/opencode.json
• 插件： vibe-learning-opencode （通过npm自动安装）
• 命令： ~/.config/opencode/command/learn.md （用于自动补全）

- 插件处理所有 /learn 通过chat.message钩子执行命令

克劳德代码

1. 打开克劳德代码并运行 /plugins
2. 首选 市场 标签
3. 点击 +添加市场
4. 输入： 12OneTwo12/vibe-learning
5. 首选 发现 标签
6. 选择 氛围学习 然后进入 安装
7. 重新启动Claude代码

安装内容：

• MCP服务器（通过 .mcp.json)
• 钩子：会话启动、PostToolUse、停止
• 命令： /vibe-learning:learn

自动批准MCP权限（推荐）：

Claude Code每次新会话都会要求MCP工具权限。要跳过此操作，请添加到 ~/.claude/settings.json:

{
  "permissions": {
    "allow": ["mcp__vibe-learning"]
  }
}

手动安装（光标、线等）

添加到MCP配置中：

{
  "mcpServers": {
    "vibe-learning": {
      "command": "npx",
      "args": ["-y", "vibe-learning", "serve"]
    }
  }
}

检查状态

npx vibe-learning status

用法

/学习命令

OpenCode和Claude Code都支持 /learn 命令：

状态与控制

统计与报告

学习模式

VibeLearning使用两个独立的开关：

模式组合：

高级模式

模拟一位严格的高级开发人员审查您的决策：

**[VibeLearning Senior Mode]**
[Round 1/3] Why this approach?

[Round 2/3] What alternatives did you consider? Tradeoffs?

[Round 3/3] (if needed) Hint: ... What do you think?

Good thinking! [Summary]. Implementing now.

• 最少2轮 -不会跳过第一个答案的实施
• 严格求值 -只有当你表现出理解时才能进行
• 教育总结 -在实施之前提供简要说明
• 然后执行 -轮次完成后，AI继续实施

模式后

任务完成后问间隔重复问题：

**[VibeLearning]**
_Learning Question (Level 3)_
What's the difference between JWT and session-based authentication?

• SM-2调度 -根据您的答案安排的评论
• 评论链 -回答后可以提出一个适当的复习问题
• 疲劳管理 -冷却15分钟，连续跳过2次后自动暂停

学习水平

新概念从第三级开始 尊重有经验的开发人员。

回答问题

当被问及学习问题时，请自然回答。AI评估：

• 正确的 -理解得很好→ 升级可能
• 部分 -部分理解→ 保持在当前水平
• 不正确 -回答错误→ 降低级别以找到真实级别
• 跳过 -太忙了→ 稍后再问

常见问题解答

我真的需要一个插件吗？

老实说，没有。VibeLearning的大多数功能都可以通过提示或CLAUDE.md指令来实现。您可以仅通过精心设计的系统提示设置间隔重复问题。

然而，我们将其作为插件构建给那些：

• 不想为每个项目手动配置系统提示
• 比起复制粘贴CLAUDE.md指令，更喜欢一键安装
• 想要一些只有MCP/插件才能提供的额外功能：

- 持久SQLite数据库 用于跨会话跟踪进度 - SM-2算法计算 具有自动审核日程安排功能 - 跨项目统计 和报告

如果您喜欢自己配置东西，请随时从我们的 CLAUDE.md 并使其适应您的工作流程。

发展

# Clone the repository
git clone https://github.com/jeongjeong-il/vibe-learning.git
cd vibe-learning

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Lint
npm run lint

数据存储

• 数据库: ~/.vibe-learning/learning.db （SQLite）
• 报告: ~/.vibe-learning/*.md

MCP工具参考

对于直接MCP集成或自定义实现：

卸载

自动

npx vibe-learning uninstall

克劳德代码

跑 /plugins → Find 氛围学习 → Click 卸载

完成数据删除

rm -rf ~/.vibe-learning/

许可证

麻省理工学院