AI编程全流程实战教程 · 从立项到交付

AI

AI编程实战教程 · 完整开发流程

AI编程全流程实战教程

四步立地基 · 两步控执行 · 完整实战案例

6

核心步骤

5

完整案例

3

避坑指南

1

可复用模板

↓ 点击任意位置或按空格键翻页

开篇 · 痛点共鸣

你是不是也这样用AI做项目？

❌ 踩坑做法

坐到电脑前，脑子里一堆想法，不知道从哪下手。干脆甩一句："帮我做个电商系统"，剩下的全扔给AI。

结果AI越写越乱，自己心里越来越没底。改了好几轮，代码越来越乱，最后要么重构，要么放弃。

✅ 正确做法

先走完四步地基流程：立项清单 → 选技术栈 → 搭项目架构 → 写Agent宪法。

地基立好之后，再走两步控执行流程：拆实施文档 → 分阶段推进验收。

每一段路AI都走得清清楚楚，你再也不用来回返工。

💡 核心认知

用AI做开发，变的只是开发里的角色——以前产品经理要和程序员对需求，现在AI就是你的程序员，所以你也一定要和AI把需求对的明明白白。任何时候，模糊不清的需求都是危险的。

全流程总览

六大步骤：从想法到交付

① 立项清单

→

② 技术选型

→

③ 项目架构

→

④ Agent宪法

┃ 地基阶段（动工前） ┃

↓

┃ 实施阶段（动工后） ┃

⑤ 拆实施文档

→

⑥ 分阶段推进

→

✓ 项目交付

⚙ 前四步（地基）

决定项目的方向和规则。地基一旦打好，后面尽量别回头翻。

⚙ 后两步（执行）

控制AI的执行过程。让AI始终有文档可对、有边界可守。

学习路线图

一图看懂整个开发流程

📋

01 · 立项与功能清单

想清楚做什么，拆成一条条功能

⚙️

02 · 技术选型

选最适合项目和AI的技术栈

🏗️

03 · 搭项目架构

搭一个能跑的最小架子，定好规则

📜

04 · 写Agent宪法

定下AI的行为规范和守则

📄

05 · 拆实施文档

大阶段拆成可执行的详细步骤

🎯

06 · 分阶段推进

一阶段一验收，防止AI跑偏

🎯 学习建议

零基础：先看完所有概念，再跟着案例练习
有基础：直接挑一个案例跟着做
核心记住：别让AI凭感觉写，要让它始终有文档可对、有边界可守

01

第一步 · 立地基

立项与
功能清单

这是整个流程的起点，也是最容易被跳过的一步。想清楚做什么，拆成一条条可执行的功能，后面AI才不会全凭猜测写代码。

项目定位功能拆解优先级排序案例实训

第一步 · 立项与功能清单

立项说白了：先想清楚要做啥

立项就是先想清楚这个项目到底要做什么。功能清单是再往下拆，拆成一条条说得清清楚楚的功能。

⚠ 关键提醒

这一步要是糊弄过去，后面很容易返工——因为你都不知道你需要什么，AI写项目时基本全靠猜。你和AI之间的需求必须对的明明白白。

功能清单的标准写法

          用户角色：买家、卖家、管理员

          模块一 · 用户系统：注册、登录、找回密码、个人信息编辑

          模块二 · 商品系统：商品发布、商品列表、商品搜索、商品详情

          模块三 · 订单系统：购物车、下单、支付、订单查询、订单管理

          模块四 · 管理系统：用户管理、商品管理、订单管理、数据统计

❌ 错误示范

          「帮我做个电商系统」

          → AI不知道要什么功能，瞎猜着做，做出来一堆没用的

✅ 正确示范

          「我要做一个二手书交易平台，

           买家功能：浏览、搜索、下单、支付、评价

           卖家功能：发布商品、管理订单、查看收益

           管理员功能：审核商品、用户管理、数据看板」

          → AI明确知道要做什么，不会过度发挥

