AI 工具链、模型矩阵与工程规则配置
不同的工具面向完全不同的任务粒度。真正顺手的工作流往往是“主力 Agent 写架构与业务 + 轻量补全做微调 + 浏览器预览实时验收”。
1. 主流工具深度对比(2026 实战视角)
| 工具 | 运行形态 | 核心强项 | 局限与避坑 | 推荐人群 |
|---|---|---|---|---|
| Cursor / Windsurf | AI 原生桌面 IDE | 多文件 Diff 审核极直观,Tab 预测流畅,视觉上最容易掌控全局文件树 | 上下文过多时容易漏看终端报错;需自己配好 .cursor/rules | 需要高频看界面、微调样式的全栈与前端开发 |
| Claude Code / Codex CLI | 终端自主 Agent | 原生跑命令、跑测试、读日志、改 Git、连远程服务器排错,长链条执行力最强 | 纯文字交互,做复杂像素级 UI 样式不如配合浏览器预览直观 | 后端开发、架构重构、自动化脚本、运维部署 |
| Antigravity | Agentic IDE + 多子代理 | 内置代码工作区、浏览器子代理验证与并行任务编排,从写代码到浏览器点测一站打通 | 复杂任务建议先让它列规划(/plan)再动刀 | 希望由主代理统筹全栈与自动化验收的开发者 |
| Bolt.new / v0.dev / Lovable | 网页端零配置沙盒 | 输入一句话 30 秒生成带漂亮 UI 的可点击原型,省去环境安装 | 一旦涉及复杂后端权限、自定义数据库迁移,导出到本地 IDE 接着改更划算 | 产品经理、0 基础新手做 MVP 演示 |
2. 大模型怎么选才不浪费额度与时间?
- 重型规划 & 复杂调试(用顶级推理模型):设计数据库表结构、排查跨 4 个文件的异步竞态 Bug、做上线前安全审计时,直接上当前最强的编码旗舰(如 Claude Sonnet/Opus、GPT-5/Codex、Gemini Pro)。用弱模型修复杂 Bug,经常改 6 轮还引入 3 个新 Bug,反而更费钱。
- 高频琐碎任务(用轻量快速模型):生成 Mock 测试数据、写 CSV 解析小脚本、批量修改文案翻译、格式化 JSON,切到 Flash/Mini/Haiku 速度飞快。
- 视觉与交互还原:不要只打字说“好看一点”,把你喜欢的参考网站截图直接拖进对话框,要求模型“参考截图里的留白、卡片边框和字号层级实现”。
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:
- 浏览器自动化 / DevTools:改完页面后让 AI 自己打开页面截图、读取 Network 404/500 和 Console 报错,彻底告别“人肉截图贴报错”。
- 数据库只读连接:直接让 AI 查询真实的表结构与索引,不再把
created_at猜成createTime。 - 官方文档检索:接入最新文档源后,AI 不会再写出 2 年前早就废弃的老写法。