npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

vibe-tutor

v2.4.2

Published

AI 编程方法论导师 - 基于 14 步 Vibe Coding 方法论

Readme

Vibe Tutor

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

npm version License Node.js Version

🎯 解决什么问题?

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

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

Vibe Tutor 帮你:

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

🚀 快速开始

# 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
vibe-tutor install windsurf  # Windsurf

# 3. 重启 IDE,输入 /tutor-init(Codex 用 $tutor-init,Windsurf 用 @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 个核心命令

全平台都用短命令 — 输几个字母弹出列表选 tutor-init 即可,CLI 自动补全命名空间。 触发符各平台略有差异:Cursor / Claude / Qwen 用 /,Codex 用 $(/ 是 Codex 内置命令),Windsurf 用 @。

| 命令 | 功能 | 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/,安装器调用 CLI 注册并安装 | | Qwen Code | /tutor-init | extension 装到 ~/.qwen/extensions/ | | Windsurf | @tutor-init(也可直接描述需求,skill 按 description 自动匹配) | skills 散装到 ~/.codeium/windsurf/skills/(Windsurf 没有插件概念,靠目录约定加载)|

🔧 常见问题

Q: Codex CLI 装完看不到插件?
A: 安装器会调用 codex plugin add vibe-tutor@vibe-tutor-local。若 CLI 版本过旧或自动安装失败,可在 /plugins 中安装。安装或更新后还需在 /hooks 中检查并信任插件 hooks;插件启用不等于 hooks 已被信任。

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 实时拦截 + 5 平台支持。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-tutor uninstall cursor
vibe-tutor uninstall claude
vibe-tutor uninstall codex
vibe-tutor uninstall qwen

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

开发验证(Windows / macOS)

在仓库根目录运行 npm ci、npm test。测试会先构建,再将插件安装到临时用户目录,验证五个平台的 hook 脚本、三种语言、含空格的路径和自定义 CODEX_HOME。Claude/Codex 的命令还会经过 Bash/PowerShell 执行;Windows 需要 Git for Windows。测试不注册真实 IDE 插件、不覆盖用户配置。

发布候选包沿用 dist/:运行 npm pack ./dist --pack-destination dist。在另一台机器安装该 .tgz,将 VIBE_TEST_PACKAGE_ROOT 指向安装后的 node_modules/vibe-tutor,运行 node --test test/hooks-package.test.cjs test/telemetry.test.cjs,验证同一个包的安装与 Pro 上传、失败重试、账号隔离。

真实客户端回归使用 Python 3:设置上述包路径,以及 VIBE_TEST_CODEX_BIN、VIBE_TEST_CLAUDE_BIN 为客户端可执行文件的绝对路径,运行 python test/native-hooks-check.py(macOS 使用 python3)。测试在隔离用户目录安装插件,经本机模拟模型响应验证 SessionStart、UserPromptSubmit 和 Stop;不调用生产模型。Windows 的 Codex 路径必须指向原生 codex.exe,避免个人启动脚本覆盖隔离的 CODEX_HOME。

Codex 配置跟随 CODEX_HOME(未设置时使用 ~/.codex);个人 marketplace 的插件源文件仍放在 ~/.codex/plugins/vibe-tutor。更新已安装插件后还需由对应 IDE 更新缓存并重新加载;仅构建源码不会更新已有会话。

📄 许可证

SEE LICENSE IN LICENSE


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