💡 给AI的提示词模板

          你是产品经理，帮我梳理一个[项目名称]的

          功能清单，包含：

          1. 所有用户角色

          2. 每个角色的核心功能

          3. MVP（最小可用版本）的功能范围

          4. 建议的开发阶段划分

第一步 · 实操案例

完整案例：二手书交易平台 · 立项

假设我们要做一个二手书交易平台。以下是与AI协作完成立项的全过程：

📋

第一次对话：明确项目定位

向AI描述项目背景

「我想做一个二手书交易平台，主要面向大学校园。学生可以在上面买卖二手教材和课外书。帮我梳理一下这个项目的核心功能清单，要求包含所有用户角色和对应的功能列表。」

AI 回复摘要

角色：买家、卖家、管理员
MVP功能：用户注册/登录、商品发布/浏览/搜索、站内聊天、下单
二期功能：支付接入、评价系统、推荐算法
三期功能：积分系统、社交分享、数据分析

✏️

第二次对话：细化功能清单

要求AI将功能拆得更细

「把每个功能再拆细一些，比如商品发布包含什么步骤？搜索支持哪些筛选条件？MVP阶段先做哪些？给我一份表格形式的详细功能清单。」

追问优化阶段划分

02

第二步 · 立地基

技术选型

项目要做什么定下来了，接着就得定用什么来做。关键是选最适合这个项目、AI也最熟的，定了就别来回摇摆。

前端选型后端选型数据库 AI适配

第二步 · 技术选型

选技术栈：合适 > 高级

选技术栈的关键不是挑最高级、最厉害的，而是挑最适合这个项目、AI也最熟的。

选型三原则

1️⃣

项目匹配度：小程序用uni-app，后台管理用React/Vue，API用Python/Node

2️⃣

AI熟悉度：React/Next.js/Vue/Python这些AI训练数据多，代码质量高

3️⃣

生态成熟度：选社区活跃、文档完善的技术栈，AI参考资料多

⚠ 最忌讳的事

技术栈定下来之后，千万别来回摇摆。前端今天React明天Vue，后端今天Python明天Go——每摇摆一次，前面的地基就得跟着重打一次。

💡 让AI帮你选型

          我想做一个[项目类型]，

          目标用户是[用户描述]，

          核心功能有[功能列表]。

          请帮我推荐技术栈，要求：

          1. AI最熟悉、写的最好的技术

          2. 社区活跃、文档完善

          3. 适合快速开发MVP版本

          ---

          给出3个方案并说明优缺点

💡 小技巧

如果你没有技术背景，把上面的提示词直接发给AI，让它帮你做选型分析。但要记住：选了就别改。

第二步 · 实操案例

案例：二手书平台 · 技术选型

向AI提问，让它帮你完成技术选型分析：

⚙️

完整选型对话：让AI推荐技术栈

「我要做一个大学校园二手书交易平台的Web端，有买家、卖家、管理员三个角色。核心功能包括：用户注册登录、商品发布浏览搜索、站内聊天、下单支付、后台管理。请帮我推荐技术栈，要求：AI最熟悉的、能快速开发MVP、社区活跃。列3个方案对比优缺点。」

推荐方案（摘要）

前端

React + Next.js

后端

Python FastAPI

数据库

PostgreSQL + Redis

选型理由：React/Next.js是AI训练数据最丰富的前端框架；Python是AI最擅长的语言；PostgreSQL生态完善、AI写SQL质量高。

03

第三步 · 立地基

搭项目
架构

技术栈定了，下一步是搭项目架构。就像盖楼一样——你不会一上来就冲进去装修，而是先立好地基框架、承重墙。

后端骨架前端骨架目录规范通用规则

第三步 · 搭项目架构

搭骨架：先从能跑的最小架子开始

不是让AI一上来就把登录、订单、支付这些功能全写出来——而是先搭一个最小好的能跑起来的架子，把通用规则先定下来。

后端需要先搭的

