大家现在 AI Coding 文档是怎么管理的

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

• 请不要在回答技术问题时复制粘贴 AI 生成的内容

我们现在后端是：基于需求文档->领域文档（放在项目 docs 下）->TDD

我现在的问题是，这份文档只放在后端有点可惜。期望建立一份面向产品->后端开发->前端开发->测试->售前->售后->市场的完整的文档库。减少一部分内容的重复建设。

想了解一下大家现在都是怎么玩，看看有没有什么有意思的玩法

文档

管理

流程

6 条回复 • 2026-04-13 22:21:07 +08:00

XuDongJianSama

14 小时 41 分钟前

我是全栈了，工作空间放个文档和所有项目，项目文件夹放项目文档和各端，各端文件夹下各端文档

midraos

14 小时 30 分钟前

还在探索，项目下放的文档太多会干扰上下文，出现 Agent 只是获取背景信息就把上下文窗口干没一半了

teaguexiao

13 小时 57 分钟前

我们的做法是把文档分两层：一层是 project-level 的 CLAUDE.md （或者叫 AI.md ），专门给 AI 看的，包含架构决策、API 约定、常见陷阱；另一层才是面向人的完整文档库，放在 Notion 或者内部 Wiki 。关键是不要把面向人的文档全塞给 AI ，上下文会爆。AI 文档尽量精简，只放它真正需要的约束和规范，其他背景信息按需 @include 就好。

xxlsize

13 小时 35 分钟前

我也喜欢放在项目 docs 目录下，需要的时候，方便上下文检索

SilenceLL

9 小时 42 分钟前

@XuDongJianSama @midraos @teaguexiao @xxlsize

SilenceLL

9 小时 37 分钟前

@XuDongJianSama @midraos @teaguexiao @xxlsize 我现在是这么玩的，项目根目录下有个 docs 目录，然后顶层有 AGENT.md 包含了系统的主要体系架构，不到 200 行。CLAUDE.md 通过 @AGENT.md 引用。确保能够适配不同的 AGENT 工具。然后 AGENT.md 里面包含了不同业务的领域文档目录入口，告诉 AI 按需加载。然后再往下就是领域文档。所以现在就是三层渐进式披露：
1. AI Context：AGENT.md CLAUDE.md
2. AI 开发业务索引：告诉 AI 什么业务读什么文档
3. 领域文档：AI 改到特定业务读取文档
我现在想扩展到前端、APP 端、产品、售前售后、市场。因为很多内容都是相通的