Skip to content

Latest commit

 

History

History
329 lines (233 loc) · 9.14 KB

File metadata and controls

329 lines (233 loc) · 9.14 KB

Vibe Coding 标准工作流

从想法到可维护代码的完整流程


核心理念

Vibe Coding = 规划驱动 + 上下文固定 + AI 结对执行

让「从想法到可维护代码」变成一条可审计的流水线,而不是一团无法迭代的巨石文件。


你能得到什么

  • 成体系的提示词工具链:系统提示词约束 AI 行为边界,编程提示词提供需求澄清、计划、执行的全链路脚本
  • 闭环交付路径:需求 → 上下文文档 → 实施计划 → 分步实现 → 自测 → 进度记录,全程可复盘、可移交

完整工作流(6 步)

第 1 步:游戏设计文档(Game Design Document)

目标:把想法转化为结构化的需求文档

操作

  1. 把你的想法交给 gpt-5.3-codexClaude Opus 4.6
  2. 让它生成一份简洁的 游戏设计文档,格式为 Markdown
  3. 文件命名:game-design-document.md

提示词示例

我想做一个 [项目描述]。

请帮我生成一份游戏设计文档(GDD),包含:
1. 核心玩法/功能描述
2. 目标用户
3. 主要特性列表
4. 技术约束(如果有)

要求:简洁清晰,Markdown 格式。

关键

  • 自己审阅并完善,确保与你的愿景一致
  • 初期可以很简陋,目标是给 AI 提供游戏结构和意图的上下文
  • 不要过度设计,后续会迭代

第 2 步:技术栈与 Agent 规则

目标:确定技术栈和 AI 行为规范

操作

  1. 让 AI 为你的项目推荐最合适的技术栈 → tech-stack.md
  2. 要求:最简单但最健壮
  3. 在终端中打开 Claude CodeCodex CLI,使用 /init 命令
  4. AI 会读取你已创建的两个 .md 文件,生成一套规则

关键审查点

  • ✅ 强调模块化(多文件)
  • ❌ 禁止单体巨文件(monolith)
  • ⚠️ 将关键规则设为 "Always"(始终应用)

必须添加的 "Always" 规则示例

# 重要提示:
# 写任何代码前必须完整阅读 memory-bank/@architecture.md(包含完整数据库结构)
# 写任何代码前必须完整阅读 memory-bank/@game-design-document.md
# 每完成一个重大功能或里程碑后,必须更新 memory-bank/@architecture.md

提示词示例(技术栈推荐)

基于以下游戏设计文档,请推荐最合适的技术栈:

[粘贴 GDD 内容]

要求:
1. 最简单但最健壮
2. 适合快速原型开发
3. 有良好的社区支持
4. 列出每个技术选型的原因

第 3 步:实施计划(Implementation Plan)

目标:生成详细的分步开发指令

