项目根目录新建个/docs 叫ai写文档就行 时不时对齐下 只要README和一些基础文档写人话就行 技术文档能看懂就得了

根目录新建个/docs

之前有尝试过 但是时间长了就堆成山了 太多了 而且 纯ai写 人工不干预的话 感谢不太便于人阅读诶

AGENTS.md里写上叫ai有大改动时对齐下文档 人工也干预下叫ai维护一个文档清单

方便人阅读就不用太操心了 别人大多也直接用ai阅读)

README这种人一定会看的写好点就行

个人觉得不管什么样的项目，只要它具有一定的意义，都需要维护一个说明文档

其中的内容可以根据情况来自由决定是否详尽，但必须得有这个说明

不然一个月，半年后，你自己看都是麻烦

我觉得开发完一个功能就写一小段，让 AI 根据 git diff 扩充就好。之后的 refactor 也记得修改就行。

唯一事实源原则。

最好代码就是事实，开发过程中产生的技术文档，都只是历史快照，很容易过时，维护难。合入主分支的时候都舍弃掉。

我感觉技术文档不那么必要 因为参与者不一定多

但是使用文档特别重要 而且要一直保持最新（不然别人没法用啊…

以及版本updates的变更

还是有必要的，这东西和代码注释一样，不写过一个月可能都看不懂自己代码了