Vibe Coding 标准开发流程一套可照着执行的 AI 项目开发 SOP适用场景Claude Code Superpowers Skills、Codex CLI、Cursor、Gemini CLI以及其他 AI 编程工具。核心目标让 AI 项目开发从“想到哪写到哪”变成“按阶段推进、按文档验收、按 Git 留痕、按测试闭环”。很多人用 AI 写代码时最大的问题不是 AI 不够强而是流程太松散需求还没想清楚就开始让 AI 写代码文档没有沉淀后续上下文很快丢失前后端接口没有约定联调阶段反复返工没有阶段验收项目越做越乱没有测试和 Git 节点出了问题很难回滚。这篇文档整理了一套Vibe Coding 标准开发流程。可以作为以后每个 AI 编程项目的执行 SOP。你可以把它理解为一套项目推进清单每个阶段都有明确的目标、输入、推荐 Skills、执行步骤、交付物、完成标准和注意事项。做完一个阶段验收通过再进入下一个阶段。一、这套流程适合谁如果你正在使用以下工具做项目开发这套流程都适用Claude Code Superpowers SkillsCodex CLI / Codex AppCursorGemini CLI其他支持文件读写、代码生成、测试执行的 AI 编程工具其中Claude Code Superpowers Skills是最推荐的组合因为 Skills 可以把“需求分析、计划编写、调试、测试、Code Review”等动作拆成稳定流程减少 AI 随机发挥。二、核心原则1. Documentation First先文档后实现不要一上来就写代码。先让 AI 和你一起产出 PRD、架构设计、数据库设计、API 文档等关键材料。文档不是形式主义而是 AI 项目的长期上下文。2. Stage Gate阶段门禁每个阶段都有完成标准。没有完成标准就不要进入下一阶段。例如PRD 没确认不做原型API 没稳定不做前端联调测试没通过不进入发布。3. Git Driven每阶段都提交每完成一个阶段就提交一次 Git Commit。这样可以保证项目过程可追溯、可回滚、可协作。4. Test Driven关键逻辑用测试闭环后端接口、核心业务逻辑、前端关键流程都应该有测试覆盖。AI 写代码速度很快但测试可以帮你判断它是否真的写对。5. Skills Driven不同阶段调用不同 Skills不要让一个通用 Prompt 贯穿全项目。不同阶段应该使用不同的 Skills 或工作模式需求阶段用 brainstorming计划阶段用 writing-plans执行阶段用 executing-plans 或 subagent-driven-development调试阶段用 systematic-debugging测试阶段用 test-driven-development评审阶段用 requesting-code-review / receiving-code-review。三、整体流程图Stage 0 项目初始化Stage 1 需求分析 PRDStage 2 产品原型设计Stage 3 数据库与系统架构Stage 4 后端工程开发Stage 5 后端 TDD 测试Stage 6 API 文档Stage 7 前端开发Stage 8 前端测试Stage 9 前后端联调Stage 10 Code Review 与发布如果 CSDN 的 Mermaid 渲染不稳定可以直接看下面这张总览表。四、阶段总览表阶段阶段目标推荐 Skills核心交付物通过标准Stage 0初始化项目规范和目录using-superpowers、brainstormingREADME、CLAUDE.md、项目目录项目结构清晰可开始需求分析Stage 1输出 PRDbrainstorming、verification-before-completiondocs/01-PRD.mdMVP、功能、边界、异常流程明确Stage 2设计产品原型executing-plans、using-git-worktrees页面流程、Wireframe、Prototype页面结构可指导开发Stage 3完成数据库和系统架构dispatching-parallel-agentsDatabase、Architecture、SQL前后端和数据结构边界清楚Stage 4生成后端工程骨架subagent-driven-developmentbackend/后端目录、模块、基础配置完成Stage 5后端测试闭环test-driven-developmentTest Plan、Unit Test、Integration Test核心接口测试通过Stage 6生成 API 文档executing-plansAPI.md、OpenAPI、Swagger前端可按文档开发Stage 7开发前端工程subagent-driven-development页面、组件、状态、路由页面能调用接口并完成主流程Stage 8前端测试test-driven-developmentFrontend Test Report页面、表单、权限、异常状态通过Stage 9前后端联调systematic-debuggingBug Report、Regression Test联调问题修复并验证Stage 10评审和发布requesting-code-review、receiving-code-review、finishing-a-development-branchPR、Release Note、TagReview 完成版本可发布五、推荐 Skills 功能速查下面这张表可以作为以后做 Vibe Coding 项目时的 Skills 选择指南。如果某个工具环境里没有对应 Skill也可以把“功能说明”和“典型产出”改写成 Prompt让 AI 按同样的工作方式执行。Skill核心功能适用阶段典型产出使用注意using-superpowers加载 Superpowers 工作方式提醒 AI 优先使用合适的 Skills而不是直接自由发挥。Stage 0、每次新会话开始技能调用意识、项目工作约束适合放在项目初始化和长期协作规范里保证 AI 每次开工先检查流程。brainstorming通过提问、澄清、方案对比把模糊想法变成明确设计或需求。Stage 0、Stage 1项目方向、PRD、设计方案、范围边界不要急着让 AI 写代码先用它把需求、目标用户、MVP 和边界条件问清楚。writing-plans把已确认的设计或需求拆成可执行的实现计划。PRD 后、架构后、复杂功能开发前Implementation Plan、任务拆分、文件改动清单适合在“已经知道要做什么但还没开始写代码”时使用。executing-plans按计划逐步执行任务并在执行过程中做检查和汇报。Stage 2、Stage 6、计划落地阶段原型、API 文档、按计划完成的实现结果前提是已经有清晰计划不要拿它替代需求分析。using-git-worktrees创建隔离工作区或分支避免原型、实验代码污染主分支。Stage 2、并行实验、风险较高的改动独立 worktree、隔离分支做原型、重构、实验方案时很有用尤其适合不确定的探索。dispatching-parallel-agents把相互独立的任务分派给多个 Agent 并行推进。Stage 3数据库设计、后端架构、前端架构并行产出只适合边界清楚的并行任务不要把强依赖的任务硬拆开。subagent-driven-development将开发任务拆给子 Agent 实现再由主 Agent 汇总和审查。Stage 4、Stage 7后端模块、前端页面、组件、业务代码适合工程量较大的开发阶段每个子任务都要有明确输入和验收标准。test-driven-development按 TDD 思路先写测试再实现代码再重构。Stage 5、Stage 8单元测试、集成测试、Mock 测试、覆盖率报告适合接口、核心业务逻辑、表单、权限等高风险区域。verification-before-completion在阶段结束前检查是否遗漏需求、边界、异常流程或交付物。Stage 1、每个阶段收尾检查清单、遗漏项、修订建议很适合做 Stage Gate确认当前阶段真的可以进入下一阶段。systematic-debugging使用系统化方式复现问题、定位根因、验证修复。Stage 9、Bug 修复阶段Bug Report、Root Cause、Regression Test遇到联调问题时先复现和定位不要凭感觉让 AI 乱改代码。requesting-code-review发起代码评审让 AI 从 bug、风险、测试缺口、架构问题等角度检查代码。Stage 10Code Review Report发布前必须使用重点检查权限、安全、数据一致性和异常处理。receiving-code-review根据评审意见逐条修复并确认每个问题都有处理结果。Stage 10Review Fix Commit、修复说明不要只挑简单意见改高风险问题要优先处理并补测试。finishing-a-development-branch完成分支收尾包括测试、合并、发布准备和版本记录。Stage 10PR、Release Note、Tag、部署说明用于正式发布前的最后检查保证分支不是“写完就扔”。建议记住一个简单规则想清楚需求brainstorming 写执行计划writing-plans 按计划执行executing-plans / subagent-driven-development 写测试闭环test-driven-development 修复杂问题systematic-debugging 发布前审查requesting-code-review receiving-code-review finishing-a-development-branch六、Stage 0项目初始化阶段目标建立项目的基础结构、协作规范和 AI 上下文文件为后续阶段提供稳定起点。前置输入项目名称项目大致方向技术栈初步想法目标运行环境推荐 Skillsusing-superpowersbrainstorming执行步骤创建 Git 仓库。初始化README.md。创建CLAUDE.md或同类 AI 项目记忆文件。创建docs/目录用于保存 PRD、架构、API、测试报告等文档。创建基础目录例如frontend/、backend/、scripts/、tests/。确认技术栈例如前端框架、后端语言、数据库、缓存、部署方式。记录阶段状态和下一步待办。推荐 Prompt请帮我初始化这个 Vibe Coding 项目的开发规范。 项目信息 - 项目名称 - 项目类型 - 目标用户 - 计划技术栈 请输出 1. README.md 初稿 2. CLAUDE.md 项目记忆文件 3. 推荐目录结构 4. 后续开发阶段清单 5. Stage 0 完成检查清单交付物README.md CLAUDE.md docs/ frontend/ backend/ Git 初始化记录完成标准项目目录已经创建。README 能说明项目是什么。AI 项目记忆文件已经包含技术栈、目录约定和工作流。Git 仓库可以正常提交。下一阶段的需求分析已有明确入口。注意事项不要把CLAUDE.md当成摆设。每完成一个阶段都应该更新其中的当前进度、交付物、待办事项和关键决策。七、Stage 1需求分析PRD阶段目标把模糊想法整理成可执行的产品需求文档明确要做什么、不做什么、先做什么。前置输入项目想法目标用户核心使用场景初步功能列表推荐 Skillsbrainstormingverification-before-completion执行步骤使用brainstorming和 AI 讨论需求边界。明确目标用户、核心场景、业务流程和 MVP 范围。输出 PRD 初稿。使用verification-before-completion检查遗漏功能、边界条件和异常流程。根据检查结果修订 PRD。将 PRD 保存到docs/01-PRD.md。推荐 Prompt请基于以下项目描述帮我输出一份完整 PRD。 项目描述 【在这里填写项目背景和想法】 PRD 需要包含 1. 项目背景 2. 目标用户 3. 用户痛点 4. 核心功能模块 5. 页面流程 6. 非功能需求 7. MVP 范围 8. 暂不实现的功能 9. 边界场景和异常流程 10. Stage 1 完成检查清单交付物docs/01-PRD.md完成标准功能范围清晰。MVP 边界明确。页面流程和用户路径可描述。异常流程和边界条件已经列出。后续原型设计可以直接基于 PRD 展开。注意事项PRD 未确认前不要直接写代码。AI 编程最常见的返工通常都来自需求阶段没有说清楚。八、Stage 2产品原型设计阶段目标基于 PRD 设计页面结构、用户流程和关键交互让开发前先看见产品形态。前置输入docs/01-PRD.mdMVP 功能范围用户路径推荐 Skillsexecuting-plansusing-git-worktrees执行步骤根据 PRD 梳理页面清单。为每个页面定义核心功能和入口出口。设计用户流程例如登录、创建、编辑、提交、查询、管理等路径。输出 Wireframe 或低保真原型。如果需要写原型代码建议放到独立分支或 worktree避免污染主分支。评审原型是否覆盖 PRD 中的主流程和异常流程。推荐 Prompt请根据以下 PRD设计产品原型方案。 输入 - PRD 内容 【粘贴 docs/01-PRD.md】 请输出 1. 页面清单 2. 页面之间的跳转关系 3. 每个页面的核心区域 4. 关键用户流程 5. Wireframe 文本草图 6. 原型开发建议 7. Stage 2 完成检查清单交付物页面结构说明 页面流程图 Wireframe Prototype完成标准PRD 中的核心功能都能在页面中找到对应入口。页面流程能支撑完整 MVP。关键异常状态有展示方案。前端架构设计可以基于原型继续推进。注意事项原型阶段不要过早追求视觉细节。此阶段的重点是流程正确、信息结构正确、主路径可走通。九、Stage 3数据库与系统架构设计阶段目标完成系统的核心技术设计包括数据库、后端架构、前端架构和关键基础设施。前置输入PRD产品原型技术栈选择业务实体和核心流程推荐 Skillsdispatching-parallel-agents执行步骤将架构设计拆成三个方向并行推进数据库设计、后端架构、前端架构。数据库方向输出 ER 图、表结构、索引设计和初始化 SQL。后端方向输出模块划分、目录结构、权限、缓存、日志、异常处理和部署方案。前端方向输出页面结构、组件划分、路由、状态管理和接口调用规划。汇总三个方向检查边界是否一致。保存架构文档和数据库脚本。推荐 Prompt请根据 PRD 和产品原型帮我完成系统架构设计。 输入 - PRD 【粘贴 PRD】 - 产品原型 【粘贴页面结构和流程】 - 技术栈 【填写技术栈】 请分别输出 1. 数据库设计ER 图、表结构、索引、SQL 2. 后端架构目录结构、模块划分、权限、缓存、日志、异常处理、部署方案 3. 前端架构页面结构、组件划分、路由、状态管理、接口规划 4. 架构风险点 5. Stage 3 完成检查清单交付物docs/02-Database.md docs/03-Architecture.md docs/database.sql完成标准核心业务实体已经建模。表结构和业务流程对应。后端模块边界清楚。前端页面、组件、状态和接口关系清楚。架构文档能指导后续工程开发。注意事项数据库设计和架构设计不要完全交给 AI 一次生成后就直接使用。至少要人工检查实体关系、权限边界、索引合理性和扩展风险。十、Stage 4后端工程开发阶段目标根据 PRD、数据库设计和架构设计快速生成标准后端工程骨架并逐步补充业务逻辑。前置输入PRD数据库设计系统架构设计技术栈和后端框架推荐 Skillssubagent-driven-development执行步骤先生成后端基础工程目录。创建 Controller、Service、Repository、Entity、DTO 等分层结构。添加统一配置、异常处理、中间件、日志和权限基础能力。按模块逐步补充业务代码。每完成一个模块执行基础运行检查。更新项目文档和 Git Commit。推荐 Prompt请根据以下文档生成后端工程骨架。 输入 - PRD 【粘贴 PRD】 - 数据库设计 【粘贴数据库文档】 - 系统架构 【粘贴架构文档】 - 后端技术栈 【填写框架和数据库】 请输出 1. 后端目录结构 2. Controller / Service / Repository / Entity / DTO 划分 3. 配置文件设计 4. 统一异常处理 5. 权限和中间件设计 6. 模块开发顺序 7. Stage 4 完成检查清单交付物backend/ 后端工程目录 基础配置 核心模块代码完成标准后端项目可以启动。目录结构符合架构文档。核心模块已经有清晰分层。基础异常、日志、权限或中间件框架已经建立。可以进入后端测试阶段。注意事项建议先生成脚手架再补业务逻辑。不要让 AI 一次性生成大量业务代码否则排查成本会变高。十一、Stage 5后端测试TDD阶段目标通过测试保证后端接口和核心业务逻辑稳定。前置输入后端工程PRD数据库设计API 初步约定推荐 Skillstest-driven-development执行步骤为核心业务接口编写测试计划。先写失败测试明确期望行为。运行测试确认失败原因符合预期。实现最小业务代码让测试通过。补充异常场景和边界条件测试。重构代码并保持测试通过。输出测试报告。推荐 Prompt请基于以下后端模块帮我设计 TDD 测试方案。 输入 - 模块名称 - 接口列表 - 业务规则 - 异常场景 请输出 1. 测试用例清单 2. 正常流程测试 3. 异常流程测试 4. 边界条件测试 5. Mock 数据设计 6. 覆盖率建议 7. Stage 5 完成检查清单交付物Test Plan Unit Test Integration Test Coverage Report完成标准核心业务接口有测试覆盖。正常流程和异常流程都经过验证。测试可以在本地稳定运行。修复代码后没有破坏已有测试。注意事项测试不是最后补文档。TDD 的价值在于先明确行为再让 AI 实现代码。十二、Stage 6API 文档阶段目标生成标准接口文档让前端开发和联调有明确契约。前置输入后端路由DTOResponse 结构权限规则错误码推荐 Skillsexecuting-plans执行步骤扫描后端 Router、Controller、DTO 和 Response。统一接口路径、请求参数、响应格式和错误码。生成 Markdown API 文档。如项目支持生成 Swagger 或 OpenAPI。让前端依据 API 文档确认字段、状态码和异常响应。将 API 文档纳入 Git 版本管理。推荐 Prompt请根据以下后端接口代码或路由定义生成标准 API 文档。 输入 - Router / Controller 【粘贴代码或路由】 - DTO 【粘贴 DTO】 - Response 【粘贴响应结构】 请输出 1. 接口列表 2. 请求方法和路径 3. 请求参数 4. 响应字段 5. 错误码 6. 鉴权要求 7. Swagger / OpenAPI 建议 8. Stage 6 完成检查清单交付物docs/04-API.md Swagger OpenAPI完成标准每个接口都有请求和响应说明。字段类型明确。错误码和异常响应明确。前端可以不读后端代码仅凭 API 文档进行开发。注意事项API 文档是前后端契约。后端代码变更后要同步更新 API 文档否则联调阶段会大量返工。十三、Stage 7前端开发阶段目标根据 PRD、产品原型、API 文档和前端架构实现前端页面和交互流程。前置输入PRD产品原型API 文档前端架构设计推荐 Skillssubagent-driven-development执行步骤初始化前端工程。根据页面结构创建路由。根据组件划分实现基础组件。封装 API 请求层。实现状态管理。按页面逐步开发主流程。接入 Mock API 或真实 API。更新前端说明文档。推荐 Prompt请根据以下材料生成前端开发计划并实现页面。 输入 - PRD 【粘贴 PRD】 - 产品原型 【粘贴页面说明】 - API 文档 【粘贴 API】 - 前端架构 【粘贴前端架构】 请输出 1. 前端目录结构 2. 路由设计 3. 组件划分 4. 状态管理方案 5. API 请求封装 6. 页面开发顺序 7. Stage 7 完成检查清单交付物frontend/ 页面 组件 状态管理 请求封装 路由配置完成标准核心页面已经实现。主流程可以操作。API 请求层已封装。页面状态、加载态、空状态和错误态有基本处理。可以进入前端测试阶段。注意事项不要把 API 调用散落在每个组件里。建议统一封装请求层降低后续接口调整成本。十四、Stage 8前端测试阶段目标验证页面渲染、交互行为、接口调用和异常状态保证前端主流程可用。前置输入前端工程API 文档Mock 数据产品原型推荐 Skillstest-driven-development执行步骤编写页面渲染测试。编写组件交互测试。使用 Mock API 验证接口调用。覆盖登录、权限、表单、空状态、错误页面等关键场景。运行测试并修复失败项。输出前端测试报告。推荐 Prompt请为以下前端页面设计测试方案。 输入 - 页面名称 - 页面功能 - 组件列表 - API 调用 - 异常场景 请输出 1. 页面渲染测试 2. 组件交互测试 3. Mock API 测试 4. 权限和登录测试 5. 表单校验测试 6. 异常页面测试 7. Stage 8 完成检查清单交付物Frontend Test Report 页面测试 组件测试 Mock API 测试完成标准核心页面可以稳定渲染。关键交互有测试覆盖。API 成功和失败状态都经过验证。登录、权限和表单流程可用。注意事项前端测试不要只测“页面能不能打开”。真正重要的是用户能否完成关键任务以及异常状态是否可恢复。十五、Stage 9前后端联调阶段目标修复前后端集成过程中的问题让系统主流程完整跑通。前置输入后端服务前端工程API 文档测试数据环境配置推荐 Skillssystematic-debugging执行步骤启动前端和后端服务。按用户主流程逐步验证。记录所有联调问题。对每个问题定位根因例如 Token、权限、参数、接口、Redis、数据库、缓存或第三方接口。修复后补充回归测试。输出 Bug Report 和联调完成报告。推荐 Prompt请使用系统化调试方式帮我分析以下前后端联调问题。 问题描述 【填写现象】 已知信息 - 前端请求 - 后端日志 - API 文档 - 数据库状态 - 环境配置 请输出 1. 可能原因列表 2. 最小复现步骤 3. 根因判断 4. 修复方案 5. 回归测试建议 6. Stage 9 完成检查清单交付物Bug Report Root Cause Regression Test 联调完成报告完成标准用户主流程可以完整跑通。已知联调问题全部有处理结论。修复项有回归测试或验证记录。前后端接口契约已经同步。注意事项联调时不要凭感觉改代码。先复现再定位根因再修复再回归验证。十六、Stage 10Code Review 与发布阶段目标完成代码评审、修复评审问题并发布可追溯版本。前置输入已完成联调的代码测试报告API 文档部署说明Git 分支推荐 Skillsrequesting-code-reviewreceiving-code-reviewfinishing-a-development-branch执行步骤使用requesting-code-review发起代码评审。让 AI 或团队成员检查 bug、风险、测试缺口和架构问题。使用receiving-code-review逐条处理评审意见。重新运行测试和关键流程验证。合并分支。生成 Release Note。创建 Tag 或发布版本。更新部署文档和项目状态。推荐 Prompt请对当前项目进行发布前 Code Review。 请重点检查 1. 是否存在明显 bug 2. 是否有安全风险 3. 是否有接口兼容问题 4. 是否有未覆盖测试的关键逻辑 5. 是否有部署风险 6. 是否有文档缺失 请按严重程度输出问题并给出修复建议。交付物Code Review Report Review Fix Commit Release Note PR Tag 部署文档完成标准Code Review 问题已经处理。测试通过。Release Note 已生成。版本号或 Tag 已创建。部署步骤清晰。注意事项不要跳过 Code Review。AI 写出来的代码也需要评审尤其是权限、安全、数据一致性和异常处理部分。十七、每阶段 Git Commit 建议建议每完成一个阶段提交一次Commit Message 可以参考chore: initialize project structure docs: add project PRD docs: add product prototype docs: add database and architecture design feat: scaffold backend project test: add backend api tests docs: add api documentation feat: implement frontend pages test: add frontend tests fix: resolve integration issues chore: prepare release如果某个阶段内容较多可以拆成多个小提交。例如 Stage 3 可以拆为docs: add database design docs: add backend architecture docs: add frontend architecture十八、每个阶段都要更新 CLAUDE.md如果你使用 Claude Code 或其他支持项目记忆的 AI 编程工具建议每个阶段结束时都更新一次CLAUDE.md。建议记录当前阶段 已完成内容 核心交付物 关键决策 Git Commit 待办事项 下一阶段入口这样做的好处是即使中途换会话、换模型、换工具项目上下文也不会完全丢失。十九、Vibe Coding 项目执行检查清单下面这份清单可以在每个新项目开工时复制使用。# Vibe Coding 项目执行检查清单 ## Stage 0项目初始化 - [ ] 创建 Git 仓库 - [ ] 初始化 README.md - [ ] 初始化 CLAUDE.md - [ ] 创建 docs/ 目录 - [ ] 创建 frontend/ 和 backend/ 目录 - [ ] 确认技术栈 - [ ] 提交 Git Commit ## Stage 1需求分析 PRD - [ ] 使用 brainstorming 分析需求 - [ ] 输出 docs/01-PRD.md - [ ] 明确 MVP 范围 - [ ] 检查异常流程和边界问题 - [ ] 使用 verification-before-completion 复查 - [ ] 提交 Git Commit ## Stage 2产品原型设计 - [ ] 输出页面清单 - [ ] 输出页面流程 - [ ] 输出 Wireframe 或 Prototype - [ ] 检查是否覆盖 PRD 主流程 - [ ] 提交 Git Commit ## Stage 3数据库与系统架构 - [ ] 输出数据库设计 - [ ] 输出 database.sql - [ ] 输出后端架构设计 - [ ] 输出前端架构设计 - [ ] 检查实体、接口、页面是否一致 - [ ] 提交 Git Commit ## Stage 4后端工程开发 - [ ] 生成后端工程骨架 - [ ] 创建 Controller / Service / Repository / Entity / DTO - [ ] 添加配置、异常、日志、权限基础能力 - [ ] 后端项目可以启动 - [ ] 提交 Git Commit ## Stage 5后端测试 - [ ] 编写测试计划 - [ ] 编写单元测试 - [ ] 编写集成测试 - [ ] 覆盖正常流程和异常流程 - [ ] 测试通过 - [ ] 提交 Git Commit ## Stage 6API 文档 - [ ] 扫描 Router / DTO / Response - [ ] 输出 docs/04-API.md - [ ] 生成 Swagger 或 OpenAPI - [ ] 前端确认接口契约 - [ ] 提交 Git Commit ## Stage 7前端开发 - [ ] 初始化前端工程 - [ ] 创建路由 - [ ] 创建组件 - [ ] 封装 API 请求 - [ ] 实现状态管理 - [ ] 主流程页面可操作 - [ ] 提交 Git Commit ## Stage 8前端测试 - [ ] 编写页面测试 - [ ] 编写组件测试 - [ ] 编写 Mock API 测试 - [ ] 覆盖登录、权限、表单、异常页面 - [ ] 测试通过 - [ ] 提交 Git Commit ## Stage 9前后端联调 - [ ] 启动前后端服务 - [ ] 跑通用户主流程 - [ ] 记录联调问题 - [ ] 定位 Root Cause - [ ] 修复并添加回归测试 - [ ] 输出联调完成报告 - [ ] 提交 Git Commit ## Stage 10Code Review 与发布 - [ ] 发起 Code Review - [ ] 修复评审问题 - [ ] 重新运行测试 - [ ] 生成 Release Note - [ ] 创建 PR / Tag / Release - [ ] 更新部署文档 - [ ] 提交 Git Commit二十、一句话记住整个流程初始化 ↓ 需求 PRD ↓ 产品原型 ↓ 数据库 架构 ↓ 后端开发 ↓ 后端测试 ↓ API 文档 ↓ 前端开发 ↓ 前端测试 ↓ 前后端联调 ↓ Code Review ↓ 发布二十一、总结Vibe Coding 的重点不是“让 AI 多写代码”而是“让 AI 在正确的流程里写代码”。真正稳定的 AI 项目开发应该做到每个阶段有文档每个阶段有交付物每个阶段有完成标准每个阶段有 Git 记录关键逻辑有测试发布前有 Review。按照这套 Workflow 执行AI 编程会从一次性的代码生成变成可持续推进、可复盘、可协作的工程流程。
Vibe Coding 标准开发流程一套可照着执行的 AI 项目开发 SOP适用场景Claude Code Superpowers Skills、Codex CLI、Cursor、Gemini CLI以及其他 AI 编程工具。核心目标让 AI 项目开发从“想到哪写到哪”变成“按阶段推进、按文档验收、按 Git 留痕、按测试闭环”。很多人用 AI 写代码时最大的问题不是 AI 不够强而是流程太松散需求还没想清楚就开始让 AI 写代码文档没有沉淀后续上下文很快丢失前后端接口没有约定联调阶段反复返工没有阶段验收项目越做越乱没有测试和 Git 节点出了问题很难回滚。这篇文档整理了一套Vibe Coding 标准开发流程。可以作为以后每个 AI 编程项目的执行 SOP。你可以把它理解为一套项目推进清单每个阶段都有明确的目标、输入、推荐 Skills、执行步骤、交付物、完成标准和注意事项。做完一个阶段验收通过再进入下一个阶段。一、这套流程适合谁如果你正在使用以下工具做项目开发这套流程都适用Claude Code Superpowers SkillsCodex CLI / Codex AppCursorGemini CLI其他支持文件读写、代码生成、测试执行的 AI 编程工具其中Claude Code Superpowers Skills是最推荐的组合因为 Skills 可以把“需求分析、计划编写、调试、测试、Code Review”等动作拆成稳定流程减少 AI 随机发挥。二、核心原则1. Documentation First先文档后实现不要一上来就写代码。先让 AI 和你一起产出 PRD、架构设计、数据库设计、API 文档等关键材料。文档不是形式主义而是 AI 项目的长期上下文。2. Stage Gate阶段门禁每个阶段都有完成标准。没有完成标准就不要进入下一阶段。例如PRD 没确认不做原型API 没稳定不做前端联调测试没通过不进入发布。3. Git Driven每阶段都提交每完成一个阶段就提交一次 Git Commit。这样可以保证项目过程可追溯、可回滚、可协作。4. Test Driven关键逻辑用测试闭环后端接口、核心业务逻辑、前端关键流程都应该有测试覆盖。AI 写代码速度很快但测试可以帮你判断它是否真的写对。5. Skills Driven不同阶段调用不同 Skills不要让一个通用 Prompt 贯穿全项目。不同阶段应该使用不同的 Skills 或工作模式需求阶段用 brainstorming计划阶段用 writing-plans执行阶段用 executing-plans 或 subagent-driven-development调试阶段用 systematic-debugging测试阶段用 test-driven-development评审阶段用 requesting-code-review / receiving-code-review。三、整体流程图Stage 0 项目初始化Stage 1 需求分析 PRDStage 2 产品原型设计Stage 3 数据库与系统架构Stage 4 后端工程开发Stage 5 后端 TDD 测试Stage 6 API 文档Stage 7 前端开发Stage 8 前端测试Stage 9 前后端联调Stage 10 Code Review 与发布如果 CSDN 的 Mermaid 渲染不稳定可以直接看下面这张总览表。四、阶段总览表阶段阶段目标推荐 Skills核心交付物通过标准Stage 0初始化项目规范和目录using-superpowers、brainstormingREADME、CLAUDE.md、项目目录项目结构清晰可开始需求分析Stage 1输出 PRDbrainstorming、verification-before-completiondocs/01-PRD.mdMVP、功能、边界、异常流程明确Stage 2设计产品原型executing-plans、using-git-worktrees页面流程、Wireframe、Prototype页面结构可指导开发Stage 3完成数据库和系统架构dispatching-parallel-agentsDatabase、Architecture、SQL前后端和数据结构边界清楚Stage 4生成后端工程骨架subagent-driven-developmentbackend/后端目录、模块、基础配置完成Stage 5后端测试闭环test-driven-developmentTest Plan、Unit Test、Integration Test核心接口测试通过Stage 6生成 API 文档executing-plansAPI.md、OpenAPI、Swagger前端可按文档开发Stage 7开发前端工程subagent-driven-development页面、组件、状态、路由页面能调用接口并完成主流程Stage 8前端测试test-driven-developmentFrontend Test Report页面、表单、权限、异常状态通过Stage 9前后端联调systematic-debuggingBug Report、Regression Test联调问题修复并验证Stage 10评审和发布requesting-code-review、receiving-code-review、finishing-a-development-branchPR、Release Note、TagReview 完成版本可发布五、推荐 Skills 功能速查下面这张表可以作为以后做 Vibe Coding 项目时的 Skills 选择指南。如果某个工具环境里没有对应 Skill也可以把“功能说明”和“典型产出”改写成 Prompt让 AI 按同样的工作方式执行。Skill核心功能适用阶段典型产出使用注意using-superpowers加载 Superpowers 工作方式提醒 AI 优先使用合适的 Skills而不是直接自由发挥。Stage 0、每次新会话开始技能调用意识、项目工作约束适合放在项目初始化和长期协作规范里保证 AI 每次开工先检查流程。brainstorming通过提问、澄清、方案对比把模糊想法变成明确设计或需求。Stage 0、Stage 1项目方向、PRD、设计方案、范围边界不要急着让 AI 写代码先用它把需求、目标用户、MVP 和边界条件问清楚。writing-plans把已确认的设计或需求拆成可执行的实现计划。PRD 后、架构后、复杂功能开发前Implementation Plan、任务拆分、文件改动清单适合在“已经知道要做什么但还没开始写代码”时使用。executing-plans按计划逐步执行任务并在执行过程中做检查和汇报。Stage 2、Stage 6、计划落地阶段原型、API 文档、按计划完成的实现结果前提是已经有清晰计划不要拿它替代需求分析。using-git-worktrees创建隔离工作区或分支避免原型、实验代码污染主分支。Stage 2、并行实验、风险较高的改动独立 worktree、隔离分支做原型、重构、实验方案时很有用尤其适合不确定的探索。dispatching-parallel-agents把相互独立的任务分派给多个 Agent 并行推进。Stage 3数据库设计、后端架构、前端架构并行产出只适合边界清楚的并行任务不要把强依赖的任务硬拆开。subagent-driven-development将开发任务拆给子 Agent 实现再由主 Agent 汇总和审查。Stage 4、Stage 7后端模块、前端页面、组件、业务代码适合工程量较大的开发阶段每个子任务都要有明确输入和验收标准。test-driven-development按 TDD 思路先写测试再实现代码再重构。Stage 5、Stage 8单元测试、集成测试、Mock 测试、覆盖率报告适合接口、核心业务逻辑、表单、权限等高风险区域。verification-before-completion在阶段结束前检查是否遗漏需求、边界、异常流程或交付物。Stage 1、每个阶段收尾检查清单、遗漏项、修订建议很适合做 Stage Gate确认当前阶段真的可以进入下一阶段。systematic-debugging使用系统化方式复现问题、定位根因、验证修复。Stage 9、Bug 修复阶段Bug Report、Root Cause、Regression Test遇到联调问题时先复现和定位不要凭感觉让 AI 乱改代码。requesting-code-review发起代码评审让 AI 从 bug、风险、测试缺口、架构问题等角度检查代码。Stage 10Code Review Report发布前必须使用重点检查权限、安全、数据一致性和异常处理。receiving-code-review根据评审意见逐条修复并确认每个问题都有处理结果。Stage 10Review Fix Commit、修复说明不要只挑简单意见改高风险问题要优先处理并补测试。finishing-a-development-branch完成分支收尾包括测试、合并、发布准备和版本记录。Stage 10PR、Release Note、Tag、部署说明用于正式发布前的最后检查保证分支不是“写完就扔”。建议记住一个简单规则想清楚需求brainstorming 写执行计划writing-plans 按计划执行executing-plans / subagent-driven-development 写测试闭环test-driven-development 修复杂问题systematic-debugging 发布前审查requesting-code-review receiving-code-review finishing-a-development-branch六、Stage 0项目初始化阶段目标建立项目的基础结构、协作规范和 AI 上下文文件为后续阶段提供稳定起点。前置输入项目名称项目大致方向技术栈初步想法目标运行环境推荐 Skillsusing-superpowersbrainstorming执行步骤创建 Git 仓库。初始化README.md。创建CLAUDE.md或同类 AI 项目记忆文件。创建docs/目录用于保存 PRD、架构、API、测试报告等文档。创建基础目录例如frontend/、backend/、scripts/、tests/。确认技术栈例如前端框架、后端语言、数据库、缓存、部署方式。记录阶段状态和下一步待办。推荐 Prompt请帮我初始化这个 Vibe Coding 项目的开发规范。 项目信息 - 项目名称 - 项目类型 - 目标用户 - 计划技术栈 请输出 1. README.md 初稿 2. CLAUDE.md 项目记忆文件 3. 推荐目录结构 4. 后续开发阶段清单 5. Stage 0 完成检查清单交付物README.md CLAUDE.md docs/ frontend/ backend/ Git 初始化记录完成标准项目目录已经创建。README 能说明项目是什么。AI 项目记忆文件已经包含技术栈、目录约定和工作流。Git 仓库可以正常提交。下一阶段的需求分析已有明确入口。注意事项不要把CLAUDE.md当成摆设。每完成一个阶段都应该更新其中的当前进度、交付物、待办事项和关键决策。七、Stage 1需求分析PRD阶段目标把模糊想法整理成可执行的产品需求文档明确要做什么、不做什么、先做什么。前置输入项目想法目标用户核心使用场景初步功能列表推荐 Skillsbrainstormingverification-before-completion执行步骤使用brainstorming和 AI 讨论需求边界。明确目标用户、核心场景、业务流程和 MVP 范围。输出 PRD 初稿。使用verification-before-completion检查遗漏功能、边界条件和异常流程。根据检查结果修订 PRD。将 PRD 保存到docs/01-PRD.md。推荐 Prompt请基于以下项目描述帮我输出一份完整 PRD。 项目描述 【在这里填写项目背景和想法】 PRD 需要包含 1. 项目背景 2. 目标用户 3. 用户痛点 4. 核心功能模块 5. 页面流程 6. 非功能需求 7. MVP 范围 8. 暂不实现的功能 9. 边界场景和异常流程 10. Stage 1 完成检查清单交付物docs/01-PRD.md完成标准功能范围清晰。MVP 边界明确。页面流程和用户路径可描述。异常流程和边界条件已经列出。后续原型设计可以直接基于 PRD 展开。注意事项PRD 未确认前不要直接写代码。AI 编程最常见的返工通常都来自需求阶段没有说清楚。八、Stage 2产品原型设计阶段目标基于 PRD 设计页面结构、用户流程和关键交互让开发前先看见产品形态。前置输入docs/01-PRD.mdMVP 功能范围用户路径推荐 Skillsexecuting-plansusing-git-worktrees执行步骤根据 PRD 梳理页面清单。为每个页面定义核心功能和入口出口。设计用户流程例如登录、创建、编辑、提交、查询、管理等路径。输出 Wireframe 或低保真原型。如果需要写原型代码建议放到独立分支或 worktree避免污染主分支。评审原型是否覆盖 PRD 中的主流程和异常流程。推荐 Prompt请根据以下 PRD设计产品原型方案。 输入 - PRD 内容 【粘贴 docs/01-PRD.md】 请输出 1. 页面清单 2. 页面之间的跳转关系 3. 每个页面的核心区域 4. 关键用户流程 5. Wireframe 文本草图 6. 原型开发建议 7. Stage 2 完成检查清单交付物页面结构说明 页面流程图 Wireframe Prototype完成标准PRD 中的核心功能都能在页面中找到对应入口。页面流程能支撑完整 MVP。关键异常状态有展示方案。前端架构设计可以基于原型继续推进。注意事项原型阶段不要过早追求视觉细节。此阶段的重点是流程正确、信息结构正确、主路径可走通。九、Stage 3数据库与系统架构设计阶段目标完成系统的核心技术设计包括数据库、后端架构、前端架构和关键基础设施。前置输入PRD产品原型技术栈选择业务实体和核心流程推荐 Skillsdispatching-parallel-agents执行步骤将架构设计拆成三个方向并行推进数据库设计、后端架构、前端架构。数据库方向输出 ER 图、表结构、索引设计和初始化 SQL。后端方向输出模块划分、目录结构、权限、缓存、日志、异常处理和部署方案。前端方向输出页面结构、组件划分、路由、状态管理和接口调用规划。汇总三个方向检查边界是否一致。保存架构文档和数据库脚本。推荐 Prompt请根据 PRD 和产品原型帮我完成系统架构设计。 输入 - PRD 【粘贴 PRD】 - 产品原型 【粘贴页面结构和流程】 - 技术栈 【填写技术栈】 请分别输出 1. 数据库设计ER 图、表结构、索引、SQL 2. 后端架构目录结构、模块划分、权限、缓存、日志、异常处理、部署方案 3. 前端架构页面结构、组件划分、路由、状态管理、接口规划 4. 架构风险点 5. Stage 3 完成检查清单交付物docs/02-Database.md docs/03-Architecture.md docs/database.sql完成标准核心业务实体已经建模。表结构和业务流程对应。后端模块边界清楚。前端页面、组件、状态和接口关系清楚。架构文档能指导后续工程开发。注意事项数据库设计和架构设计不要完全交给 AI 一次生成后就直接使用。至少要人工检查实体关系、权限边界、索引合理性和扩展风险。十、Stage 4后端工程开发阶段目标根据 PRD、数据库设计和架构设计快速生成标准后端工程骨架并逐步补充业务逻辑。前置输入PRD数据库设计系统架构设计技术栈和后端框架推荐 Skillssubagent-driven-development执行步骤先生成后端基础工程目录。创建 Controller、Service、Repository、Entity、DTO 等分层结构。添加统一配置、异常处理、中间件、日志和权限基础能力。按模块逐步补充业务代码。每完成一个模块执行基础运行检查。更新项目文档和 Git Commit。推荐 Prompt请根据以下文档生成后端工程骨架。 输入 - PRD 【粘贴 PRD】 - 数据库设计 【粘贴数据库文档】 - 系统架构 【粘贴架构文档】 - 后端技术栈 【填写框架和数据库】 请输出 1. 后端目录结构 2. Controller / Service / Repository / Entity / DTO 划分 3. 配置文件设计 4. 统一异常处理 5. 权限和中间件设计 6. 模块开发顺序 7. Stage 4 完成检查清单交付物backend/ 后端工程目录 基础配置 核心模块代码完成标准后端项目可以启动。目录结构符合架构文档。核心模块已经有清晰分层。基础异常、日志、权限或中间件框架已经建立。可以进入后端测试阶段。注意事项建议先生成脚手架再补业务逻辑。不要让 AI 一次性生成大量业务代码否则排查成本会变高。十一、Stage 5后端测试TDD阶段目标通过测试保证后端接口和核心业务逻辑稳定。前置输入后端工程PRD数据库设计API 初步约定推荐 Skillstest-driven-development执行步骤为核心业务接口编写测试计划。先写失败测试明确期望行为。运行测试确认失败原因符合预期。实现最小业务代码让测试通过。补充异常场景和边界条件测试。重构代码并保持测试通过。输出测试报告。推荐 Prompt请基于以下后端模块帮我设计 TDD 测试方案。 输入 - 模块名称 - 接口列表 - 业务规则 - 异常场景 请输出 1. 测试用例清单 2. 正常流程测试 3. 异常流程测试 4. 边界条件测试 5. Mock 数据设计 6. 覆盖率建议 7. Stage 5 完成检查清单交付物Test Plan Unit Test Integration Test Coverage Report完成标准核心业务接口有测试覆盖。正常流程和异常流程都经过验证。测试可以在本地稳定运行。修复代码后没有破坏已有测试。注意事项测试不是最后补文档。TDD 的价值在于先明确行为再让 AI 实现代码。十二、Stage 6API 文档阶段目标生成标准接口文档让前端开发和联调有明确契约。前置输入后端路由DTOResponse 结构权限规则错误码推荐 Skillsexecuting-plans执行步骤扫描后端 Router、Controller、DTO 和 Response。统一接口路径、请求参数、响应格式和错误码。生成 Markdown API 文档。如项目支持生成 Swagger 或 OpenAPI。让前端依据 API 文档确认字段、状态码和异常响应。将 API 文档纳入 Git 版本管理。推荐 Prompt请根据以下后端接口代码或路由定义生成标准 API 文档。 输入 - Router / Controller 【粘贴代码或路由】 - DTO 【粘贴 DTO】 - Response 【粘贴响应结构】 请输出 1. 接口列表 2. 请求方法和路径 3. 请求参数 4. 响应字段 5. 错误码 6. 鉴权要求 7. Swagger / OpenAPI 建议 8. Stage 6 完成检查清单交付物docs/04-API.md Swagger OpenAPI完成标准每个接口都有请求和响应说明。字段类型明确。错误码和异常响应明确。前端可以不读后端代码仅凭 API 文档进行开发。注意事项API 文档是前后端契约。后端代码变更后要同步更新 API 文档否则联调阶段会大量返工。十三、Stage 7前端开发阶段目标根据 PRD、产品原型、API 文档和前端架构实现前端页面和交互流程。前置输入PRD产品原型API 文档前端架构设计推荐 Skillssubagent-driven-development执行步骤初始化前端工程。根据页面结构创建路由。根据组件划分实现基础组件。封装 API 请求层。实现状态管理。按页面逐步开发主流程。接入 Mock API 或真实 API。更新前端说明文档。推荐 Prompt请根据以下材料生成前端开发计划并实现页面。 输入 - PRD 【粘贴 PRD】 - 产品原型 【粘贴页面说明】 - API 文档 【粘贴 API】 - 前端架构 【粘贴前端架构】 请输出 1. 前端目录结构 2. 路由设计 3. 组件划分 4. 状态管理方案 5. API 请求封装 6. 页面开发顺序 7. Stage 7 完成检查清单交付物frontend/ 页面 组件 状态管理 请求封装 路由配置完成标准核心页面已经实现。主流程可以操作。API 请求层已封装。页面状态、加载态、空状态和错误态有基本处理。可以进入前端测试阶段。注意事项不要把 API 调用散落在每个组件里。建议统一封装请求层降低后续接口调整成本。十四、Stage 8前端测试阶段目标验证页面渲染、交互行为、接口调用和异常状态保证前端主流程可用。前置输入前端工程API 文档Mock 数据产品原型推荐 Skillstest-driven-development执行步骤编写页面渲染测试。编写组件交互测试。使用 Mock API 验证接口调用。覆盖登录、权限、表单、空状态、错误页面等关键场景。运行测试并修复失败项。输出前端测试报告。推荐 Prompt请为以下前端页面设计测试方案。 输入 - 页面名称 - 页面功能 - 组件列表 - API 调用 - 异常场景 请输出 1. 页面渲染测试 2. 组件交互测试 3. Mock API 测试 4. 权限和登录测试 5. 表单校验测试 6. 异常页面测试 7. Stage 8 完成检查清单交付物Frontend Test Report 页面测试 组件测试 Mock API 测试完成标准核心页面可以稳定渲染。关键交互有测试覆盖。API 成功和失败状态都经过验证。登录、权限和表单流程可用。注意事项前端测试不要只测“页面能不能打开”。真正重要的是用户能否完成关键任务以及异常状态是否可恢复。十五、Stage 9前后端联调阶段目标修复前后端集成过程中的问题让系统主流程完整跑通。前置输入后端服务前端工程API 文档测试数据环境配置推荐 Skillssystematic-debugging执行步骤启动前端和后端服务。按用户主流程逐步验证。记录所有联调问题。对每个问题定位根因例如 Token、权限、参数、接口、Redis、数据库、缓存或第三方接口。修复后补充回归测试。输出 Bug Report 和联调完成报告。推荐 Prompt请使用系统化调试方式帮我分析以下前后端联调问题。 问题描述 【填写现象】 已知信息 - 前端请求 - 后端日志 - API 文档 - 数据库状态 - 环境配置 请输出 1. 可能原因列表 2. 最小复现步骤 3. 根因判断 4. 修复方案 5. 回归测试建议 6. Stage 9 完成检查清单交付物Bug Report Root Cause Regression Test 联调完成报告完成标准用户主流程可以完整跑通。已知联调问题全部有处理结论。修复项有回归测试或验证记录。前后端接口契约已经同步。注意事项联调时不要凭感觉改代码。先复现再定位根因再修复再回归验证。十六、Stage 10Code Review 与发布阶段目标完成代码评审、修复评审问题并发布可追溯版本。前置输入已完成联调的代码测试报告API 文档部署说明Git 分支推荐 Skillsrequesting-code-reviewreceiving-code-reviewfinishing-a-development-branch执行步骤使用requesting-code-review发起代码评审。让 AI 或团队成员检查 bug、风险、测试缺口和架构问题。使用receiving-code-review逐条处理评审意见。重新运行测试和关键流程验证。合并分支。生成 Release Note。创建 Tag 或发布版本。更新部署文档和项目状态。推荐 Prompt请对当前项目进行发布前 Code Review。 请重点检查 1. 是否存在明显 bug 2. 是否有安全风险 3. 是否有接口兼容问题 4. 是否有未覆盖测试的关键逻辑 5. 是否有部署风险 6. 是否有文档缺失 请按严重程度输出问题并给出修复建议。交付物Code Review Report Review Fix Commit Release Note PR Tag 部署文档完成标准Code Review 问题已经处理。测试通过。Release Note 已生成。版本号或 Tag 已创建。部署步骤清晰。注意事项不要跳过 Code Review。AI 写出来的代码也需要评审尤其是权限、安全、数据一致性和异常处理部分。十七、每阶段 Git Commit 建议建议每完成一个阶段提交一次Commit Message 可以参考chore: initialize project structure docs: add project PRD docs: add product prototype docs: add database and architecture design feat: scaffold backend project test: add backend api tests docs: add api documentation feat: implement frontend pages test: add frontend tests fix: resolve integration issues chore: prepare release如果某个阶段内容较多可以拆成多个小提交。例如 Stage 3 可以拆为docs: add database design docs: add backend architecture docs: add frontend architecture十八、每个阶段都要更新 CLAUDE.md如果你使用 Claude Code 或其他支持项目记忆的 AI 编程工具建议每个阶段结束时都更新一次CLAUDE.md。建议记录当前阶段 已完成内容 核心交付物 关键决策 Git Commit 待办事项 下一阶段入口这样做的好处是即使中途换会话、换模型、换工具项目上下文也不会完全丢失。十九、Vibe Coding 项目执行检查清单下面这份清单可以在每个新项目开工时复制使用。# Vibe Coding 项目执行检查清单 ## Stage 0项目初始化 - [ ] 创建 Git 仓库 - [ ] 初始化 README.md - [ ] 初始化 CLAUDE.md - [ ] 创建 docs/ 目录 - [ ] 创建 frontend/ 和 backend/ 目录 - [ ] 确认技术栈 - [ ] 提交 Git Commit ## Stage 1需求分析 PRD - [ ] 使用 brainstorming 分析需求 - [ ] 输出 docs/01-PRD.md - [ ] 明确 MVP 范围 - [ ] 检查异常流程和边界问题 - [ ] 使用 verification-before-completion 复查 - [ ] 提交 Git Commit ## Stage 2产品原型设计 - [ ] 输出页面清单 - [ ] 输出页面流程 - [ ] 输出 Wireframe 或 Prototype - [ ] 检查是否覆盖 PRD 主流程 - [ ] 提交 Git Commit ## Stage 3数据库与系统架构 - [ ] 输出数据库设计 - [ ] 输出 database.sql - [ ] 输出后端架构设计 - [ ] 输出前端架构设计 - [ ] 检查实体、接口、页面是否一致 - [ ] 提交 Git Commit ## Stage 4后端工程开发 - [ ] 生成后端工程骨架 - [ ] 创建 Controller / Service / Repository / Entity / DTO - [ ] 添加配置、异常、日志、权限基础能力 - [ ] 后端项目可以启动 - [ ] 提交 Git Commit ## Stage 5后端测试 - [ ] 编写测试计划 - [ ] 编写单元测试 - [ ] 编写集成测试 - [ ] 覆盖正常流程和异常流程 - [ ] 测试通过 - [ ] 提交 Git Commit ## Stage 6API 文档 - [ ] 扫描 Router / DTO / Response - [ ] 输出 docs/04-API.md - [ ] 生成 Swagger 或 OpenAPI - [ ] 前端确认接口契约 - [ ] 提交 Git Commit ## Stage 7前端开发 - [ ] 初始化前端工程 - [ ] 创建路由 - [ ] 创建组件 - [ ] 封装 API 请求 - [ ] 实现状态管理 - [ ] 主流程页面可操作 - [ ] 提交 Git Commit ## Stage 8前端测试 - [ ] 编写页面测试 - [ ] 编写组件测试 - [ ] 编写 Mock API 测试 - [ ] 覆盖登录、权限、表单、异常页面 - [ ] 测试通过 - [ ] 提交 Git Commit ## Stage 9前后端联调 - [ ] 启动前后端服务 - [ ] 跑通用户主流程 - [ ] 记录联调问题 - [ ] 定位 Root Cause - [ ] 修复并添加回归测试 - [ ] 输出联调完成报告 - [ ] 提交 Git Commit ## Stage 10Code Review 与发布 - [ ] 发起 Code Review - [ ] 修复评审问题 - [ ] 重新运行测试 - [ ] 生成 Release Note - [ ] 创建 PR / Tag / Release - [ ] 更新部署文档 - [ ] 提交 Git Commit二十、一句话记住整个流程初始化 ↓ 需求 PRD ↓ 产品原型 ↓ 数据库 架构 ↓ 后端开发 ↓ 后端测试 ↓ API 文档 ↓ 前端开发 ↓ 前端测试 ↓ 前后端联调 ↓ Code Review ↓ 发布二十一、总结Vibe Coding 的重点不是“让 AI 多写代码”而是“让 AI 在正确的流程里写代码”。真正稳定的 AI 项目开发应该做到每个阶段有文档每个阶段有交付物每个阶段有完成标准每个阶段有 Git 记录关键逻辑有测试发布前有 Review。按照这套 Workflow 执行AI 编程会从一次性的代码生成变成可持续推进、可复盘、可协作的工程流程。
 KMP全栈进阶：端侧离线Gemini Nano AI Agent工程实战（脱离云端API）)
