VibeWise Skill：让你边写代码边真正学会的 Claude 学习插件
总结
VibeWise 是一款 Claude Code 插件，正面回应了”Vibe Coding 让新手变废”的争议。它强制让 AI 在写代码之前先和你做设计推演，每一步都要求你确认架构、权衡和实现细节，最终由 AI 完成编码并解释变更原因——既保留 Vibe Coding 的速度，又把”决策权”完整交还给你。上线 7 天、24 小时新增 725 星、跻身 GitHub Trending Top 3，并已被 Anthropic 官方 Claude 插件目录收录。
功能与原则
核心能力是「渐进式 Checkpoint 学习流程」，由 3 个递进节点组成：
- Build Checkpoint：和 Claude 一起推理”这块要怎么拆”，用对话把模糊需求变成可执行的设计假设
- Design Checkpoint：用一张 ASCII 关系图（如
notes ← folder links → folders）确认架构选型，确认后才进入编码 - Implementation Checkpoint：Claude 才被允许写代码，并强制要求解释改了什么、为什么这么改、跑了哪些测试
设计原则是「Ownership stays with you」——AI 是执行者，设计决策、学习路径、最终拍板全部留在用户手里。它还按经验等级（Beginner / Intermediate / Advanced）和 Checkpoint 频率（Light / Normal / Frequent）做了自适应调节，资深工程师可以一句话让它”少废话直接写”。
认可度
- GitHub Stars：1,988（截至 2026-10-06，24h 新增 +725）
- Forks：96
- Open Issues：13（社区反馈活跃）
- License：MIT
- Anthropic 官方目录收录状态：已批准（”approved for Anthropic’s Claude directory”），等待公开社区市场列出
- GitHub Trending 表现：2026-10-06 日榜 Top 3，新晋 trending 阵营
链接
- GitHub 仓库：https://github.com/nykooi1/vibe-wise
- 安装市场：
/plugin marketplace add nykooi1/vibe-wise（Claude Code 内执行）
原作者
GitHub 用户 @nykooi1。仓库尚未公开作者个人背景，但从 README 和 PR 风格看是有 Claude Code 实际使用经验的开发者。仓库维护活跃，最近一次推送在 2026-10-01。
介绍
VibeWise 的产品定位非常明确：解决”Vibe Coding 让新手失去学习机会”的痛点。它不像 superpowers 那样做完整的 SDD 工作流，也不像 PonyTail 那样训练 AI”偷懒”，而是只在你让 AI 写代码这件事上加一层”必须先教我”的护栏。
具体工作方式：你让 Claude 写一个 Notion 风格的笔记 App 时，AI 会先在 Build Checkpoint 问”一条笔记能不能属于多个文件夹？删除文件夹要不要级联？”。你回答后，AI 给出 Design Checkpoint 的关系图（notes ← folder links → folders）让你确认，确认后才进入 Implementation Checkpoint 写代码。代码写完还会解释变更、跑过的测试、为什么这么改。
整个学习上下文持久化在 .vibe-wise/ 目录下，会话被压缩或中断后下次还能恢复。无需额外账号、后端或遥测——笔记直接进 Claude 的上下文，受你自己的数据策略管控。
特点
- Checkpoint 护栏：强制 AI 在三个节点停下来确认，杜绝”AI 一口气写完你只看结果”的学习断点
- 三档经验自适应：Beginner 会画图解释概念，Advanced 会主动追问设计假设和失败模式
- Checkpoint 频率可调：Light / Normal / Frequent 三档，支持”少废话直接写”的硬核模式
- 学习笔记持久化：偏好和项目映射保存在
.vibe-wise/，跨会话、跨压缩都能恢复 - 零依赖隐私友好：只用 Python 3，无需后端、无遥测、学习笔记完全本地
使用方法
前置条件：Claude Code + Python 3。
1. 添加 marketplace：
/plugin marketplace add nykooi1/vibe-wise
2. 安装插件：
/plugin install vibe-wise@vibe-wise
3. 启动学习模式：
重启 Claude Code 后在项目目录里运行：
/vibe-wise:learn
4. 让 Claude 干活：
直接对 Claude 说需求即可。Setup 会问 1-2 个偏好问题（用方向键选 / 默认跳过），然后 Claude 会按 Build → Design → Implementation 的顺序推进，每个 Checkpoint 你都可以选「1. Confirm」继续或「2. Discuss」反问。
要中途停止学习模式？说 “Pause learning”，恢复用 /vibe-wise:learn。
使用场景与人群
适用场景：
- 个人学习项目、Side Project 开荒，从需求拆解到架构选型全程留痕
- 团队新人 Onboarding 到陌生代码库，需要带着设计上下文上手
- Senior 在陌生技术栈做 PoC，想保住”决策权”但又不想从零造轮子
- 教学场景：把 Claude 当陪练，”我设计、你写、我点评”
目标用户：
- 首选：Junior 工程师、转码学习者、CS 学生——Vibe Coding 不会让他们”只会复制粘贴”
- 次选：准备技术面试、需要重温设计权衡的资深开发者
- 教育者：把 VibeWise 当 1-on-1 编程辅导替代品
输入与输出案例
案例 1：Notion 风格笔记 App 的数据建模
用户输入：
我想做一个 Notion 风格的笔记 App：用户登录后能创建/编辑私有笔记，并把笔记归类到文件夹。
VibeWise 引导的 Build Checkpoint（节选）：
✦ Build checkpoint: Deleting a shared note
“Trip ideas” 在 Travel 和 Summer 两个文件夹里。删除 Travel 时，那条笔记在 Summer 里应该怎么处理？用户：保留在 Summer；如果它没有文件夹了就放在”未分类”。
Design Checkpoint 输出：
notes ← folder links → folders
✦ Design checkpoint: Folder membership
提议：笔记只存一份，通过 links 表记录文件夹归属。删除文件夹时只删 links，不删笔记。这天然支持”一篇笔记属于多文件夹”；读取某文件夹的笔记需要查 links。
Implementation Checkpoint 输出（节选）：
- 加了 schema 迁移：每个 membership 引用一个 note + 一个 folder
- 加了 folder 删除：删除 folder + 它的 links，笔记内容保留
- 跑了”共享笔记”和”无文件夹笔记”两个 case，都通过
案例 2：陌生代码库的快速上手
用户输入：
我刚接手一个 FastAPI 后端，需要在不动现有结构的前提下加一个”用户偏好”模块。
VibeWise 行为：
- Build Checkpoint：先问”用户偏好要存哪些字段？多端共享吗？”、”是否要走已有 User 表扩展还是独立表？”
- Design Checkpoint：用
users ← user_preferences (1:N or 1:1?)关系图让你确认是否走 1:1 扩展 - Implementation Checkpoint：写完代码后主动解释”我加了 alembic 迁移、加了 Pydantic schema、跑了 pytest tests/preferences/test_user_prefs.py 7 个 case 全过”
整个过程用户始终是决策者，AI 只在确认后写代码，且必须把”为什么这么写”讲清楚——这正是 VibeWise 的核心承诺。
评论区
登录后可评论。