Vibe Coding 最佳实践

🎯 Vibe Coding 最佳实践

从实战中总结的经验和技巧。

---

项目启动

1. 先规划，后编码

❌ 直接说：帮我做一个 xxx
✅ 先让 AI 帮你：
   1. 明确需求
   2. 设计架构
   3. 拆分任务
   4. 再逐步实现

2. 使用 Memory Bank

创建 memory-bank/ 目录存放：

• game-design-document.md 或 prd.md - 需求文档
• tech-stack.md - 技术栈
• implementation-plan.md - 实施计划
• progress.md - 进度记录
• architecture.md - 架构说明

3. 设置 CLAUDE.md / AGENTS.md

在项目根目录创建，让 AI 了解：

• 项目背景
• 技术栈
• 代码规范
• 禁止事项

---

开发过程

1. 一次只做一件事

❌ 帮我实现登录、注册、个人中心
✅ 先帮我实现登录功能，完成后我再告诉你下一步

2. 模块化开发

要求：
- 代码必须模块化
- 每个文件不超过 200 行
- 按职责拆分
- 禁止单体巨文件

3. 及时验证

每完成一个功能：
1. 运行测试
2. 确认符合预期
3. 提交 git
4. 再继续下一步

4. 定期切换会话

上下文太长时：

• 使用 /clear 或 /compact
• 或开启新会话
• 把关键信息写入 Memory Bank

---

调试技巧

1. 提供完整信息

问题描述：
- 预期行为：xxx
- 实际行为：xxx
- 错误信息：xxx
- 相关代码：xxx
- 已尝试：xxx

2. 最小复现

请帮我构造最小复现代码，
只包含触发问题的必要部分。

3. 二分法定位

代码在某处出错，请用二分法：
1. 先确定问题在哪个模块
2. 逐步缩小范围
3. 找到具体问题行

---

代码质量

1. 要求注释

请在代码中添加注释，解释：
- 函数作用
- 参数含义
- 关键逻辑
- 边界情况

2. 要求测试

请为这个功能编写单元测试，覆盖：
- 正常情况
- 边界情况
- 异常情况

3. 代码审查

完成后请自我审查：
- 有没有明显 Bug
- 有没有安全问题
- 有没有性能问题
- 代码是否清晰

---

版本控制

1. 频繁提交

# 每完成一个小功能就提交
git add -A
git commit -m "feat: 完成 xxx 功能"

2. 有意义的提交信息

feat: 添加用户登录功能
fix: 修复密码验证 Bug
docs: 更新 README
refactor: 重构用户模块

3. 善用回退

# Claude Code
/rewind

# Git
git reset --hard HEAD~1

---

效率技巧

1. 使用快捷命令

Claude Code:

• /init - 初始化项目
• /clear - 清空上下文
• /compact - 压缩历史
• /rewind - 回退操作

2. 语音输入

使用 Superwhisper 语音输入，解放双手。

3. 复用提示词

把常用提示词保存到：

• 项目的 prompts/ 目录
• 在线表格
• 个人笔记

---

常见陷阱

❌ 让 AI 自由发挥

帮我做一个网站
→ 结果：过度设计、功能臃肿

❌ 一次改太多

把整个项目重构一下
→ 结果：改出一堆 Bug

❌ 不验证就继续

看起来对了，继续下一步
→ 结果：问题累积，后期难修

❌ 上下文过长

在同一个会话里做了太多事
→ 结果：AI 开始遗忘、混乱

---

推荐工作流

1. 需求澄清
   ↓
2. 技术选型
   ↓
3. 架构设计
   ↓
4. 任务拆分
   ↓
5. 逐步实现（循环）
   - 实现一个功能
   - 测试验证
   - 提交代码
   - 更新进度
   ↓
6. 整体测试
   ↓
7. 部署上线

---

相关链接

• 项目理念与目标
• 提示词编写指南
• 常见问题