一套拖进 AI 对话框就能大幅提升编码体验的模板文件。 专为编程小白和 Vibe Coding 爱好者设计。
和 AI 一起写代码（Vibe Coding）的体验好不好，很大程度取决于你怎么和 AI 沟通。
小白最常见的问题不是 AI 不够聪明，而是：
- 不知道该提供什么信息给 AI
- 描述问题不够结构化，AI 猜来猜去
- 不知道可以让 AI 做哪些事情
这套工具包就是解决这个问题的——帮你把正确的信息，以正确的方式，喂给 AI。
| 文件 | 用途 | 使用场景 |
|---|---|---|
01_PROJECT_CONTEXT.md |
项目上下文模板 | 填一次，每次对话都带上，AI 秒懂你的项目 |
02_DEBUG_HELPER.md |
Debug 求助模板 | 遇到 bug 时，结构化描述问题 |
03_CODE_REVIEW.md |
代码审查指令 | 写完代码后，让 AI 做专业级审查 |
04_LEARNING_MODE.md |
教学模式指令 | 让 AI 边写代码边教你为什么这么写 |
05_PRD_TO_CODE.md |
需求转代码模板 | 脑子里有想法，不知道怎么开始 |
06_SAFE_REFACTOR.md |
安全重构指令 | 想改进代码但怕改崩 |
07_GIT_HELPER.md |
Git 急救指令 | Git 操作搞不清楚时的救命稻草 |
08_CODE_SIMPLIFIER.md |
代码简化专家 | 代码能跑但看着乱，想变得更专业优雅 |
放进项目的
.cursor/rules/目录后，Cursor AI 会在匹配场景下自动遵守这些规则。
| 文件 | 对应的外挂模板 | 自动触发条件 |
|---|---|---|
cursor-rules/code-simplifier.mdc |
08_CODE_SIMPLIFIER | 编辑代码文件时可用 |
cursor-rules/code-review.mdc |
03_CODE_REVIEW | 要求审查代码时 |
cursor-rules/safe-refactor.mdc |
06_SAFE_REFACTOR | 要求重构代码时 |
cursor-rules/teaching-mode.mdc |
04_LEARNING_MODE | 学习/教学场景时 |
cursor-rules/git-helper.mdc |
07_GIT_HELPER | Git 操作时 |
在你的项目根目录运行：
npx vibe-coding-plugins会出现交互菜单，选择安装 Cursor Rules、外挂模板、或全部安装。
bash <(curl -fsSL https://raw.githubusercontent.com/uta19/vibe-coding-plugins/main/install.sh)# 安装 Cursor Rules
mkdir -p .cursor/rules
curl -fsSL https://raw.githubusercontent.com/uta19/vibe-coding-plugins/main/cursor-rules/{code-simplifier,code-review,safe-refactor,teaching-mode,git-helper}.mdc -o '.cursor/rules/#1.mdc'在 Cursor 中：
- @ 引用（推荐）：在对话框输入
@vibe-coding/01_PROJECT_CONTEXT.md，再输入你的问题 - 拖拽：直接把文件从文件管理器拖进对话框
- 复制粘贴：打开模板，复制内容粘贴到对话框（适合需要填写的模板）
在 ChatGPT / Claude / 其他 AI 工具中：
- 打开模板文件，复制内容
- 粘贴到 AI 对话框中
- 补充你的具体问题
这是从 Anthropic 的 Skill 系统（如
code-simplifier）中借鉴的理念： 把 AI 指令"固化"成规则文件，AI 在合适的场景自动遵守，你不需要每次手动触发。
安装后（通过上面任意方式），Cursor AI 会在相关场景自动应用 .cursor/rules/ 下的规则。
外挂模板 vs Cursor Rules 该用哪个？
| 外挂模板（.md） | Cursor Rules（.mdc） | |
|---|---|---|
| 适用工具 | 所有 AI 工具 | 仅 Cursor |
| 使用方式 | 每次手动拖入/引用 | 自动生效 |
| 可定制度 | 高（可填写、可大幅修改） | 中（规则式，改动较少） |
| 推荐场景 | 需要填写信息的模板、偶尔使用 | 每次都要遵守的规范 |
建议：两者搭配使用。把"每次都要遵守的"放进 Rules，把"偶尔使用的模板"用 @ 引用。
开始新项目 → 填写 01_PROJECT_CONTEXT.md（只需要一次）
↓
每次开发 → 带上 PROJECT_CONTEXT + 你的需求
↓
遇到 bug → 带上 02_DEBUG_HELPER.md + 报错文件
↓
写完功能 → 带上 03_CODE_REVIEW.md + 代码文件
↓
想学习 → 带上 04_LEARNING_MODE.md
↓
想重构 → 带上 06_SAFE_REFACTOR.md + 代码文件
PROJECT_CONTEXT + DEBUG_HELPER= AI 了解你项目的前提下帮你修 bug（准确率翻倍）PROJECT_CONTEXT + LEARNING_MODE= AI 用你项目的实际代码教你（学得更快）PROJECT_CONTEXT + PRD_TO_CODE= AI 基于已有技术栈给你方案（更靠谱）
这套工具包受到了 Anthropic 官方 Skill 系统（如 code-simplifier）的启发。
Skill 的核心理念是：把 AI 的专业能力"打包"成可复用的指令文件。你不需要每次都想"我该怎么跟 AI 说"，直接用别人打包好的专家指令就行。
我们在此基础上做了两层扩展：
- 外挂模板（.md）— 更详细、可填写、适合所有 AI 工具，适合小白按模板操作
- Cursor Rules（.mdc）— 更精简、自动生效、Cursor 专属，适合固化为日常规范
每个文件都可以根据你的需求修改：
- 删掉不需要的部分
- 添加你项目特有的检查项
- 调整语言风格和详细程度
- Cursor Rules 的
globs字段可以限定生效的文件类型
建议把修改后的版本保存在你的项目中，作为项目级的 AI 协作规范。
vibe-coding-plugins/
├── README.md ← 你正在看的文件
├── install.sh ← 安装脚本
├── package.json ← npm 包配置
├── bin/
│ └── index.js ← npx CLI 入口
├── 01_PROJECT_CONTEXT.md ← 项目上下文（填一次反复用）
├── 02_DEBUG_HELPER.md ← Debug 求助模板
├── 03_CODE_REVIEW.md ← 代码审查指令
├── 04_LEARNING_MODE.md ← 教学模式指令
├── 05_PRD_TO_CODE.md ← 需求转代码模板
├── 06_SAFE_REFACTOR.md ← 安全重构指令
├── 07_GIT_HELPER.md ← Git 急救指令
├── 08_CODE_SIMPLIFIER.md ← 代码简化专家
└── cursor-rules/ ← Cursor Rules（自动生效版）
├── code-simplifier.mdc
├── code-review.mdc
├── safe-refactor.mdc
├── teaching-mode.mdc
└── git-helper.mdc
记住：AI 的输出质量 = 你的输入质量 × AI 的能力。这套工具包帮你提升输入质量这一半。