vibe-wise Skill 技能

技能简介

vibe-wise 是一款开源的 Claude Code 学习型插件，口号是「You build. AI writes.」——你负责设计与决策，AI 负责写代码。它的核心理念是把学习放在第一位：Claude 不会直接替你敲代码，而是先询问你的实现思路、带你权衡方案、解释陌生概念，由你拍板设计之后才动手编写，写完还要说明改了什么、为什么这样改。插件已通过 Anthropic Claude 目录官方审核，采用 MIT 协议开源，适合所有希望「边做边学」的开发者。无论是刚入门的准工程师、需要夯实基础的初级开发者，还是正在探索陌生技术栈的资深工程师，都能在保留决策所有权的前提下获得贴身指导。

核心能力

1. 三段式构建检查点：构建（Build）阶段先让你推理解法，设计（Design）阶段评审方案，实现（Implementation）阶段审阅具体代码变更；每次确认都可选择「Discuss」追问澄清，功能描述不会自动批准架构决策。
2. 自适应教学分层：面向初学者会解释陌生概念、绘制示意图并抛出小推理题；面向中级开发者减少基础铺垫、聚焦交互与权衡；面向资深开发者直接拷问约束条件、故障模式与设计假设。
3. 项目地图与学习笔记持久化：偏好、进度和项目结构图保存在项目内 .vibe-wise/ 目录，跨会话乃至上下文压缩后都能自动恢复学习状态，学习模式无缝续接。
4. 灵活的节奏控制：支持 Light / Normal / Frequently 三档检查点频率，可用自然语言随时要求「少一些检查点」「聚焦后端架构」「用选择题」或「暂停学习」，恢复只需再跑一次启动命令。
5. 零账号零遥测：无需注册、无后端服务、不收集任何数据，学习笔记仅随 Claude Code 的正常上下文生效，完全开源可审计。

安装配置

1. 环境要求：需要已安装 Claude Code 与 Python 3（插件用 Python 恢复学习上下文和重置笔记，无需额外第三方包）。
2. 添加市场：在 Claude Code 中运行 /plugin marketplace add nykooi1/vibe-wise。
3. 安装插件：运行 /plugin install vibe-wise@vibe-wise，再到 /plugin → Marketplaces → vibe-wise 开启自动更新（第三方市场默认关闭），之后重启 Claude Code 生效。

使用步骤

1. 在目标项目中重启 Claude Code，运行 /vibe-wise:learn 启动学习模式，按提示逐项完成偏好设置（可用 Use defaults 快速跳过）。
2. 用自然语言描述想构建的功能；若是接手已有仓库，Claude 会先通读代码并绘制一张小型系统地图。
3. 通过构建检查点与你讨论实现思路，再进入设计检查点——选择「Confirm and continue」记录设计并继续规划，或「Discuss」澄清疑点。
4. 进入实现检查点，审阅具体代码变更后选择「Implement this step」授权编写；Claude 写完代码并运行测试。
5. 阅读实现报告：Claude 会说明改了什么、关键代码如何工作、补了哪些测试及其运行结果；想从零重新开始时运行 /vibe-wise:reset（会先备份学习档案）。

适用场景

1. 转行入门实战：边做真实项目边理解架构与数据流，而不是照抄 AI 生成的代码。
2. 初级开发者进阶：通过更小粒度的推理问题逐步建立独立设计能力。
3. 资深工程师探索陌生技术栈：快速摸清不熟悉框架的关键交互与隐含约束。
4. 独立开发者技术选型：在写代码前先走完设计检查点，把方案取舍想清楚再动手。

适用人群

有志成为工程师的学习者、希望夯实设计与权衡能力的初级开发者，以及正在探索陌生语言或框架的资深工程师——只要你想边做边学并保持对决策的所有权，都适合使用。

工作原理

插件通过结构化的检查点协议约束 Claude 的行为顺序：先问思路、再评审设计、最后才实现，每一步都要求用户显式确认。Claude 会把「它主动补充的实现细节」与「你的决策」分列呈现，避免越权替你拍板。学习痕迹（偏好、笔记、项目地图）存放在项目内 .vibe-wise/ 目录，加入 .gitignore 即可与仓库隔离；重置时先备份档案再重新开始，源码与既有代码始终不受影响。

官方链接

https://github.com/nykooi1/vibe-wise