✓ 项目能启动、配置能读 ✓ 接口返回格式统一 ✓ 错误处理统一 ✓ 日志系统 ✓ 数据库连接 ✓ 权限认证入口

前端需要先搭的

✓ 目录怎么分 ✓ 组件怎么规范 ✓ HTTP请求怎么统一封装 ✓ 状态怎么管理 ✓ 路由怎么配置

💡 给AI的指令模板

          请帮我搭建[项目名]的初始项目骨架。

          技术栈：[前端/后端技术]

          要求：

          1. 先不要实现任何业务功能

          2. 搭一个最小可运行的项目结构

          3. 统一接口返回、错误处理规范

          4. 配置好数据库/状态管理

          5. 设计好目录结构

          6. 告诉我这个架子怎么验证是否稳固

🎯 判断标准

一个稳固的架子应该是：后续每加一个新功能，都按照同一套规则来写，不需要单独为新功能调整架构。

第三步 · 实操案例

案例：让AI搭建项目骨架

以下是与AI的完整对话，让它为二手书平台搭建项目骨架：

🏗️

完整对话：搭建项目初始骨架

「请帮我为二手书交易平台搭建后端项目骨架。

技术栈：Python FastAPI + PostgreSQL + Redis

要求：
1. 不要实现任何业务功能（不要写用户、商品、订单等）
2. 能正常启动运行
3. 统一接口返回格式：{code, message, data}
4. 统一错误处理，全局异常捕获
5. 配置好数据库连接（SQLAlchemy）
6. Redis缓存连接配置
7. 日志配置（按天分割）
8. 健康检查接口 /health
9. 设计好目录结构，每一层说明用途
10. 告诉我怎么验证这个骨架是否正常」

AI 生成的目录结构示例

            booktrading/

             ├── app/

              ├── api/   # 路由层

              ├── core/   # 配置、数据库、安全

              ├── models/  # 数据库模型

              ├── schemas/  # Pydantic模型

              ├── services/  # 业务逻辑层

              ├── utils/   # 工具函数

             ├── tests/

             ├── logs/

             ├── requirements.txt

             ├── main.py   # 应用入口

04

第四步 · 立地基

Agent
宪法

写给AI的项目规矩——做什么功能都得遵守的那套行为准则。让AI不自由发挥、不乱改架构、不乱加依赖。

宪法是什么放哪里通用模板项目定制

第四步 · Agent宪法

Agent宪法：让AI不乱来的规矩

Agent宪法就是写给AI的项目规矩。它不是什么摆设——AI编程工具会自动把这份文件读进上下文，每次开工前自动默念一遍，实实在在影响AI的每一次判断。

📜 宪法里写什么？

✓ 必须遵守架构设计文档
✓ 要改底层、换框架、加新依赖，先说明原因
✓ 能用框架自带能力就别自己手写一套
✓ 每个阶段做完先自己检查一遍
✓ 代码必须有注释
✓ 不要删改未指定的代码

📁 放对位置才生效

不同的AI工具要求的位置和文件名不一样。最稳的方法是直接问AI：「请在当前工具会自动读取的位置，帮我创建Agent宪法文件」

🎯 把通用模板定制给本项目

          请根据当前项目的真实情况，

          深度结合这份宪法模板，

          从中制定一份专属于本项目的Agent宪法。

          关键：结合项目真实情况——功能清单、技术栈，把通用规则落到你的项目上。

💡 定制完一定要做

定制定完之后，看一眼。有看不懂的地方，直接让AI用大白话给你讲清楚每一条到底在管什么。不要装懂。

第四步 · 实操案例

案例：为二手书平台定制Agent宪法

📜

完整对话：创建Agent宪法

「请在当前工具会自动读取的位置，帮我为本项目创建Agent宪法文件。

项目信息：
- 项目：大学校园二手书交易平台
- 前端：React + Next.js
- 后端：Python FastAPI
- 数据库：PostgreSQL + Redis
- 项目架构已搭建完成，在 /backend 和 /frontend 目录下

