VibeWise核心机制解析Build、Design、Implementation三级检查点如何让你掌控AI写码的每个决策【免费下载链接】vibe-wiseA Claude Code plugin that helps you learn how to build while AI writes the code.项目地址: https://gitcode.com/gh_mirrors/vi/vibe-wiseVibeWise 是一个面向 Claude Code 的AI 写码学习插件口号是「你构建AI 书写」You build. AI writes你负责设计每一个决策AI 负责把确认过的方案写成代码。它最核心的机制是Build、Design、Implementation 三级检查点——在 AI 动代码之前每一步关键决策都要经过你的推理和确认。本文用通俗的方式拆解这套机制适合想「边构建边学会设计系统」的新手和普通用户。 VibeWise 是什么让 AI 写码但决策权留在你手里用 AI 编程最常见的尴尬是项目做出来了你却说不出它为什么这样工作。VibeWise 把常见的「vibe coding」流程反转了过来正如 README.md 的定位——学习优先保持掌控你描述目标软件要做什么AI 先问你的思路而不是直接甩出一套方案你确认设计AI 才获得写码授权写完再解释改了什么、关键代码怎么工作、测试跑得怎么样。整套行为规则写在 skills/learn/behavior.md 里核心原则一句话学习者拥有设计AI 只实现你选定的设计。学习效果和你的掌控感始终优先于构建速度。 三级检查点机制详解Build、Design、Implementation 各管什么进入学习模式后每次关键交互前你都会看到以✦开头的检查点标题。三级检查点职责清晰逐级放行检查点发生什么你能选的操作✦ Build checkpointAI 抛出推理题你会怎么解决这个问题先等你的回答直接回答卡住了可求助✦ Design checkpointAI 总结你的设计方案与权衡。确认并继续只记录设计不写代码Confirm and continue / Discuss✦ Implementation checkpointAI 列出准备修改的具体代码范围。实现这一步才授权动代码Implement this step / DiscussBuild checkpoint先想再动手这是「学习」真正发生的地方。AI 必须等你的推理不能代答也不能偷偷按它自己的方案走。比如你只给了一条功能偏好「删除文件夹时笔记也要删」AI 不会把它当成架构批准而是追问边界情况逼你真正思考。Design checkpoint确认设计但还不写代码AI 把你的方案、权衡和范围浓缩成一段总结如果它有额外建议会以Proposed additions表格单独列出Detail / Proposal / Why it matters明确区分「你的决策」和「AI 的提议」每一项都可以质疑。你点Confirm and continue只表示「这个设计我认可了」代码一行都不会动。Implementation checkpoint授权这一步才动代码这一步描述具体的编码范围新增哪些表、删文件夹的逻辑怎么写、要跑哪些测试。Implement this step才是对 AI 写码的正式授权且范围仅限这一步。两个确认项都附带Discuss选项随时提问、澄清或改方案实现会保持暂停。想直观感受它的价值可以看 docs/demos/notion-dupe.md 里「用 Discuss 追问密码盐值」的完整对话。⚡ 真实流程示例从一个「删除文件夹」的问题说起README.md 中的 Notion 风格笔记应用示例完整走了一遍三级检查点你一条笔记可以放进多个文件夹删除文件夹要删除里面的笔记。AIBuild checkpoint「Trip ideas」同时在 Travel 和 Summer 两个文件夹里删掉 Travel 后它在 Summer 里怎么办——一句话逼出了你没想到的边界问题。你保留在 Summer如果一条笔记不属于任何文件夹就让它「未归档」。AIBuild checkpoint那你打算怎么表示「笔记属于哪些文件夹」又不复制笔记本身你一张 links 表记 note_id 和 folder_id删文件夹只删链接不删笔记。AIDesign checkpoint总结方案与影响提供 Confirm and continue / Discuss。你确认后设计被记录进学习笔记。AIImplementation checkpoint说明将新增表结构、文件夹删除操作和对应测试。你选择Implement this step。AIImplementation report汇报改了什么、关键代码怎么工作、测试是否通过。注意第 7 步当「可以写码」时Implementation checkpoint 会顺带确认设计不再单独走一次 Design checkpoint——检查点是为你服务的不是走形式。️ 灵活定制检查点频率与经验级别如何适配你三级检查点不是三次强制停车VibeWise 给了两层自由度检查点频率与经验无关可单独设置频率触发时机Light只在重大决策前停下Normal默认覆盖有意义的决策Frequent更小的步骤也会停下经验级别改变教学方式不改变决策权级别教学方式Beginner解释陌生概念、画示意图、问更小的推理题Intermediate少铺垫多探讨交互与权衡Advanced直击约束、故障模式与设计假设日常对话里也可以随口调档比如「Use fewer checkpoints.」「Focus on backend architecture.」「Just implement this one.」。说Pause learning可随时暂停学习模式之后运行/vibe-wise:learn恢复。 学习状态持久化.vibe-wise 目录与三个文件VibeWise 没有后端、账号和遥测所有学习记录都是项目里.vibe-wise/目录下的本地 Markdown由 state-templates.md 定义模板profile.md——当前偏好与理解水平的快照progress.md——学习事件与待决决策Pending decision跨会话保留project-map.md——项目地图组件、主流程、数据边界、未解问题。配套的 hooks/session_start.py由 hooks/hooks.json 注册在会话启动、恢复、/clear、/compact时恢复学习上下文所以中途重启也不会丢失正在等待确认的检查点。想从零重学一个项目运行/vibe-wise:reset它会先备份三个笔记skills/reset/reset.py再重新引导源代码不受影响。 快速上手四步开启 VibeWise 学习模式准备环境安装 Claude Code 和 Python 3Python 仅用于恢复上下文与重置笔记无需额外依赖包。安装插件在 Claude Code 中逐条执行详见 README.md/plugin marketplace add nykooi1/vibe-wise然后/plugin install vibe-wisevibe-wise。重启并进入在目标项目目录重启 Claude Code运行/vibe-wise:learn跟着一次一个问题完成引导选Use defaults可跳过偏好设置。开始构建直接用大白话告诉 Claude 你想构建什么。全新项目和接手陌生仓库都支持后者会先扫描代码并画一张小的系统地图。想先体验一遍完整流程可以照着 docs/demos/notion-dupe.md 的手把手演示走。 核心文件路径速查插件行为规则检查点定义skills/learn/behavior.md学习技能入口skills/learn/SKILL.md新手引导流程skills/learn/onboarding.md本地状态模板skills/learn/state-templates.md会话恢复 Hookhooks/session_start.py开发说明与验证记录docs/development.md演示对话示例docs/demos/notion-dupe.md总结VibeWise 的三级检查点本质上是把「AI 写码」拆成了三道你说了算的关卡Build 逼你先思考Design 锁住你的方案Implementation 限定授权范围。它不替你回答工程问题而是把推理过程留给你——项目是 AI 写的但系统是怎么长出来的你心里清楚。【免费下载链接】vibe-wiseA Claude Code plugin that helps you learn how to build while AI writes the code.项目地址: https://gitcode.com/gh_mirrors/vi/vibe-wise创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考