你们如何搭建和管理项目知识库？

[yidinghe]

项目规模越来越大，业务越来越复杂，我同时身负架构、开发、测试、运维四重角色，脑袋有些不够用啊。如果是没有 AI 的年代我，直接就辞职跑路了，不过现在有了 AI ，我觉得还是可以试下，让 AI 尽可能参与高层设计。要做到这点就需要 AI 充分吸收业务知识、了解现有技术细节。

问题是，开发过程中有很多这样的决定：一方面这些决定影响了后续开发，另一方面并没有体现在代码中，连注释也没有写。所以你不能指望 AI 把全部代码都读一遍，就真的全部都懂，就能进行高层设计了。

此外开发过程中还有很多参考文档，比如对接外部系统的 API 文档。AI 也要拿来参考。

这就是对知识库的需求。不知道各位是怎么做的，或者是什么想法。比如：

1. 存在外部系统，比如向量数据库或全文搜索引擎，让大模型通过 API 去查找，缺点是 AI 无法直接维护；
2. 存在项目本地，以文本形式。优点是 AI 可以直接维护，缺点是如果组织混乱会令查找不便。

或者是有什么现成的开源项目可以推荐的。

首先我希望 agent 可以直接用这个知识库，以弥补自身上下文长度和注意力机制的不足，因为对大模型来说，这两样是永远都不够用的，必须靠外部工具来支持。笔记软件+大模型的效率不高，因为需要人做中介来帮 agent 理清信息。

其次我认为知识库的编排必须是面向任务的。也就是说它不能像教材一样，要求 LLM 从头到尾读一遍，然后才开始做事；而应该是当 LLM 有任务时，一下子就从知识库里面找到信息，知道自己每一步要怎么做。这个步骤不一定明确在文档里面，智商高的 LLM 能自行归纳信息编排任务。

[xiaoz]

搞个 AI 知识库？
https://www.v2ex.com/t/1225304

效果见 https://znote.xphub.dev/doc/guide 右下角 AI 按钮。

你说的外部文档参考现在很多提供了 llm.txt 整理为 skills 丢给 AI 就行了，没有提供的就只能自己整理或者调用 websearch 了。

[94]

如果只是为了备忘和提示，可以单独建一个 DEV_NOTE.md 文件，并且在 AGENTS.md 文件中说明。

> - DEV_NOTE.md - 开发过程中积累的需要长期关注的事情，比如框架新知识、环境配置等
> - 记录决策依据和最后决策，不需要详细记录做了什么
> - 记录本项目中积累的基建、框架知识，避免日后重复踩坑
> - 需要经常 review 此文档，作为日常知识储备

[94]

如果是长期使用的，我们现在使用的方案是让 AI 创建一个 repoWiki 目录，让 AI 定期读项目仓库去更新（有对应的 skill ）。
现在各种 Agent 工具都会给项目建立索引，所以在项目内使用 AI 问答的时候也可以快速读取对应的内容。

[skuuhui]

没啥用，等你把你们项目相关知识整明白了，形成知识。你就往文件夹里丢 txtAI 都能用。缺的就是录入和迭代整理。
我的做法是，项目只维护自己的输入输出（ api ），和上下游都有谁用啥功能。
当 ai 需要某些信息的时候，直接顺着项目地图找到项目，查找找到对应的项目去读项目，自己推理。