AI协作教学指南5.0下部秘籍（狗子更新：2026/2/4，超精华版）
精华02/04377 浏览开发心得
================================================================================
第五部分：文档体系
================================================================================
七、文档分层架构
--------------------------------------------------------------------------------
【7.1 四层文档结构】
┌─────────────────────────────────────────┐
│ 策划层 │
│ 核心设定、基础规则（很少变动） │
└─────────────────────────────────────────┘
↓
┌─────────────────────────────────────────┐
│ 结构层 │
│ 大纲、框架、模块划分 │
└─────────────────────────────────────────┘
↓
┌─────────────────────────────────────────┐
│ 规范层 │
│ 格式规范、检查清单、质量标准 │
└─────────────────────────────────────────┘
↓
┌─────────────────────────────────────────┐
│ 内容层 │
│ 具体内容、详细实现 │
└─────────────────────────────────────────┘
【7.2 ❌ 错误 vs ✅ 正确：目录结构】
❌ 错误结构：
project/
├── 内容.md # 所有内容塞一个文件
├── 设定.txt # 格式不统一
└── 新建文件夹/
问题：
- 没有分层
- 命名混乱
- 找不到东西
✅ 正确结构：
project/
├── docs/
│ ├── 1-策划/ # 核心设定
│ │ └── 核心规则.md
│ ├── 2-结构/ # 框架大纲
│ │ └── 项目大纲.md
│ ├── 3-规范/ # 质量标准
│ │ ├── 格式规范.md
│ │ └── 检查清单.md
│ └── 4-内容/ # 具体内容
│ ├── 第1章/
│ │ ├── README.md # 章节索引
│ │ └── 内容.md
│ └── 第2章/
│ └── ...
优点：
- 分层清晰
- 命名规范
- 一目了然
【7.3 ❌ 错误 vs ✅ 正确：文档格式】
❌ 错误（叙述式）：
这个功能是用来帮助用户完成XXX的，它有三个主要特点，
第一个是可以做到XXX，第二个是能够实现YYY，
第三个是支持ZZZ...
问题：AI需要从叙述中提取信息，容易遗漏
✅ 正确（结构化）：
【功能名称】XXX
【核心特点】
1. XXX
2. YYY
3. ZZZ
【使用限制】
- 不支持AAA
- 需要BBB环境
【示例】
输入：...
输出：...
八、索引文档设计
--------------------------------------------------------------------------------
【8.1 为什么需要索引】
问题：文件多了之后，AI不知道该读哪个
解决：为每个目录创建README索引文件
【8.2 索引文档模板】
# [目录名] - 文件索引
> **用途**：[一句话说明]
> **更新日期**：[日期]
---
## 文件结构
[目录名]/
├── README.md # 本文件
├── 文件A.md # [简要说明]
├── 文件B.md # [简要说明]
└── 子目录/
└── ...
## 核心文件说明
| 文件 | 用途 | 更新频率 |
|------|------|----------|
| 文件A | XXX | 高 |
| 文件B | YYY | 低 |
## 快速导航
- 想了解XXX → 读「文件A」
- 想了解YYY → 读「文件B」
## 待办事项
- [ ] 待完成项1
- [ ] 待完成项2
【8.3 ❌ 错误 vs ✅ 正确：使用索引】
❌ 错误：
用户：读取第3章相关的所有文件。
AI：（不知道有哪些文件，可能遗漏）
✅ 正确：
用户：先读取 chapters/第3章/README.md，
了解本章的文件结构，
然后按需读取相关文件。
================================================================================
第六部分：规范与质量保障
================================================================================
九、规范体系设计
--------------------------------------------------------------------------------
【9.1 为什么需要规范】
没有规范的问题：
- 风格不一致
- 格式混乱，难以维护
- 问题发现晚，修改成本高
- AI每次输出都不一样
【9.2 核心规范文档】
| 规范文档 | 解决的问题 |
|---------|-----------|
| 格式规范 | 统一输出格式 |
| 命名规范 | 统一文件/变量命名 |
| 检查清单 | 标准化检查流程 |
| 质量标准 | 定义什么是「合格」|
【9.3 ❌ 错误 vs ✅ 正确：使用规范】
❌ 错误：
用户：写第3章。
AI：（按自己的理解随意输出）
用户：格式不对，重写。
（反复修改）
✅ 正确：
用户：写第3章。
请先读取「格式规范.md」，
按照规范要求的格式输出，
写完后按「检查清单.md」自检。
十、质量检查体系
--------------------------------------------------------------------------------
【10.1 检查流程】
完成任务
↓
1. 格式检查（是否符合规范）
↓
2. 内容检查（是否有遗漏/错误）
↓
3. 一致性检查（是否与其他内容矛盾）
↓
4. 记录检查结果
↓
5. 修正问题
↓
完成
【10.2 ❌ 错误 vs ✅ 正确：质量检查】
❌ 错误检查：
用户：检查一下。
AI：看起来没什么问题。
问题：没有对照清单，靠感觉
✅ 正确检查：
用户：按「检查清单.md」逐项检查第3章：
AI：检查结果：
✅ 格式规范：符合
✅ 标题层级：正确
❌ 第47行：缺少必填项XXX → 已修正
✅ 与第2章内容一致性：无矛盾
共发现1个问题，已修正。
【10.3 检查清单模板】
## [任务类型] 检查清单
### 必检项（不可跳过）
- [ ] 检查项1
- [ ] 检查项2
- [ ] 检查项3
### 建议检项
- [ ] 检查项4
- [ ] 检查项5
### 常见问题
| 问题 | 解决方法 |
|------|---------|
| 问题1 | 方法1 |
| 问题2 | 方法2 |
================================================================================
第七部分：提高效率
================================================================================
十一、效率提升技巧
--------------------------------------------------------------------------------
【11.1 ❌ 错误 vs ✅ 正确：效率对比】
❌ 低效做法：
- 每次都从头解释需求
- 不保存中间成果
- 发现问题才建立规范
- 一个人闷头做
✅ 高效做法：
- 需求写成文档，让AI读取
- 每完成一步就保存
- 先建规范再干活
- 让AI参与讨论和检查
【11.2 效率提升数据（实测）】
| 指标 | 无规范时 | 有规范后 | 提升 |
|------|---------|---------|------|
| 任务完成时间 | 4-5小时 | 2-3小时 | 40-50% |
| 返工率 | 30-40% | 5-10% | 75% |
| 质量问题 | 每次5-10处 | 每次0-2处 | 80% |
【11.3 并行任务处理】
❌ 错误：
完成A → 完成B → 完成C（串行）
✅ 正确：
如果A、B、C之间没有依赖：
用户：并行处理以下任务：
任务1：写A，写入 A.md
任务2：写B，写入 B.md
任务3：写C，写入 C.md
（AI可以一次性输出多个文件）
【11.4 模板复用】
❌ 错误：
每次都从零开始写
✅ 正确：
建立模板库，需要时直接复用：
templates/
├── 章节模板.md
├── 索引模板.md
├── 检查清单模板.md
└── 决策记录模板.md
用户：按「章节模板.md」的格式写第3章。
【11.5 批量操作】
❌ 错误：
用户：检查第1章
用户：检查第2章
用户：检查第3章
...（逐个检查）
✅ 正确：
用户：批量检查所有章节：
对 chapters/ 目录下的每个 .md 文件，
按「检查清单.md」检查，
输出汇总表格。
================================================================================
第八部分：协作心态
================================================================================
十二、正确的协作心态
--------------------------------------------------------------------------------
【12.1 ❌ 错误心态 vs ✅ 正确心态】
错误心态 正确心态
─────────────────────────────────────────────────────────────
「AI是工具，我说它做」 「AI是协作者，我们一起想」
「AI应该一次给完美答案」 「好方案需要多轮迭代」
「我不满意就让它重写」 「我说清楚哪里不满意」
「AI不懂我，算了自己来」 「AI需要我的引导」
「设定一开始就要完美」 「设定是逐步完善的」
「改设定说明之前做错了」 「迭代是正常的」
【12.2 协作分工原则】
你负责：
────────────────
• 核心思路和方向把控
• 建立规范体系
• 审核和验收
• 最终决策
AI负责：
────────────────
• 大量内容输出
• 按规范格式化
• 质量自检
• 提出问题和建议
【12.3 让AI主动发现问题】
用户：完成任务后，如果你发现以下问题，请主动提出：
- 与之前内容矛盾的地方
- 逻辑有漏洞的地方
- 可以优化的地方
- 不确定的地方
我会根据你的反馈决定是否修改。
================================================================================
第九部分：常见错误速查
================================================================================
十三、❌ 错误 vs ✅ 正确：速查表
--------------------------------------------------------------------------------
【任务下达】
❌「帮我做XXX」
✅「做XXX，核心要求是1、2、3，先读取YYY文档」
【给反馈】
❌「不对」「不是这种感觉」
✅「这里有问题：1.XXX 2.YYY，请针对这两点修改」
【叫停】
❌「嗯...」「不是这个意思...」
✅「等一下，暂停。方向有问题，应该XXX」
【追问】
❌ 直接接受第一个方案
✅「这个方案的缺点是什么？有其他选择吗？」
【确认】
❌「那就这样吧」
✅「确认结论：1.XXX 2.YYY，对吗？」
【保存】
❌ 讨论完不写文档
✅「把结论写入文档，标注版本号」
【继续】
❌「继续」
✅「继续上次工作，当前进度：已完成XXX，下一步YYY」
【检查】
❌「看起来没问题」
✅「按检查清单逐项检查：1.XXX 2.YYY 3.ZZZ」
【规范】
❌ 先干活后建规范
✅ 先建规范再干活
【拆分】
❌ 一次性完成所有任务
✅ 拆分成小任务，逐个完成
================================================================================
第十部分：核心理念总结
================================================================================
十四、三个核心原则
--------------------------------------------------------------------------------
1. 讨论优先于执行
─────────────────────────────────
先对齐方向，再动手做
发现问题及时叫停
达成共识后再继续
2. 文档是共享记忆
─────────────────────────────────
讨论成果写入文档
每次开始先读文档
重要变更标注版本
3. AI是协作伙伴
─────────────────────────────────
给核心约束，留发挥空间
询问AI意见，参考专业判断
共同迭代，逐步完善
十五、完整工作流程
--------------------------------------------------------------------------------
开始任务
↓
给出核心要求（读取文档 + 说明目标）
↓
讨论方案（如有必要）
↓
达成共识
↓
执行任务
↓
检查结果（对照检查清单）
↓
保存到文档
↓
下一个任务
十六、快速检查清单
--------------------------------------------------------------------------------
每次对话开始：
[ ] 让AI读取相关文档？
[ ] 说明当前进度和目标？
任务进行中：
[ ] 发现问题及时叫停？
[ ] 说清楚「哪里不对」？
[ ] 询问AI的专业意见？
[ ] 每完成一步就保存？
任务结束时：
[ ] 对照检查清单检查？
[ ] 保存到文档？
[ ] 标注版本号？
[ ] 更新进度记录？
================================================================================
文档版本: v5.0
更新日期: 2026-02-04
核心更新:
- 新增「工作流程」「上下文管理」「文档体系」「质量保障」「提高效率」章节
- 扩展对话示范从8个到12个场景
- 新增索引设计、规范体系设计内容
- 新增效率提升技巧和数据
- 全程使用「❌ 错误 vs ✅ 正确」对比教学
- 移除特定项目内容，改为通用协作指南
================================================================================