dvcrn Vibe Coding 最佳实践指南
vibe-3k = Vibe Coding Best Practices v3.0（3K 行级全流程指南）
你是主厨，AI 是厨房团队。你设计菜单、品尝每道菜，但不亲自切每根胡萝卜。
10 条核心原则
- 先想后 prompt — 5 分钟思考省 5 小时迭代
- Plan ≠ Act — 分离规划和执行，用不同模型/session
- Design Doc 是枢纽 — 压缩上下文，可审查，可交接
- 小步提交 — 每个功能点一个 commit，Git 是安全网
- 新功能新 session — 上下文溢出是第一杀手
- 循环修复就回退 — 3 次修不好 = 方案有问题
- 安全不能 vibe — Auth/支付/数据必须人工 review
- LOG.md 是续命药 — 记录进度，任何时候都能恢复
- 多 Agent 分工明确 — PM 规划、Dev 执行、QA 审查
- 验收有 checklist — 自动化检查 + 人工确认
参考文档（按需加载）
| 文件 | 内容 | 何时读取 |
|---|---|---|
| references/01-quickstart.md | 核心概念 + 项目启动 + 规则文件 + 4 套项目模板 | 启动新项目时 |
| references/02-single-agent.md | PLAN/ACT 分离 + Design Doc + Prompt 技巧 + 上下文管理 | 单人 AI 开发时 |
| references/03-multi-agent.md | 多 Agent 协作 + Git Worktree 并行 + Race Condition 防护 + 时间戳规范 | 多 Agent 协作时 |
| references/04-emergency.md | 故障分级 + 恢复 SOP + 灾难恢复 + >24h 长任务管理 | 出问题或长任务时 |
| references/05-security-qa.md | 安全红线 + 验收 Checklist + 自动化验收脚本 | 安全审查/验收时 |
| references/06-tools.md | 工具推荐（Claude Code / Kimi / Antigravity / OpenClaw） | 工具选型时 |
快速启动
启动前 5 分钟清单
在碰 AI 之前写下：
- 解决什么问题？
- 目标用户？
- 核心功能（P0/P1/P2）
- 技术栈约束
- 什么叫「完成」？
PLAN/ACT 分离（最重要）
- PLAN 阶段: 大上下文 thinking 模型（Gemini / OpenAI / Claude 最新旗舰）只分析、只规划 → 输出 Design Doc
- ACT 阶段: 新 session + 快速模型（各厂商轻量级模型）→ 读 Design Doc → 逐步实现
- 永远不要在同一个 session 里做 Plan 和 Act
故障快速参考
| 信号 | 动作 |
|---|---|
| 单个错误，信息清晰 | 粘贴完整 stack trace → AI 修 |
| 来回改同一文件 3+ 次 | 🛑 停！git stash → 换模型/策略 |
| 多处报错，越修越乱 | git reset --hard <stable> → 重新 Plan |
| AI 重复/遗忘/答非所问 | 关 session → LOG.md → 新 session 接力 |
安全红线
Auth、支付、数据库 Schema、用户数据、API Key — 绝不 vibe，必须人工逐行 review。
实际案例
使用中的真实案例记录在 memory/tasks/ 目录。每次完成 Vibe Coding 项目都会生成 task 记录，包含执行过程、踩坑和成果。
工具信息时效性
⚠️ 工具相关信息（Kimi Agent Swarm、Antigravity Kit 等）截至 2026-02，具体能力和 API 以官方文档为准。