vibe-coding-standard-workflow

Vibe Coding 标准工作流

将粗略的想法转化为可控的交付循环。使用此技能，强制执行文档优先规划、明确澄清、可测试的小步实现，以及持久化项目记忆，以便后续交接。

目标产物

创建并维护以下文件：

• PRD.md，作为临时的想法记录文件
• memory-bank/design-document.md
• memory-bank/tech-stack.md
• memory-bank/implementation-plan.md
• memory-bank/progress.md
• memory-bank/architecture.md
• AGENTS.md 和／或 CLAUDE.md，具体取决于 Agent 环境

引导阶段结束后，将 memory-bank/ 视为长期维护的事实来源。

引导工作流

1. 规范化初始想法

首先生成一份简短的 PRD.md，记录：

• 产品名称
• 目标用户
• 用户问题
• 主要用户流程
• 主要功能
• 关键约束或假设

保持精简。目的是为深入提问提供足够的结构，而不是完成规格说明。

2. 将 PRD 转化为正式设计文档

阅读 PRD.md，然后在编写 design-document.md 之前提出有针对性的澄清问题。如果 PRD 仍有歧义，不要直接开始编写设计文档。

最终的设计文档应能支持实施决策。至少涵盖：

• 范围和非目标
• 用户旅程
• 功能行为
• 边缘情况
• 数据或状态模型
• 验收标准

如果用户逐步回答问题，请持续完善文档，直到设计可以执行。

3. 推荐技术栈

根据 design-document.md 推导出 tech-stack.md，而不是凭空猜测。优先选择简单稳健的方案，而非新潮且宽泛的方案。

为每个主要层选择满足最低可行需求的技术栈：

• 应用框架
• 后端／运行时
• 存储
• 身份验证
• 部署
• 测试

理由应简短但明确。

4. 初始化项目记忆和 Agent 指令

设计和技术栈确定后：

• 如果工作流或用户指令允许，删除已被取代的 PRD.md
• 如果环境支持，运行仓库初始化流程
• 确保 AGENTS.md 和／或 CLAUDE.md 包含必需的记忆库规则
• 创建 memory-bank/
• 将 design-document.md、tech-stack.md 和 implementation-plan.md 移入 memory-bank/
• 创建空的 memory-bank/progress.md 和 memory-bank/architecture.md
• 文件移动后修正文档中的路径

如果 AGENTS.md 和 CLAUDE.md 仅存在其一，则更新该文件。如果两者都存在，则保持内容一致。

附加此代码块：

## 重要提示

- 写任何代码前必须完整阅读 memory-bank/@architecture.md
- 写任何代码前必须完整阅读 memory-bank/@design-document.md
- 每完成一个重大功能或里程碑后，必须更新 memory-bank/@architecture.md

5. 制定实施计划

根据 design-document.md 和 tech-stack.md 生成 implementation-plan.md。

计划中的每个步骤都必须：

• 足够小
• 具体明确
• 顺序合理
• 不含代码
• 可独立验证

每个步骤都必须包含自己的验证说明或测试预期。不要使用“构建后端”或“完成前端”这类含糊的步骤。

6. 反复完善计划，直到可以执行

阅读整个 memory-bank/，并提出仍有必要的问题，让计划变得明确无歧义。持续完善，直到实施计划清晰到另一位 Agent 无需重新探究产品意图即可执行。

每轮澄清后都要更新文档。

执行循环

7. 一次只执行一个计划步骤

编写代码前，阅读：

• memory-bank/architecture.md
• memory-bank/design-document.md
• memory-bank/implementation-plan.md
• memory-bank/progress.md

然后只执行当前计划步骤。

除非用户明确委托测试执行，否则假设用户负责把关测试。当前步骤未验证之前，不要开始下一步。

用户确认步骤完成后：

• 在 memory-bank/progress.md 末尾追加一条简短记录
• 更新 memory-bank/architecture.md，说明新增或变更的文件及其存在原因

8. 使用全新上下文重新加载

此后每个步骤开始前，都要重新加载 memory-bank/ 文件和最新的 progress.md。如果上下文质量有所下降，应明确清除并重建上下文，而不是依赖记忆。

不可妥协的规则

• 需求不明确时，提出澄清问题。
• implementation-plan.md 中不得包含代码。
• 第 N 步通过验证前，不得开始第 N+1 步。
• 将 progress.md 作为执行日志，而不是设计文档。
• 将 architecture.md 作为重要文件及其职责的最新概览。
• 如果可以使用 git，且用户需要一个还原点，则优先在初始化或重要里程碑后创建检查点提交。
• 除非用户明确要求采用其他约定，否则保留此工作流中的文件名。

特定 Agent 的说明

• 阅读 references/codex.md，了解 Codex 特定的行为和打包说明。
• 阅读 references/claude-code.md，了解 Claude Code 特定的行为和市场说明。
• 如果需要各个工作流阶段可直接发送的提示词模板，请阅读 references/prompts.md。