# H04 如何让AI先计划、看差异、再执行

适用：全部教材，第3章起

---

## 核心原则

**AI 负责扩大候选方案和加速实施，你负责审查、判断和决定。**

你不是在"用 AI 完成任务"，而是在"与 AI 协同完成任务"。区别在于：你必须理解每一步发生了什么，并对最终结果负责。

## 五段协同留痕

每次重要的 AI 协同，保留以下五段证据：

### 1. 学生原始意图

> 我想完成什么？输入是什么？输出是什么？禁止做什么？

用自然语言写清楚你的目标。例如：
```
我想在跳远预测器的数据入口增加一条校验规则：
身高必须在 140-200cm 之间，超出范围的数据拒绝进入训练集。
只修改数据加载部分，不改模型。
```

### 2. AI方案

> AI 建议怎样做？涉及哪些文件、参数和风险？

把任务说明发给 Qwen Code，它会建议修改方案。记录它建议改什么、为什么这样改。

### 3. 人工审查

> 我接受、拒绝或改写了什么？理由是什么？

查看 AI 建议的修改，逐项判断：
- ✅ 接受：合理且安全
- ✏️ 改写：方向对但细节需要调整
- ❌ 拒绝：不合理、超出范围或有风险

### 4. 实际变更

> 查看差异后批准的最小修改，运行证据

只接受你理解的修改。运行代码，观察输出。如果有错误，让 AI 解释并建议修复，但修复方案仍需你审查。

### 5. 最终判断

> 结果是否达到验收？哪里可靠？哪里需要复核？

用验收标准检查最终结果。诚实地记录：
- 哪些结果是可信的
- 哪些结果需要进一步验证
- 还有什么限制或不确定

## 实际操作流程

```
1. 在 Qwen Code 中打开当前章节项目
2. 用自然语言描述你的任务（第1段：原始意图）
3. 查看 Qwen Code 的修改建议（第2段：AI方案）
4. 逐个审查差异，接受/改写/拒绝（第3段：人工审查）
5. 运行修改后的代码，观察结果（第4段：实际变更）
6. 对照验收标准判断，记录结论（第5段：最终判断）
```

## 什么时候需要完整五段

- **第1-3章**：每次协同都完整训练五段留痕
- **第4章以后**：只对本章最关键的一次修改保存完整五段
- 其他次要修改可以简化为"做了什么 + 结果如何"

## 常见错误

| 错误 | 正确做法 |
|---|---|
| 把 AI 输出直接当结论 | 审查差异，运行验证后再接受 |
| 自动批准所有修改 | 逐个查看，只接受你理解的 |
| 不记录修改理由 | 每次修改都写"为什么改" |
| 只看最终输出不看过程 | 关注中间步骤和数据变化 |
| AI 说"应该没问题"就信了 | 用测试数据验证 |

## 记录格式

可以保存在 `ai_collaboration_log.md` 或 Notebook 的 Markdown 单元格中：

```markdown
## 协同记录 - [日期]

**意图**：[你想做什么]
**AI建议**：[AI建议改什么]
**我的审查**：[接受了什么、拒绝了什么、为什么]
**运行结果**：[改完后的输出]
**判断**：[结果是否达标，还有什么不确定]
```