宪法的核心原则：
1. 所有修改必须先参照架构文档
2. 新增依赖必须说明理由
3. 每个功能完成后必须自检
4. 代码必须包含中文注释
5. 不得擅自修改目录结构
6. 遵守统一的接口返回格式和错误处理规范」

生成的宪法部分内容（CLAUDE.md示例）

            # Agent宪法 - 二手书交易平台

            ## 项目约束

            - 目录结构由架构文档定义，不得擅自新增/删除/移动顶层目录

            - 新增Python依赖必须写入requirements.txt并说明用途

            ## 代码规范

            - 所有接口返回遵循统一格式：{"code":0,"message":"ok","data":{}}

            - 函数/类必须写docstring

            - 关键逻辑必须写中文注释

            - 错误信息必须是中文

            ## 执行规则

            - 每个功能实现后必须执行自检

            - 修改数据库模型必须同步更新迁移文件

地基阶段 · 小结

地基立好了吗？回顾四步

📋

STEP 01

立项与功能清单

想清楚做什么，拆成一条条功能

⚙️

STEP 02

技术选型

选最合适的，定了就别摇

🏗️

STEP 03

搭项目架构

先搭骨架再填业务

📜

STEP 04

Agent宪法

定规矩管住AI不乱来

记住一条底线

地基一旦打好，后面就尽量别再回头翻它了。至于为什么不能翻、翻了代价有多大——后面讲实施阶段时会说到。

05

第五步 · 控执行 · 核心环节

拆解实施
真源文档

地基立好了，接下来才是真正让AI写代码。但别急着开工——先把大阶段拆成一份足够细的实施文档，这是防止AI跑偏的第一道防线。

拆子阶段细到可执行验收标准单一可信源

第五步 · 拆实施文档

为什么大阶段还要再拆一层？

大阶段通常都很粗。比如「阶段一：实现买家下单功能」——这一句话丢给AI，它会自己脑补先做什么后做什么，脑补出来的往往不是你要的。而且AI真的会偷懒。

💡 核心概念：实时真源文档

这是每个大阶段的「单一可信来源」——开发以这份文档为准，验收也以这份文档为准。聊天里临时冒出来的想法不是不能改，但要先回写到文档里才算正式变更。

一份好的实施文档长这样

          子阶段1.1：用户注册功能

           步骤1：创建用户注册API接口

           步骤2：实现邮箱/手机号验证

           步骤3：密码加密存储

           验收标准：能正常注册、重复邮箱报错

           暂不处理：第三方登录

          子阶段1.2：用户登录功能

           步骤1：创建登录API

           步骤2：JWT Token签发与验证

           验收标准：登录成功返回Token、失败有提示

🎯 让AI帮你拆解

          请根据功能清单和阶段计划，

          将当前大阶段 [阶段名称]

          细化成一份详细的实施真源文档：

          1. 先拆成几个子阶段

          2. 每子阶段拆成更小步骤

          3. 逐条说明每一步做什么、做到什么程度、涉及哪些功能

          4. 验收标准是什么、用什么方式验证

          5. 明确哪些暂时不做什么

          先不要写代码，先输出文档。

⚠ 重要提醒

不用一次性把所有大阶段都拆完。后面的阶段可以先保留大方向，只拆当前要做的这个阶段就够了——因为项目做着做着需求很可能会变。

第五步 · 实操案例

案例：拆解「用户系统」阶段

向AI发出指令，让它把「用户系统」这个大阶段拆成详细的实施文档：

📄

完整对话：拆解大阶段为实施文档

「请根据功能清单和阶段计划，把【阶段一：用户系统】细化成一份详细的实施真源文档。

要求：
1. 先拆成子阶段（注册、登录、个人信息）
2. 每个子阶段再拆成可执行的具体步骤
3. 每个步骤要说明做什么、做到什么程度
4. 每个子阶段要有验收标准
5. 明确哪些功能先不做（如第三方登录、邮箱验证）
6. 技术栈：FastAPI + PostgreSQL
7. 先不要写代码，只输出文档」

