内部文档：为人类、智能体还是两者编写？

我保存诸如运行手册、ADRs、实验笔记和项目特定文档之类的文档。我有一些文件记录了会话中完成了什么、什么出了问题、什么有效、什么改变了以及学到了什么教训。我的智能体负责大部分写作，并维护文档。当适当时，我们会退役一些文档，有时是归档，有时是被新文档取代，新文档包含了退役文档中仍然相关的部分。 面向人类的文档：这些文档需要格式化，以便我作为人类更容易理解。如果需要写一些我想要阅读并可能评论的内容，那么我希望以最适合我的方式来写。比如定义、适当的上下文量，这样我就不用去搜索，特定的格式要求以确保易于阅读。一些具体的数据和值直接放在文档的相关位置。关键是，我希望面向人类的文本以一种让我理解我所看内容的方式来写，包括我需要正确理解文档目的和意义的周围上下文。 面向智能体的文档：智能体不需要我需要的东西。我使用Google's OKF，他们可以更容易地拉取链接的额外文件并获取所需内容。他们有时间阅读术语表文件和索引文件，并为自己收集所有信息。他们不需要那些为了我自己目的而想要的、会使上下文膨胀的额外可选项。如果每份文档都是为我写的，那么对于我不太可能阅读的文档来说效率会更低。这里的问题是，我是根据读者类型来编写文档，还是所有文档都应该以人类为出发点来写？区别在于，为智能体编写的文档可以比为人类易读的文档更令牌高效。要理解的是，有些文档写出来不太可能被人类看到，但会被许多智能体解析。