VibeCraft Vibe Coding 实战指南
工具选型 模型分工 AGENTS.md / CLAUDE.md MCP 外接工具

AI 工具链、模型矩阵与工程规则配置

不同的工具面向完全不同的任务粒度。真正顺手的工作流往往是“主力 Agent 写架构与业务 + 轻量补全做微调 + 浏览器预览实时验收”。

1. 主流工具深度对比(2026 实战视角)

工具运行形态核心强项局限与避坑推荐人群
Cursor / WindsurfAI 原生桌面 IDE多文件 Diff 审核极直观,Tab 预测流畅,视觉上最容易掌控全局文件树上下文过多时容易漏看终端报错;需自己配好 .cursor/rules需要高频看界面、微调样式的全栈与前端开发
Claude Code / Codex CLI终端自主 Agent原生跑命令、跑测试、读日志、改 Git、连远程服务器排错,长链条执行力最强纯文字交互,做复杂像素级 UI 样式不如配合浏览器预览直观后端开发、架构重构、自动化脚本、运维部署
AntigravityAgentic IDE + 多子代理内置代码工作区、浏览器子代理验证与并行任务编排,从写代码到浏览器点测一站打通复杂任务建议先让它列规划(/plan)再动刀希望由主代理统筹全栈与自动化验收的开发者
Bolt.new / v0.dev / Lovable网页端零配置沙盒输入一句话 30 秒生成带漂亮 UI 的可点击原型,省去环境安装一旦涉及复杂后端权限、自定义数据库迁移,导出到本地 IDE 接着改更划算产品经理、0 基础新手做 MVP 演示

2. 大模型怎么选才不浪费额度与时间?

3. 工程灵魂:写好 AGENTS.md / CLAUDE.md

每次新开对话,AI 都像一位失忆的高级外包工程师。把下面这份规则放在仓库根目录,等于每次开工前自动塞给它一份 10 秒钟就能读完的《团队入职手册》:

# AGENTS.md — 项目协作与质量铁律

## 技术栈约定
- 前端:React 19 + Next.js App Router + TypeScript + Tailwind CSS
- 后端:FastAPI (Python 3.12) + Pydantic v2 + SQLite (WAL 模式)
- 包管理:前端统一 pnpm,后端统一 uv / pip

## 代码质量底线
1. 拒绝重复:相同逻辑出现 2 次以上必须抽成共享 helper,不得整段复制粘贴。
2. 小函数原则:单函数不超过 50 行,优先用早返回(early return)降低嵌套。
3. 严禁硬编码密钥:所有 API Key / Secret 只能从 os.getenv 读取,并同步维护 .env.example。
4. 保留无关注释:编辑已有文件时严禁擅自删除与本次修改无关的注释或文档字符串。
5. 统一错误格式:后端接口错误统一返回 {"code": 非0错误码, "message": "可读原因"},禁止把栈追踪直接吐给前端。

## 执行与验收门禁
- 接到跨模块或模糊需求时,先列方案和 3 个关键确认问题,等确认后再改文件。
- 修改后端后,必须执行 pytest 或实际 curl 命令验证接口状态码与返回值。
- 修改前端后,必须执行 npm run build 确保无 TypeScript / 打包报错。
- 连续两次修复同一个 Bug 失败时,立即停止试探性修改,先写最小复现脚本定位根因。

4. 必须配齐的本地环境防呆清单

# .gitignore 必备模板(防止把密钥和巨型目录推上 GitHub)
.env
.env.local
.env.*.local
node_modules/
.venv/
__pycache__/
*.db
*.sqlite
dist/
.next/
*.log

5. 用好 MCP 让 AI 直接看真实世界

MCP(Model Context Protocol) 就像是给 AI 装上的 USB 扩展坞。最值得开启的三个本地 MCP:

  1. 浏览器自动化 / DevTools:改完页面后让 AI 自己打开页面截图、读取 Network 404/500 和 Console 报错,彻底告别“人肉截图贴报错”。
  2. 数据库只读连接:直接让 AI 查询真实的表结构与索引,不再把 created_at 猜成 createTime。
  3. 官方文档检索:接入最新文档源后,AI 不会再写出 2 年前早就废弃的老写法。