Vibe Coding 是一种强调“规划先行、人机协同”的开发方式。通过先写文档、维持上下文一致性、小步迭代与持续验证，让 AI 始终在明确结构与规则下参与协作，从而成为可靠的编码助手，避免代码混乱并显著提升整体开发效率。

一、Planning is Everything

1. 不要让 AI 自由发挥 - 否则代码会混乱不堪
2. 先写设计文档 - GDD（游戏设计文档）或 PRD（产品需求文档），以 Markdown 格式写清构想
3. 生成实现计划 - 让 AI 基于设计文档 + 技术选型，生成 Implementation Plan，而非直接写代码
4. 小粒度 + 测试 - 实现计划的每一步都应该是小粒度，并附带测试验证

---

二、维持上下文一致性

文件结构：

memory-bank/
├── game-design-document.md  # 设计文档
├── tech-stack.md            # 技术选型
├── implementation-plan.md   # 实现计划
├── progress.md              # 进度记录
└── architecture.md          # 架构说明

使用要点：

1. AI 生成代码时始终读取关键文档（architecture.md、GDD）
2. 在 progress.md 记录每步完成情况
3. 在 architecture.md 补充模块架构解释
4. 未来回顾或继续开发时更加清晰

---

三、迭代、验证、提交

四步循环

1. AI 实现 - 让 AI 完成实现计划中的一个 Step
2. 手动验证 - 运行测试，确认代码是否满足预期
3. Git 提交 - 每完成一步就 commit，保留历史便于回退
4. 新对话继续 - 开启新 Chat，让 AI 重新读取 memory-bank + progress

关键点

• 不要马上继续下一步，先验证当前步骤
• 新对话能避免上下文混乱
• 为每个大功能写 feature-implementation.md

---

四、错误处理与工具优化

错误处理

1. 回退重试 - 使用 /rewind 回到上一步重新尝试
2. 日志分析 - 将控制台错误复制到 VSCode，让 AI 分析
3. 整体诊断 - 用 RepoPrompt/uithub 生成大文件，从整体视图诊断

工具优化

1. 模型选择 - 小改动用中等模型（GPT-5 medium）节省成本
2. CLI + VSCode - 命令行看 diff，VSCode 维持开发节奏
3. 自定义命令 - 如 /explain $arguments 先让模型理解再执行
4. 清除上下文 - 频繁使用 /clear 或 /compact 避免旧内容干扰

---

五、风险与对策

潜在风险

1. AI 代码可能结构混乱，未来维护困难
2. 隐藏 bug 难以察觉（并发问题、错误 API 调用）
3. 代码”看起来对”但逻辑有问题

应对策略

1. 适时重构 - 项目进入生产阶段时进行 vibe-refactor
2. 定期审查 - 保持代码审查、重构、测试习惯
3. 小步快跑 - 快速原型验证想法，方向对了再加功能

---

六、Vibe Coding 综合心得

1. 定位清晰 - 强大的快速原型工具，但不取代传统软件工程流程
2. 上下文管理 - Memory Bank + 明确规则是项目健康的关键支撑
3. 测试不可省 - 每步有测试、每个 feature 拆开验证
4. 人机结合 - AI 写代码很有用，人类需持续审查、校正、重构
5. 社区参考 - 阅读其他 vibe coder 的经验对实践非常有帮助