---
url: /blog/47iapnpw/index.md
---
![](./assets/Vibe%20Coding%20开发技巧/image.png)

> 转自：https://linux.do/t/topic/1700254

# AI 大型项目编程方法论

## 一、核心原则

### 角色分工

AI辅助编程采用双角色分工模式：

| 角色          | 职责                    | 适合的模型                                                               |
| :---------- | :-------------------- | :------------------------------------------------------------------ |
| **规划/评审模型** | 需求分析、方案设计、质量评审、优化清单输出 | 强推理、长上下文的模型（Claude 4 Sonnet/Opus、GPT-4o、Gemini 2.5 Pro、DeepSeek R1） |
| **执行/编码模型** | 代码实现、功能开发、文档输出        | 代码生成快、指令跟随准的模型（Cursor集成Claude/GPT、Copilot、Codex、DeepSeek V3）        |
|             |                       |                                                                     |

### 循环迭代

AI输出 → 评审 → 优化清单 → 再执行 → 评审 → ...

反复迭代直到收敛（优化清单为空或测试全部通过）。

### 文档驱动

每个阶段产出对应文档，作为下一阶段的输入和评审依据。

***

## 二、新项目开发流程

### 阶段1：需求定义

**目标**：产出经过充分讨论和对比的需求文档。

**步骤**：

1. **需求对话**：与规划/评审模型（Claude 4、GPT-4o等）来回对话，逐步明确需求，形成需求文档初稿。

2. **竞品对比**：让规划/评审模型搜索并对比网络上相关项目，找出当前需求文档的不足之处。

3. **需求定稿**：根据对比结果完善需求，形成最终版需求文档。

**产出**：需求文档（定稿）

***

### 阶段2：技术设计

**目标**：产出可执行的技术实现文档。

**步骤**：

1. **技术方案生成**：将需求文档交给规划/评审模型，让其输出技术实现文档（架构设计、技术选型、模块划分等）。

2. **文档归档**：将需求文档和技术实现文档放入项目文件夹，作为后续开发的输入。

**产出**：技术实现文档

***

### 阶段3：周期开发

**目标**：将整体开发拆分为多个可控的小周期，逐个完成。

**步骤**：

1. **初始化环境**：进入项目文件夹，启动执行/编码模型（Cursor、Codex等）。

2. **周期拆分**：让执行/编码模型读取需求文档和技术文档，将整体开发拆分为多个开发周期，并输出每个周期的开发文档。

3. **逐周期开发**：执行/编码模型按开发周期文档逐个完成开发任务。

4. **周期循环**：当前周期完成后，进入下一个周期，直到所有周期完成。

**产出**：各周期开发文档、项目代码

***

### 阶段4：迭代优化（核心循环）

**目标**：通过多轮评审-优化循环，使代码质量收敛到可接受水平。

**步骤**：

1. **功能文档生成**：执行/编码模型根据当前项目结构和代码，输出完整的功能流程文档。

2. **评审对比**：将功能流程文档交给规划/评审模型，让其与原始需求文档和技术文档对比，找出差距，输出优化清单。

3. **按清单优化**：执行/编码模型按优化清单逐项修改代码。

4. **更新文档**：优化完成后，执行/编码模型更新功能流程文档。

5. **循环判断**：

   * 若优化清单仍有未完成项 → 回到步骤3
   * 若规划/评审模型评审后仍给出新优化清单 → 回到步骤2
   * 若优化清单为空 → 进入下一阶段

**产出**：优化后的代码、更新后的功能流程文档

***

### 阶段5：测试验收

**目标**：通过多轮测试-修复循环，确保功能可靠性和完整性。

**步骤**：

1. **测试清单生成**：规划/评审模型根据需求文档和功能流程文档，输出测试清单（功能可靠性、完整性、边界情况等）和测试流程。

2. **按清单排查**：执行/编码模型按测试清单逐项排查，输出排查结果。

3. **结果评审**：将排查结果交给规划/评审模型，让其评估是否通过，并输出下一轮测试清单。

4. **循环判断**：

   * 若仍有未通过的测试项 → 执行/编码模型修复，回到步骤2
   * 若规划/评审模型给出新的测试清单 → 回到步骤2
   * 若测试清单全部通过 → 流程结束

**产出**：测试通过的完整项目

***

## 三、老项目修改流程

### 阶段1：项目理解

**目标**：让AI理解现有项目结构，产出功能流程文档。

**步骤**：

1. **项目读取**：让执行/编码模型读取整个项目代码。

2. **功能文档生成**：执行/编码模型输出项目的功能流程文档。

   * 若是微服务架构：每个服务单独运行此流程，产出各服务的功能流程文档。

**产出**：项目/各服务的功能流程文档

***

### 阶段2：修改规划

**目标**：根据修改需求，产出分模块的修改文档。

**步骤**：

1. **修改文档生成**：将功能流程文档和修改需求交给规划/评审模型，让其输出修改文档。

   * 修改文档需按功能模块拆分。
   * 若是微服务架构：为每个服务生成对应的修改文档。
2. **开发文档拆分**：将修改文档交给执行/编码模型，让其拆分为每个功能模块的独立开发文档。

**产出**：各功能模块的修改文档、开发文档

***

### 阶段3：模块开发（核心循环）

**目标**：逐个功能模块完成修改，每个模块都经过完整的优化循环。

**步骤**（针对单个功能模块）：

1. **模块修改**：执行/编码模型按该模块的开发文档进行代码修改。

2. **模块文档生成**：修改完成后，执行/编码模型输出该模块的完整功能流程文档。

3. **评审对比**：将模块功能流程文档和模块修改文档交给规划/评审模型，让其对比差距，输出优化清单。

4. **按清单优化**：执行/编码模型按优化清单逐项修改。

5. **循环判断**：

   * 若优化清单仍有未完成项 → 回到步骤4
   * 若规划/评审模型评审后仍给出新优化清单 → 回到步骤3
   * 若优化清单为空 → 进入该模块的测试阶段

6. **模块测试**：

   * 规划/评审模型输出该模块的测试清单
   * 执行/编码模型按清单排查
   * 循环直到测试全部通过

7. **下一模块**：当前模块完成后，回到步骤1，开始下一个功能模块。

**产出**：各模块修改后的代码、模块功能流程文档

***

### 阶段4：测试验收

**目标**：整体测试所有修改模块的集成效果。

**步骤**：

1. **集成测试清单**：规划/评审模型输出跨模块的集成测试清单。

2. **集成测试执行**：执行/编码模型按清单排查，输出结果。

3. **循环修复**：直到所有集成测试通过。

**产出**：测试通过的完整项目

***

## 四、流程概览图

```
┌─────────────────────────────────────────────────────────────┐
│                      新项目开发流程                           │
├─────────────────────────────────────────────────────────────┤
│  需求定义 → 技术设计 → 周期开发 ⇄ 迭代优化 → 测试验收        │
│                         ↑____________↓                       │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│                      老项目修改流程                           │
├─────────────────────────────────────────────────────────────┤
│  项目理解 → 修改规划 → 模块开发(循环) → 测试验收             │
│                    ↑___各模块依次完成___↓                    │
└─────────────────────────────────────────────────────────────┘
```