AI 生成的实施文档结构（部分）

            # 阶段一：用户系统 - 实施真源文档

            ## 子阶段1.1：用户注册

            步骤1：创建 User 数据库模型

             - 字段：id, username, email, password_hash, avatar, created_at

             - 密码使用 bcrypt 加密存储

            步骤2：创建注册 API /api/v1/auth/register

             - 接收：username, email, password

             - 校验：邮箱唯一性、密码强度（6位以上）

             - 返回：用户基本信息 + 成功提示

            暂不处理：邮箱验证、短信验证

            验收：调用注册API能成功创建用户，重复邮箱返回400错误

            ## 子阶段1.2：用户登录

            步骤1：创建登录 API /api/v1/auth/login

             - 接收：email, password

             - 验证密码是否正确

            步骤2：JWT Token 签发

             - 返回 access_token + refresh_token

             - Token 有效期24小时

06

第六步 · 控执行 · 最关键一步

分阶段
推进验收

这是防止AI跑偏的最后一道防线。让AI一阶段一阶段往前推，每完成一个子阶段就停下来汇报验收——绝不让AI一口气做完所有事。

防漂移分步验收边界控制三问验收法

第六步 · 分阶段推进

最大的坑：AI写着写着就漂移了

AI写着写着很容易脱离你定的计划——要么自由发挥加一堆没让你要的东西，要么该做的漏了、不该做的多做了一截。这就是漂移。

防漂移的核心方法

每个子阶段开工前，给AI一句明确的指令把它框住：

「严格遵守Agent宪法和实施真源文档，只实施当前子阶段，不要超出范围，做完后停下来汇报，不要自动进入下一个子阶段。」

一句话说清楚

这段话就是在给AI划两条边界：怎么做事（宪法管）以及这次具体做什么（文档管）。两边都有据可依，就不容易乱跑。

🎯 验收三问（不用看懂代码）

第一问

对照实施文档，这个阶段哪些做完了，哪些没做完？

第二问

你到底改了哪些地方？有没有漏做、有没有多做？

第三问

你怎么验证的？验证结果是什么？下一个该做哪个子阶段？

💡 看不懂代码怎么办？

直接让AI用大白话一条条解释给你听。如果它说的和文档对不上，说明理解已经偏了，先拉回来再继续。

第六步 · 实操案例

案例：阶段推进与验收全流程

以下是与AI的完整交互流程，展示一个子阶段的推进与验收：

🚀

步骤1：下达指令

「请开始实施真源文档中的子阶段1.1：用户注册功能。

严格遵守Agent宪法和实施真源文档，
只实施当前子阶段，不要超出范围，
做完后停下来汇报，不要自动进入下一个子阶段。

真源文档路径：/docs/phase-1-user-system.md」

1

关键点：明确当前只做「用户注册」这一个子阶段，划好边界

✅

步骤2：验收环节

「子阶段做完了？请汇报三件事：

1. 对照实施文档，哪些做完了、哪些没做完？
2. 改了什么文件、有没有漏做或多做？
3. 怎么验证的？验证结果是什么？
下一个该做哪个子阶段？」

AI 验收报告示例

✅ 已完成：创建User模型、注册API、密码加密
❌ 未完成：邮箱格式校验（依赖第三方库未安装）
📁 修改文件：models/user.py, api/auth.py, schemas/user.py
🔍 验证方式：启动服务调用注册API，成功返回用户信息
➡ 下一步：子阶段1.2 - 用户登录功能

防漂移 · 进阶

漂移了怎么办？三步纠偏

当你发现AI汇报的下一步和文档里写的对不上，说明已经偏了。别慌，三步拉回来：

🛑

第一步：立即停止

让AI停下来，不要继续往下做。明确告诉它偏离了计划。

📋

第二步：对照文档纠偏

让AI重新阅读实施真源文档，用大白话告诉你它理解错了什么，以及应该怎么做。

