Vibe Tutor

AI 编程方法论导师 - 14 步完整方法论 + 7 大陷阱检测

🎯 解决什么问题？

用 AI 写代码很简单，但从零到一完成项目很难：

• ❌ 做了几周发现需求是假的（方向错误）
• ❌ 不停加功能，迟迟不发布（追求完美）
• ❌ 代码看不懂，遇到问题就卡住（过度依赖 AI）
• ❌ 没人用过，不知道做得对不对（闭门造车）

Vibe Tutor 帮你：

• ✅ 14 步完整流程指导（从想法到上线）
• ✅ 7 大陷阱实时检测（自动识别常见错误）
• ✅ 主动提醒（Hooks + Rules + Skills）
• ✅ 跨平台支持（Cursor、Claude Code、Codex CLI、Qwen Code）

🚀 快速开始

# 1. 安装
npm install -g vibe-tutor

# 2. 安装到 IDE
vibe-tutor install cursor    # Cursor
vibe-tutor install claude    # Claude Code
vibe-tutor install codex     # Codex CLI
vibe-tutor install qwen      # Qwen Code

# 3. 重启 IDE，输入 /tutor-init（Codex 用 $tutor-init）开始

💡 核心功能

14 步方法论

完整的开发流程指导：

阶段 1 - 规划期（1-3）：问题是什么 → 解决方案验证 → MVP 定义（2 周内能做完吗）
阶段 2 - 技术期（4-6）：前后端拆分 → 语言/框架选型 → 环境搭建 + Hello World
阶段 3 - 开发期（7-9）：AI 协作姿势 → 理解 AI 写的代码 → 核心功能测试
阶段 4 - 完善期（10-12）：代码结构 → 部署上线 → 出问题怎么办
阶段 5 - 迭代期（13-14）：版本管理 / 开源决策 → 用户反馈 → 下一步做什么

7 大陷阱检测

自动识别常见错误：

1. 追求完美 - 监控"再加一个"等关键词，防止范围蔓延
2. 过度依赖 AI - 提醒理解代码逻辑，保持主导权
3. 不重视测试 - 编辑代码后自动提醒测试，对非科班开发者尤其关键
4. 技术选型错误 - 检查技术栈是否匹配背景
5. 闭门造车 - 超过 7 天无反馈就警告
6. 开源协议问题 - 安装依赖前检查 LICENSE
7. 工具过度配置 - AI 时代新陷阱：折腾 prompt/MCP/插件配置代替写产品

10 个核心命令

全平台都用短命令 — 输 /tut 弹出列表选 tutor-init 即可，CLI 自动补全命名空间。 唯一区别：Codex 触发符是 $ 不是 /（/ 是 Codex 内置命令）。

| 命令 | 功能 | Free/Pro | |------|------|----------| | /tutor-init | 项目初始化（4 场景智能引导：白纸 / 半成品 / v2 迭代 / 重新规划）| Free + Pro | | /tutor-status | 查看项目状态和 MVP 进度（含 v2 模式）| Free + Pro | | /tutor-guide [n] | 14 步方法论详细指导 | Free + Pro | | /tutor-sync | 同步项目进度、记录反馈、v2 迭代切换 | Free + Pro | | /tutor-help | 显示所有可用命令 | Free + Pro | | /tutor-check | 健康检查 + 偏离诊断 + 评分 | Free + Pro | | /tutor-ship-check | 上线前清单 · 10 项检查 + GO/NO-GO | Free + Pro | | /tutor-insight | 跨项目复盘 · 薄弱点排行 + 技术习惯 | Pro 独有 | | /tutor-coach | 教练式周复盘 · 对话感强 | Pro 独有 | | /tutor-rescue | 卡住急救 · 诊断卡点 + 30 分钟突破动作 | Pro 独有 |

📦 平台支持

| 平台 | 触发符 | 装在哪 | |------|--------|-------| | Cursor（IDE 和 CLI 共享同份配置） | /tutor-init | ~/.cursor/plugins/local/vibe-tutor/ | | Claude Code | /tutor-init（autocomplete 补成 /vibe-tutor:tutor-init）| marketplace 安装到 ~/.claude/plugins/cache/ | | Codex CLI | $tutor-init（autocomplete 补成 $vibe-tutor:tutor-init） | ~/.codex/plugins/ + TUI 里手动点 Install | | Qwen Code | /tutor-init | extension 装到 ~/.qwen/extensions/ |

🔧 常见问题

Q: Codex CLI 装完看不到插件？
A: Codex 0.130+ 限制：installer 已预注册到 marketplace，但用户必须在 TUI 里手动 install 一次 —— 启动 codex → 输 /plugins → 找到 vibe-tutor → 点 Install plugin。之后 $tutor-init 才能用。

Q: Qwen Code 扩展未启用？
A: 运行 qwen extensions enable vibe-tutor --scope=user（安装时会自动尝试，失败时手动跑一次）

Q: 命令不可用？
A: 确认已完全重启 IDE（不是关窗口，是退出进程）。安装后必须重启才会加载新插件。

Q: 怎么更新到最新版？
A: npm update -g vibe-tutor 拉最新 CLI，然后 vibe-tutor install all 推到各 IDE。或一锅端：vibe-tutor reset -y && vibe-tutor install all。

Q: 免费版够用吗？
A: 完全够用！7 个核心 skill 全部不限频 + 完整 14 步方法论 + 7 大陷阱 hooks 实时拦截 + 4 平台支持。Pro 是给"做完 N 个项目还想持续提升"的人。

💎 Pro 版（可选）

Free 版面向"做好一个项目"，Pro 版面向"做完 N 个项目还能持续提升"：

| Pro 独有 | 解决什么问题 | |---------|----------| | /tutor-insight | 跨项目复盘 — 发现你"反复栽在第 3 步"这种单项目看不出来的模式 | | /tutor-coach | 教练式周复盘 — 像私教一样聊上周做了什么、下周怎么调整 | | /tutor-rescue | 卡住急救 — 停滞 5-7 天时给 30 分钟内能突破的具体动作 | | SaaS 控制台 | 健康度评分 / 偏离检测 / 事件日志 / 趋势分析 | | 月度小组答疑会 | 每月 1 场免费小组深度问答（限定人数） | | 1v1 付费咨询 | ¥399/小时（任何人都可预约，非 Pro 专属） |

vibe-tutor login   # 浏览器授权，含 30 天免费试用

详见 https://vibetutor.waytomaster.com/pricing

📚 学习资源

• 📖 Vibe Coding 完整教程 - 免费开源
• 🌐 官网
• 📦 NPM

🔧 卸载

# 卸载插件
vibe-tutor uninstall cursor
vibe-tutor uninstall claude
vibe-tutor uninstall codex
vibe-tutor uninstall qwen

# 卸载 CLI 工具
npm uninstall -g vibe-tutor

📄 许可证

SEE LICENSE IN LICENSE

用 AI 写代码，用方法论守护 🚀