操作

  1. 将以下内容提供给 AI:
    • 游戏设计文档(game-design-document.md
    • 技术栈推荐(tech-stack.md
  2. 让它生成一份详细的 实施计划(Markdown 格式)

实施计划要求

  • 包含一系列给 AI 开发者的分步指令
  • 每一步要小而具体
  • 每一步都必须包含验证正确性的测试
  • 严禁包含代码——只写清晰、具体的指令
  • 先聚焦于基础游戏,完整功能后面再加

提示词示例

请根据以下文档生成实施计划:
- 游戏设计文档:[粘贴内容]
- 技术栈:[粘贴内容]

要求:
1. 生成一系列分步指令
2. 每一步要小而具体
3. 每一步都包含验证测试
4. 不要包含代码
5. 先聚焦基础功能

输出格式:Markdown,文件名为 implementation-plan.md

第 4 步:记忆库(Memory Bank)

目标:建立项目上下文中心

操作

  1. 新建项目文件夹,并在 VSCode 中打开
  2. 在项目根目录下创建子文件夹 memory-bank
  3. 将以下文件放入 memory-bank
    • game-design-document.md
    • tech-stack.md
    • implementation-plan.md
    • progress.md(新建空文件,记录已完成步骤)
    • architecture.md(新建空文件,记录每个文件的作用)

目录结构

my-project/
├── memory-bank/
│   ├── game-design-document.md
│   ├── tech-stack.md
│   ├── implementation-plan.md
│   ├── progress.md
│   └── architecture.md
└── src/  # 后续生成的代码

第 5 步:Vibe Coding 开发

5.1 确保一切清晰

操作

  1. 在 VSCode 扩展中打开 CodexClaude Code
  2. 或在项目终端启动 Claude Code / Codex CLI

提示词

阅读 /memory-bank 里所有文档。

请确认:
1. implementation-plan.md 是否完全清晰?
2. 你有哪些问题需要我澄清?

让它对你来说 100% 明确。

关键

  • AI 通常会问 9-10 个问题
  • 全部回答完后,让它根据你的回答修改 implementation-plan.md

5.2 你的第一个实施提示词

提示词

阅读 /memory-bank 所有文档,然后执行实施计划的第 1 步。

我会负责跑测试。在我验证测试通过前,不要开始第 2 步。
验证通过后,打开 progress.md 记录你做了什么供后续开发者参考,
再把新的架构洞察添加到 architecture.md 中解释每个文件的作用。

关键

  • 永远先用 "Ask" 模式或 "Plan Mode"(Claude Code 中按 shift+tab
  • 确认满意后再让 AI 执行该步骤

5.3 工作流

完成第 1 步后

  1. 把改动提交到 Git
  2. 新建聊天(/new/clear
  3. 提示词:
阅读 memory-bank 所有文件,阅读 progress.md 了解之前的工作进度,
然后继续实施计划第 2 步。在我验证测试前不要开始第 3 步。
  1. 重复此流程,直到整个 implementation-plan.md 全部完成

第 6 步:添加细节功能

恭喜!你已经做出了基础产品!

现在可以尽情实验和打磨了:

  • 想要雾效、后期处理、特效、音效?
  • 更好的界面/功能/内容?

操作

  1. 每增加一个主要功能,新建一个 feature-xxx.md
  2. 写短步骤 + 测试
  3. 继续增量式实现和测试

提示词示例

我想添加 [新功能]。

请帮我:
1. 分析这个功能需要修改哪些文件
2. 生成实施步骤(包含测试)
3. 记录到 feature-implementation.md

要求:小步迭代,每步可验证。

修复 Bug 与卡壳情况

常规修复

如果某个提示词失败或搞崩了项目

  • Claude Code 用 /rewind 回退
  • 用 Codex CLI 的话多提交 git,需要时 reset

报错处理

  • JavaScript 错误:打开浏览器控制台(F12),复制错误,贴给 AI
  • 视觉问题:截图发给它
  • 懒人方案:安装 BrowserTools,自动复制错误和截图

疑难杂症

实在卡住

  • 回退到上一个 git commit(git reset),换新提示词重试

极度卡壳

  • RepoPromptuithub 把整个代码库合成一个文件
  • 然后丢给 gpt-5.3-codex 或 Claude 求救

技巧与窍门

Claude Code & Codex 使用技巧

技巧 说明
终端版 在 VSCode 终端里运行,能直接看 diff、喂上下文
/rewind 迭代跑偏时一键回滚到之前状态
自定义命令 创建像 /explain $参数 这样的快捷命令
清理上下文 经常用 /clear/compact
省时大法 claude --dangerously-skip-permissions(风险自负)

其他实用技巧

  • 小修改:用 gpt-5.3-codex (medium)
  • 写顶级营销文案:用 Opus 4.1
  • 生成优秀 2D 精灵图:用 ChatGPT + Nano Banana
  • 生成音乐:用 Suno
  • 生成音效:用 ElevenLabs
  • 提升提示词效果
    • 加一句:"慢慢想,不着急,重要的是严格按我说的做"
    • 在 Claude Code 中触发深度思考的关键词强度:think < think hard < think harder < ultrathink

常见问题解答

Q: 我在做应用不是游戏,这个流程一样吗?

A: 基本完全一样!把 GDD 换成 PRD(产品需求文档)即可。你也可以先用 v0、Lovable、Bolt.new 快速原型,再把代码搬到 GitHub,然后克隆到本地用本指南继续开发。

Q: 为什么现在 Claude Code 或 Codex CLI 比 Cursor 更强?

A: Claude Code 能更好发挥 Claude Opus 4.6 的实力,Codex CLI 能更好发挥 gpt-5.3-codex 的实力。终端版还能在任意 IDE、使用 SSH 远程服务器等场景工作,自定义命令、子代理、钩子等功能也能长期大幅提升开发质量和速度。

Q: 我不会搭建多人游戏的服务器怎么办?

A: 问你的 AI。


质量检查清单

在开始每一步之前检查:

  • GDD 是否清晰描述了核心功能?
  • 技术栈是否最简单且够用?
  • 实施计划是否包含验证步骤?
  • memory-bank 是否包含所有上下文文档?
  • AI 是否理解了所有需求?
  • 是否有测试覆盖每一步?

相关资源


维护

  • 来源:tukuaiai/vibe-coding-cn 仓库
  • 最后更新:2026-03-23