nykooi1/vibe-wise

VibeWise – 以学习为核心的 AI 引导式编程

它是什么

• 一个用于 Anthropic 的 Claude Code 和 OpenAI 的 Codex 的插件，为代码生成工作流程添加了学习模式。
• AI 首先要求你概述方法，讨论权衡，并在编写任何代码之前解释任何不熟悉的概念。
• 在你确认设计后，AI 会生成实现，然后给出关于更改内容和原因的简明报告。

适用人群

• 初级开发人员或任何希望在构建时加深理解的人。
• 需要一种结构化方式来探索新技术栈或架构的经验丰富的工程师。
• 希望保持设计决策明确并保留代码所有权的团队。

工作原理

1. 安装 – 通过 Claude Code 中的内置 Anthropic Directory 安装（/plugin install vibe-wise@anthropic-plugin-directory）或通过 GitHub 市场安装。对于 Codex，添加市场并使用 codex plugin add vibe-wise@vibe-wise 安装。
2. 开始学习会话 – 运行 /vibe-wise:learn（Claude Code）或 $vibe-wise:learn（Codex）。该插件会引导你完成一系列检查点：
   • 构建 – 你与 AI 一起推理问题（例如，笔记和文件夹应该如何关联）。
   • 设计 – AI 提出设计；你可以确认并继续或讨论。
   • 实现 – 一旦你批准，AI 就会编写代码、运行测试并报告更改。
3. 笔记与上下文 – 所有决策、图表和解释都保存在项目内隐藏的 .vibe-wise/ 文件夹中。这些笔记会在未来的会话中自动添加到 AI 的上下文中，因此助手会记住你之前的讨论。
4. 偏好设置 – 你可以设置学习级别（初级、中级、高级），并随时调整检查点频率、提问风格等。
5. 重置 / 更新 – 使用 /vibe-wise:reset 重新开始，或通过常规的 Claude Code 或 Codex 插件更新命令更新插件。

主要特性

• 在生成任何代码之前进行交互式设计讨论。
• 先解释的方法 – AI 解释概念、权衡和不熟悉的部分。
• 检查点系统 – 结构化但可选的阶段（构建、设计、实现），带有明确的“确认”或“讨论”操作。
• 持久化学习笔记 – 本地存储、版本化，并且默认被 Git 忽略。
• 零外部依赖 – 仅需要 Python 3；插件在宿主 IDE/助手中运行。

为何重要

• 将 AI 辅助编程从黑盒代码转储转变为边构建边教学的学习体验。
• 帮助开发人员保留对架构决策的所有权并理解生成的代码。
• 提供可重复使用的工作流程，可应用于任何项目，从简单脚本到全栈应用。

许可证

• 根据 MIT 许可证开源，允许商业使用、修改和再分发。