🔄

第三步：确认后继续

确认AI的理解无误后，让它从偏离的地方回退，按正确方向重新推进。

💡 纠偏对话模板

          「你偏离了计划。

          你刚才做了 [AI实际做的]，

          但文档要求的是 [文档要求的]。

          请重新阅读实施真源文档，

          然后用大白话告诉我：

          1. 你哪里理解错了？

          2. 正确的做法应该是怎样的？

          3. 需要回退哪些修改？

          确认无误后再继续。」

⚠ 最危险的心态

「先满足需求再说，后面再改」——千万别这样！你一旦只顾着满足需求，AI很可能为了照办，转头就把你的项目架构给破坏了。到那时前面四步地基可能全白做了。

综合案例 · 全流程

二手书平台：完整开发时间线

第1天

📋 立项 + 功能清单

用AI梳理需求：二手书交易平台，确定用户角色和MVP功能范围。产出：功能清单文档。

第2天

⚙️ 技术选型 + 项目架构

让AI推荐技术栈并搭建前后端项目骨架。产出：可运行的项目代码 + 架构文档。

第3天

📜 Agent宪法

基于宪法模板+项目情况，让AI定制专属Agent宪法。产出：CLAUDE.md宪法文件。

第4-6天

📄 阶段一：用户系统

拆实施文档 → 子阶段1.1注册（推进+验收）→ 子阶段1.2登录（推进+验收）→ 子阶段1.3个人信息（推进+验收）

第7-12天

📄 阶段二：商品系统

拆实施文档 → 子阶段逐一推进+验收 → 商品发布/浏览/搜索

第13-18天

📄 阶段三：订单+支付

拆实施文档 → 购物车/下单/支付对接 → 每一步验收

第19天

🎉 交付 + 测试

全流程测试，修复Bug，部署上线

避坑指南

三个最容易踩的坑

⚠

坑一：需求模糊就开工

「帮我做个某某系统」一句话就开工。AI全凭猜测，做出来的东西要么不对、要么返工重来。

解法：先走完立项四步，把功能清单一条条写清楚再开工。

⚠

坑二：技术栈来回摇摆

今天用React明天换Vue，今天Python明天Go。每换一次，前面的架构和代码就要重写一次。

解法：选型前让AI出3个方案对比，选了就不要换。

⚠

坑三：不验收就继续推进

让AI一口气做完好几个子阶段，结果做完了才发现方向偏了，全部白做。

解法：每完成一个子阶段，必须用「验收三问」检查完再进入下一个。

核心一句话：别让AI凭感觉写，要让它始终有文档可对、有边界可守。你不懂代码，也能用文档和验收证据把方向抓在自己手里。

总结回顾

一张图记住整个流程

📋 立项清单

→

⚙️ 技术选型

→

🏗️ 项目架构

→

📜 Agent宪法

↑ 四步立地基：动工前做好的准备 ↑

↓ 两步控执行：动工后的节奏管理 ↓

📄 实施文档

→

✅ 阶段推进

→

🎉 交付

上篇 · 地基（前四步）

想清楚做什么 · 选对技术 · 搭好架构 · 定好规矩

下篇 · 执行（后两步）

拆成详细步骤 · 分阶段推 · 每步验收 · 防止漂移

核心原则：别让AI凭感觉写，要让它始终有文档可对、有边界可守

干

开始你的
第一个AI项目

六步流程记在心里，打开AI就开始做
你不是一个人在战斗

📦

今日资源包

立项清单模板 · 技术选型指南 · Agent宪法模板 · 实施文档模板 · 验收三问速查卡

💡

回去就做这一件事

选一个你一直想做但没动手的项目，用今天学的六步流程走一遍。哪怕只完成第一第二步，也比之前强。

📋 立项清单 ⚙️ 技术选型 🏗️ 项目架构 📜 Agent宪法 📄 实施文档 ✅ 阶段验收

← 按左箭头可回顾任意页 · 六步在手 · AI项目不愁