接前面的文章：和 AI 讨论需求与设计：Chat 还是 Agent，继续分享项目中如何管理文档。文末有干货小结，方便打包带走。

文档目录的结构

docs/---  requirements/ ：需求和用户故事  tech-design/  ：技术设计文档  ui-ux/        ：UI 和体验设计  meetings/     ：会议和协作记录  management/   ：项目管理文档  releases/     ：发布和快照  feedback/     ：外部反馈

如何管理这些文档

文档管理不是简单地存取文件，我们构建了一套基础设施，让 AI 能高效地理解和维护文档。

文档 ID 编号

类似地还可以说：“让产品经理招集技术专家和设计师，根据 REVIEW-002 重新评审 PRD-003”。

元数据和自动更新

---title: 用户登录需求id: US-101version: 2.3.0status: approvedlast-modified: 2026-03-07related: - TECH-003-auth-module - UI-login-screen---

README 作为工作导航

每个目录下都有 README.md 文件，里面写清楚了这个目录的作用，文档怎么命名，有什么规范和流程，当前有哪些文档等。当然“当前有哪些文档”是需要 AI 自己来维护的。只要 README.md 里写的清楚，AI 自己知道怎么办。

版本管理

Git 版本控制

所有文档都用 Git 管理，保证任何修改都能追溯，如果有多人一起做事，也比较容易处理内容冲突。用 Git 做版本管理还有一个好处就是你不必为文档的每个版本每个状态都留存一份文件。

想象一下打开一个目录，里面有第一版、第二版、评审版、评审修改版、VP 评审版等等。人都要崩溃了。

另一点，我们项目文档都是 markdown 格式的，这种纯文本文件是 Git 最擅长管理的。

如果你还没用上版本管理系统，建议尽快尝试。

元数据状态管理

文档的状态有 draft / reviewing / approved / deprecated 这些，这些状态不会出现在文件名里，而是记录在文档的元数据里。

虽然我们需要打开每个文件才能知道文档的状态，但是别忘了，这些文档多数情况下还是给 AI 看的。AI 自己能管理好文档状态，自己能知道该找哪个版本就好了。作为人类参与者，我们最想看到的还是当前状态，如果真需要查历史，我们还有 Git 来兜底。

干货小结

以上就是这次的全部内容了，总结成下面这几句干货，以便打包带走：

1. 清晰的目录结构 + 文档 ID 编号系统，让 AI 能快速找到需要的文档。

2. 关联关系放进 YAML 元数据，并由 AI 自动维护状态与索引。

3. 用 Git 管理文档版本，而无须保留每一个历史版本的副本。