AI Native 团队最小必要的 20 份文档：把共识写进仓库

很多团队聊 AI Native，聊到最后都会变成两种极端：

• 一种是“全靠脑子记”：谁记得多谁说了算，结果就是反复争论、反复返工。
• 另一种是“文档大爆炸”：目录像图书馆，真正能用的不到 10%。

更现实的做法是：先建一套最小必要文档（Minimum Docs），把协作、验收、安全、隐私、应急这些“会要命的共识”写进仓库。

这篇文章把一套 AI Native 团队常用的 20 份最小文档整理成公众号能直接落地的版本：

• 每份文档解决什么问题
• 应该写到什么程度就够用
• 建议的落地顺序（别一次性把自己写死）

这套不是官方标准，更像工程团队的“作战手册骨架”。关键在于：能跑、能迭代、能审计。

---

一句话原则：文档不是写给“看起来专业”的，是写给“下次不再踩坑”的

AI Native 场景里，坑特别集中在四个地方：

1. 目标飘：今天做 Copilot，明天做 Agent，后天做平台。
2. 验收虚：说“效果不错”，但没人能复现“不错”的标准。
3. 风险漏：安全、隐私、成本一旦失控，修起来比写功能难十倍。
4. 事故慌：出问题就开会，但没人知道按哪套流程止血。

所以这 20 份文档可以理解成：

• 对齐目标（使命/用户/需求）
• 对齐交付（完成定义/测试/评审/协作契约）
• 对齐风险（安全/隐私/伦理/应急/备份/成本）
• 对齐资产（数据/模型/prompt/决策）

---

这 20 份文档分别干嘛（按“先后顺序”分组）

第一组：方向与范围（先写这 6 个，不然越写越散）

1. mission.md：使命宣言

• 写清楚“我们为什么存在、成功长什么样、不做什么”。
• 这份越短越好，最好 1 页内。

2. people.md：用户画像

• 不需要一堆画像，先写 1 个核心用户 + 1 个反画像就够。
• 目标：团队对“服务对象”有共同的画面。

3. needs.md：需求清单

• 不是 PRD 集合，是“当前要打的仗”。
• 必须包含：Top 需求 + 明确不做（Non-goals）。

4. guide.md：知识地图

• 新人第一天只看它，就能知道信息在哪。
• 目标：减少“问人/翻群聊”。

5. glossary.md：术语词典

• 统一口径，避免“同词不同义”。
• AI 团队最常见的混乱词：Agent、Tool、Skill、Node、DoD、PII。

6. protocol.md：协作契约

• 约定怎么提需求、怎么请求 Agent、怎么开会、怎么做变更。
• 目标：把沟通从“感觉对”变成“可执行”。

---

第二组：交付与质量（让产出可验收、可复现）

7. definition.md：完成定义（DoD）

• 这是“验收底座”：功能、测试、安全、隐私、可观测、回滚、文档更新。
• 不写 DoD 的团队，最后只能靠情绪验收。

8. test.md：测试标准

• 不必一上来追求全自动化，但要写清“关键路径必须测什么”。
• AI 专项建议至少包含：幻觉一致性、prompt 回归、安全/越狱、隐私泄露。

9. review.md：审查规范

• 代码评审/方案评审/Prompt/Skill 评审都要有最小清单。
• 目标：防止错误流入主分支、流入线上。

10. design.md：技术架构

• 系统边界、关键决策、非功能需求（性能/稳定性/成本/安全）。
• 建议用 Mermaid 画一张最小架构图，后面再慢慢补。

---

第三组：核心资产（AI 团队最容易“跑丢”的东西）

11. data.md：数据资产

• 数据分级、数据字典、生命周期、访问控制与审计。
• 目标：让“数据怎么来、怎么用、怎么删”可追溯。

12. model.md：模型卡片（Model Card）

• 能力边界、失败模式、风险、评测与回归策略。
• 目标：别把模型当黑盒许愿机。

13. prompt.md：提示模板

• 把高频任务固定成模板，让产出稳定。
• 目标：降低每次“临场发挥”带来的质量波动。

14. decision.md：决策记录（ADR/决策日志）

• 记录关键决策：背景、选项、取舍、结论、影响范围、回滚。
• 目标：减少重复争论，避免重复踩坑。

---

第四组：风险与韧性（真正决定你能不能长期跑）

15. budget.md：成本预算

• 模型、存储、观测等成本项的上限与告警阈值。
• 目标：成本可控，不靠月底对账“被教育”。

16. safety.md：安全护栏

• 禁止输出、禁止执行、工具最小权限、红队/越狱测试。
• 目标：把“风险默认值”写死。

17. privacy.md：隐私合规

• PII 定义、收集最小化、保存周期、访问控制、日志脱敏。
• 目标：别在日志里把自己送走。

18. ethics.md：伦理准则

• 灰区决策原则与争议处理流程。
• 目标：出现争议时，团队有同一套“底线”。

19. incident.md：应急手册

• 分级、止血→定位→修复→回归→复盘的最小流程。
• 目标：出事时先做正确的事，而不是先找背锅的人。

20. backup.md：备份策略

• 备份对象、RPO/RTO、频率、恢复演练。
• 目标：能恢复才叫备份。

---

建议落地顺序（别 20 份一起写，会写到崩）

把它当成 3 个迭代：

迭代 1：先把方向钉住（1 天内）

• mission / people / needs / definition

迭代 2：把交付变可控（1 周内）

• protocol / review / test / design

迭代 3：把风险补齐（2~4 周内持续完善）

• safety / privacy / budget / incident / backup

其余的（glossary/data/model/prompt/decision）可以边做边补，但不要缺席。

---

一个可直接抄的目录结构（docs-as-code）

ai-native-docs/
  README.md
  guide.md
  glossary.md
  protocol.md
  mission.md
  people.md
  needs.md
  definition.md
  design.md
  data.md
  model.md
  prompt.md
  budget.md
  test.md
  review.md
  safety.md
  privacy.md
  ethics.md
  incident.md
  backup.md
  decision.md

---

行动清单（照着做就能启动）

1. 今天先写 mission.md：一句话目标 + 3 条不做。
2. 明天补 definition.md：把验收标准写成清单（别写形容词）。
3. 本周把 safety/privacy/budget 三份补上骨架：先有“底线”，再谈“优化”。

收尾一句：

文档不是负担，是你团队的“重启按钮”。