本文梳理AI辅助软件项目完整六阶段开发流程，涵盖需求分析PRD撰写、UI/UX原型设计、技术架构设计、SDD规范驱动开发、任务拆解实现、测试交付。重点对比AI使用过程中正反案例，厘清什么时候让AI生成代码、什么时候必须人工做决策，记录实操踩坑点与工程最佳实践，方便后续复盘复习。

这周完整过了一遍AI驱动项目开发整套体系，打破了我“直接丢需求给AI就可以出完整项目”的固有认知。AI只是辅助工具，人的分析、决策、校验才是项目的核心，整个项目要按照阶段一步步推进，不能直接跳到写代码环节，踩了不少典型误区，整理成本篇笔记。

一、第一阶段：需求分析与PRD

开发项目不能上来就让AI直接写全部代码，要先做需求访谈。

1. 先描述项目定位、目标用户，让AI扮演产品经理进行多轮访谈；
2. 围绕目标用户、业务场景、业务流程、权限、异常场景抛出问题；
3. 区分MVP必须实现、后续迭代、暂不实现的功能；
4. 访谈结束之后再输出PRD产品需求文档。

⚠️重点：PRD只写入已经确认的需求，拿不准、没有敲定的业务规则统一放到「待确认事项」，不要让AI自行脑补业务逻辑。

❌反面案例：直接甩一句话“帮我做一个校园系统，包含登录注册发布”，让AI一次性输出需求+全部代码。
✅正确做法：描述项目背景，让AI多轮提问挖掘需求，确认清楚业务规则之后，再生成PRD。

二、第二阶段：UI/UX设计与HTML原型

需求文档PRD定稿之后，再进入UI设计环节。

1. 确定系统视觉风格、主辅色调、布局、组件规范；
2. 梳理全部页面清单、页面跳转关系，区分哪些页面需要登录访问；
3. 输出统一设计规范文档DESIGN_SYSTEM.md，定义颜色、字体、按钮、卡片、各种状态样式；
4. 先用原生HTML+CSS+JS + Mock数据做交互原型，验证页面布局、表单、跳转、空数据、报错状态。原型验证没问题，再迁移Vue等正式前端框架。

💡提醒：原型阶段优先保证交互可用，不要一味追求页面炫酷好看。原型没有理顺就直接写框架代码，后期会大量返工。

三、第三阶段：技术架构与工程设计

原型确认完成，开展技术选型与架构设计。

1. 结合项目规模、学习成本、维护难度选定技术栈，输出TECH_STACK.md；
2. 采用前后端分离架构，划分模块、分层，绘制架构图，输出ARCHITECTURE.md、MODULE_DESIGN.md；
3. 数据库设计：梳理数据表、字段、主键外键、索引、业务状态，输出ER图；
4. API契约设计：统一请求前缀、返回格式、分页、鉴权、错误处理；
5. 文档一致性检查：核对PRD、架构、数据库、API契约，保证业务逻辑统一，消除文档冲突。

踩坑：之前做练习，直接跳过架构文档，写完数据库才发现和PRD业务对不上，需要反复修改表结构，浪费大量时间。

四、第四阶段：AI项目规范 SDD与Harness Engineering

这一部分是管控AI开发行为的核心。

• SDD（规范驱动开发）：先写清楚需求与技术规范，再进行编码；执行任务固定流程：明确任务目标→阅读项目文档→分析现有代码→制定方案→编码→测试→更新文档。
• Harness工程约束：建立AGENTS.md作为AI开发工作总纲领，编写任务模板，区分风险等级：
  • 低风险：普通功能、Bug修复，可以直接执行；
  • 高风险：修改数据库、改动架构、修改权限业务规则，必须先输出方案，等待人工确认后再编码。
• 建立ADR架构决策记录、开发日志，重要改动留下记录，做到可追溯。

五、第五阶段：任务拆解与正式开发

不要把整个大项目一次性丢给AI实现。

1. 将大项目拆解成一个个可独立开发、独立测试、独立验收小任务；
2. 开发计划优先跑通一条完整MVP业务闭环；
3. 按照基础工程搭建→用户模块→核心业务模块→后台管理顺序迭代开发；
4. 每完成一个模块，就要做模块测试，不要全部写完再统一测试。

六、第六阶段：测试、修复与项目交付

编码完成不等于项目结束。

1. 编写测试用例，覆盖正常流程、边界场景、越权访问、异常输入，执行完整系统测试，输出测试报告；
2. Bug修复要定位根本原因，而不是只修改表面现象，修复完成执行回归测试；
3. 代码审查：排查重复代码、硬编码敏感信息、安全漏洞；
4. 整理交付README文档，写明项目介绍、技术栈、启动步骤、已知遗留问题。

七、本周踩坑复盘

1. 习惯跳过需求访谈，直接让AI生成全部代码，产出功能和自己预想不一致；
2. 忽略文档一致性，接口字段、数据库字段、PRD业务逻辑出现矛盾；
3. 明知道SDD整套流程，但实操急于写代码，跳过方案分析和文档更新；
4. 测试只测正常操作，忽略异常、边界、越权场景，很多潜在bug发现不了；
5. 分不清任务风险等级，修改数据库表结构没有先输出方案确认。

八、小结

AI是强大的开发辅助工具，但不能完全交给AI全权做主。
项目开发顺序：需求PRD → UI原型 → 架构数据库设计 → SDD规范约束 → 分任务开发 → 测试交付。
前期文档、需求分析工作虽然繁琐，但可以避免后期大规模返工。