经过多个项目实践，整理出一套通用的 AI 协作开发提示词模版。适用于 Claude Code、Cursor 或任何支持项目级指令的 AI 编程工具。
项目启动：建立文档基础设施
新项目第一步，在根目录创建 CLAUDE.md，让 AI 每次启动自动读取项目规范：
# 项目：xxx
## 编码规范
- [你的语言/框架规范]
## 常用命令
- 启动：xxx | 测试：xxx
## 文档体系
- 项目进度：keyfield/项目进度总结.md
- 恢复上下文：读上面两个文件（重点看最后 3 个 Session）然后用初始化提示词让 AI 生成完整文档体系（spec.md、进度总结、开发进度、问题清单、AI_review）。
上下文恢复：高效不浪费 Token
不读所有文档，只读两个核心文件：
读 keyfield/项目进度总结.md + keyfield/AI_review.md（最后 3 个 Session）为什么不是全读：
- 上下文窗口有限，全读浪费在不变的内容上
- 进度总结 = 全局状态压缩包，AI_review = 最近工作细节
- 其他文档（spec、开发进度）按需读取
大改动前：先讨论方案
我需要实现 [功能]，涉及的文件可能有 [文件列表]。
先别动手写代码，帮我分析：
1. 有几种实现方案
2. 各方案的利弊
3. 你推荐哪个，为什么
4. 有什么边界 case 需要考虑使用时机：改动 3+ 文件、涉及核心逻辑、不确定怎么做的时候。
分 Phase 推进
按刚才讨论的方案执行，请分 Phase 推进：
- 每个 Phase 完成后我会验证，确认 OK 再进下一个
- 每个 Phase 告诉我：改了哪些文件、怎么验证使用时机：涉及 4+ 文件或 2+ 功能模块的改动。
Bug 排查
我发现 [现象]。请帮我排查：
1. 先读 [相关文件]
2. 在 [关键环节] 打印中间数据
3. 逐步分析从 [输入] 到 [输出] 的数据流
4. 找到数据从正确变成错误的转折点
不要急着修复，先定位根因。Session 结束：更新文档
帮我更新以下文档：
1. AI_review.md — 新增本次 Session 的记录
2. 项目进度总结.md — 更新已完成/待办项
更新规则：新增内容用日期标注，已解决的标记 ✅ 保留文档体系设计原则
| 原则 | 说明 |
|---|---|
| 分层记录 | spec（不变）> 进度总结（阶段更新）> AI_review（每次追加） |
| 快速恢复 | 进度总结 = 新 Session 30 秒恢复完整上下文 |
| 决策留痕 | AI_review 记录「为什么」而不只是「做了什么」 |
| 信息不重复 | 每类信息只在一个文档中展开，其他文档只引用 |
按项目规模选择文档级别：小项目（进度总结 + AI_review 就够）、中型项目（全套）、大型项目（按模块拆分 spec）。