项目四件套
一套标准化的 AI 项目文档规范——PROJECT.md（档案卡）+ INDEX.md（文件索引）+ CHANGELOG.md（修改记录）+ TODO.md（待办风险），让项目具备可接手性，任何 AI 接手后快速恢复上下文
简介
“项目四件套”是 AI Workshop 中最核心的工程实践。它的诞生背景是：当多个 AI 工具（Codex、Claude Code、WorkBuddy）交替处理同一个项目时，最大的问题不是能力差异，而是”上下文断裂”——一个 AI 在窗口里整理清楚了所有背景，换个 AI 或重新开对话，一切又要从头开始。以前一个项目可能只存在于某个 AI 助手的某个聊天窗口里，窗口一关就断了。
项目四件套的设计目标是让项目本身成为可接手的资产，而不是绑定在某个会话窗口里。只要四件套维护得好，任何一个 AI 进入项目后，先读这几份文件，就能快速恢复到足够继续工作的状态。它不一定能看到旧会话里每一句话（也不现实），但核心信息（项目是什么、进展到哪、文件在哪、下一步做什么）一目了然。
这种模式的灵感来自传统项目管理中的”项目管理手册”——一个新成员加入项目组时，先读项目背景文档、查看文件目录、了解最新进展和待办事项。项目四件套把同样的逻辑应用到了 AI 协作场景中，而且要求 AI 自己在完成任务后主动更新这些文档，形成持续积累的正循环。
关键信息
- 类型：概念 / 方法论
- 领域：AI 项目管理 / 上下文工程 / 多 Agent 协作
- 来源：AI Workshop 项目实战经验
- 相关概念：AI Workshop、共享记忆、冷启动、上下文工程
核心特性
1. 四份文档的职责划分
| 文档 | 回答的问题 | 更新频率 |
|---|---|---|
| PROJECT.md | 这个项目是什么？从哪来？谁负责？现在什么状态？ | 状态变更时 |
| INDEX.md | 哪些是最终成果？哪些是素材？哪些是中间产物？ | 文件增减时 |
| CHANGELOG.md | 谁改过什么？什么时候改的？为什么改？ | 每次重要改动 |
| TODO.md | 下一步做什么？有哪些风险？有什么需要确认的？ | 每次工作结束 |
2. 核心意义：可接手性
四件套的真正价值不是”有文档”，而是让项目从”会话绑定”升级为”文件系统绑定”：
- 以前：项目只存在于某个 AI 的聊天窗口里，窗口一关就断了
- 现在：项目以结构化文档的形式存在于文件系统中，任何时候任何 AI 都能读取并接续工作
3. AI 自维护机制
四件套不是用户单方面维护的文档，而是要求 AI 在完成每个任务后主动更新。AI 在修改代码或推进任务后，会自动更新 CHANGELOG.md 记录改动、更新 TODO.md 标记已完成事项并添加新的待办、更新 PROJECT.md 反映最新状态。这种自维护机制保证了文档不会随着项目推进而迅速过时。
4. 与”轻量索引”的配合
四件套不是一开始就被全部读取的。AI Workshop 的渐进式加载设计中，PROJECTS.md 作为项目轻量索引，先提供每个项目的名称、路径、状态和简介；AI 确认要处理哪个项目后，才深入读取该项目的四件套。这种两级读取机制有效控制了 token 成本。
不同素材中的观点
来自 2026-05-28-woshipm-ai-workshop-multi-agent-collaboration：
- 作者把四件套比作”随时留痕的项目管理手册”——有了它，不管谁来接手，都能快速上手。关键是”接手的 AI 助手在完成了项目任务或修改后，也会自动把四件套的文档进行更新维护，方便自己下一次或下一位 AI 能精准接盘”。
- 四件套解决了”AI 对话的临时性”问题：以前一个项目只存在于某个 AI 的某个聊天窗口里，窗口一关就断了。现在只要四件套维护得好，项目本身就具备了持续性和可传承性。
- 作者强调四件套”不一定能看到旧会话里每一句话（也不现实），但能恢复到足够继续工作的状态”——这是一个务实的定位，不追求完美还原历史对话，而是确保关键信息不丢失。
实用信息
四件套模板参考
PROJECT.md（项目档案卡）：
- 项目名称和一句话描述
- 项目来源（哪个需求/谁提的）
- 负责人（哪个 AI 主要负责）
- 当前状态（进行中 / 已完成 / 暂停）
- 核心文件路径
INDEX.md（文件索引）：
- 最终成果文件清单
- 素材文件清单
- 中间产物清单
- 配置文件清单
CHANGELOG.md（修改记录）：
- 日期 + 修改者 + 修改内容 + 修改原因
- 每次重要改动都记录，避免不同 AI 接手时不知道谁改过什么
TODO.md（待办+风险）：
- 下一步待办事项（按优先级排列）
- 已识别的风险
- 需要用户确认的问题
使用建议
- 每个 AI 工具的入口文件（如 CLAUDE.md）中应写明”进入项目后先读 PROJECT.md 和 TODO.md”
- CHANGELOG.md 不需要记录每一行代码的改动，记录”决策级”改动即可
- 当项目切换主责 AI 时，在 CHANGELOG.md 里专门记一条交接记录