跳出传统 RAG！用 LLM Wiki 构建闭环式产品 Agent 协作体系

这段时间我在了解 LLM Wiki 之后把它当成一套「私域知识库 Agent 工作流」的底座做了一次具体实践。这篇文章主要想记录我对 LLM Wiki 的理解以及我怎么基于这套思路去构建一个产品 Agent知识库如何组织产品工作流如何串起来最后又如何和 GitLab 上的 PRD、Epic、Issue 这些需求资产衔接。下面我会先按 gist 里最关键的那几条理念对齐一下我对 LLM Wiki 的理解再写我怎样在此基础上做产品 Agent知识库长什么样、入口 skill 怎么设计、Hermes 里怎么挂定时任务和默认提示词。中间我放了一张架构图把整体串起来。LLM Wiki 在说什么Andrej Karpathy 在那份 gist 里描述的并不是再做一个「上传文件 → 向量检索 → 答一次题」的 RAG他强调的是一种会持续维护的中间层模型不只在提问瞬间去拼片段而是把读过的材料整理进一套互联的 wiki 里包括实体页、概念页、摘要、对照表、索引等内容。交叉引用提前存在矛盾会被标出来综述也会随着新材料迭代。我的理解是wiki 本身会成为一个持续积累的知识产物而不是每次问答都从零重新发现知识。从这个角度我自己的感受更接近「把知识显式地摊开给模型」网络化页面之间的关系、索引与入口本身就是线索模型不必每次都从大量原始文档里重新查找。减轻上下文压力大量细节落在 wiki 层对话里更多是做检索、对齐与增量更新而不是每次把整个资料堆塞进提示词。利用效率更高知识已经按类型归档并且通过页面关系连接起来查询时更容易找到相关内容。gist 里把结构分成很清晰的三层我后面搭库也基本按这个结构来理解Raw原始资料放进来的地方偏向「只读真相源」ingest 时从这里读不在这里乱改语义。Wiki模型主导维护的一层 markdown包括摘要、实体、概念、来源引用、对照比较等内容。人负责读与审模型负责写与串联。Schema告诉模型目录怎么长、页面怎么写、ingest / query / lint 的时候要遵守什么流程。这一层决定模型如何维护知识库。运营层面 gist 提了三个动作也非常贴合工程化Ingest新资料进 raw模型读、抽要点、更新索引与相关页必要的话在 log 里留痕。Query对着 wiki 发问带着引用组织答案有价值的回答还可以补充回 wiki成为后续知识的一部分。Lint定期做健康检查包括陈旧信息、孤立页面、缺少页面的重要概念、没有补齐的交叉引用等。他也提到了Obsidian对人的一侧侧边开 Agent另一边开图视图人看文档关系和关键页面模型负责批量改文件。wiki 本身可以就是一个 git 仓库这套组合在实践里也比较自然。我怎样理解「产品 Agent」对我来讲产品 Agent 不只是用来生成 PRD 的工具。我更愿意把它定义成以知识和经验为主的智能体并且它的动作要尽量贴着团队真实协作方式来设计。也就是说先要有一套团队可用的知识结构与工作流Agent 才能在具体流程里发挥作用。所以顺序是先构建 LLM Wiki 的私域知识库再思考还需要哪些 skill 作为工具最后用入口 skill把「聊需求 → 落文档 → 拆 Epic → 知识回收」串起来。知识库按 LLM Wiki 的标准拆三层我的目录结构和 gist 的三层一一对应只是在wiki里按用途拆得更细一点方便人和模型使用。raw/原始文档与裁剪下来的来源材料。ingest 的起点。wiki/下面分了comparisons、concepts、entities、sources、summaries等不同类型的页面区。本质是把 gist 里提到的 summary / entity / concept / comparisons 这些页面类型固定下来减少模型每次处理资料时重新判断分类的成本。schema/这一层写清楚整体目录语义、wiki 页的格式约定含Obsidian友善的链接与别名习惯、以及Ingest / Query / Lint的具体 SOPIngest原始资料进 raw 之后如何抽主题、写哪几类页、如何更新索引、如何记变更日志。Query如何先从索引或目录入口收窄范围再深读页面、如何带引用回答。Lint定期要检查哪些一致性问题、孤立页面、过期声明。用 Obsidian 做前端也很常见。它可以可视化地看到文档之间的关系适合人工维护和审阅知识库Agent 侧继续负责批量更新 markdown。初始数据与边界我最初的种子数据来自 GitLab把产品相关的Epic / Issue拉下来当作第一批实体与脉络。这里我觉得初始数据质量很关键如果一开始进入知识库的信息就不准确后续维护成本会变高也会影响模型对知识的理解。另一个我很在意的点是领域边界。我刻意不让「所有产品知识」都进同一个大杂烩而是让知识库聚焦在少数几个域。原因很简单关联范围太大query 时会引入更多无关信息。维护成本会上升交叉引用越多lint 和人工审阅的工作量也会随之增加。知识库能跑起来之后我在仓库根目录补了AGENTS.md。它的作用很单纯任何模型在第一次进入这个知识库时先读到这份库的用途、LLM Wiki 的理念并且被引导去阅读schema。这样即使是新会话也能先了解知识库的使用方式。Skill 层GitLab 与 Product Workflow光有 wiki 还不够。要让流程在团队系统里落地还需要能够写回 GitLab 的能力。GitLab skill这套 skill 我很早就有但在想产品 Agent 的时候我把它更多放在承接产品结论的位置讨论清楚后可以把共识整理成PRD上传到 GitLab Wiki。之后可以继续用基于 Wiki 中 PRD 的Epic 拆分工具把大颗粒需求切成可执行 issue 树。这两条加上之后产品 Agent 就有了一条比较明确的工作流讨论结果可以从对话进入 GitLab并继续拆成后续可执行的需求。Product Workflow skill入口我还做了一个更上位的product workflowskill定位就是 Agent 的入口 skill它不负责替代所有细节工具而是提供背景信息和主要工作流程。里面会放齐背景材料——公司背景、项目背景、团队组织、关键仓库与 GitLab 入口——但最核心的还是主流程指引私域知识库是产品信息的第一信源需要时先从 wiki 拉脉络再下结论。GitLab skill承载 PRD、wiki、issue/epic 相关动作。和用户讨论需求时该查库就查库有结论后询问是否把 PRD 落到 GitLab并是否继续Epic 拆分。如果出现新的关键事实询问是否要写入知识库并走Ingest。用户当场纠正的信息要落实到知识更新本质上是一次小 ingest 或定向修订。Hermes、定时任务与默认加载这一套我跑在Hermes上。除了对话能力之外我用它的定时任务加了一个小脚本每天扫一遍知识库如果发现新增文件就触发一轮lint / 健康检查。这样可以及时发现新增内容带来的格式和引用问题。同时我把Product Workflow skill 默认放进 Hermes 入口提示词里。效果是用户提出和需求相关的问题时Agent 会先进入「产品工作流 LLM Wiki」这套上下文再决定是否查询知识库或调用 GitLab 工具。整体架构可以用下面这张图概括。写完之后的感受对我来说这次实践最大的收获不是「又多了一个 Agent」而是在做 Agent 的过程中我越来越意识到知识库设计和维护的重要性。模型可以批量修改很多互相关联的页面所以前期的目录设计、页面格式和更新流程都需要尽量明确。反过来这也会改变一部分产品工作的重心有些工作会从「每次在聊天里复述背景」转移到审阅 wiki、划定领域边界、决定什么值得 ingest。gist 里提到人负责来源、探索和提问LLM 负责总结、交叉引用和维护我觉得这个分工在团队场景里也成立。但专业产品仍然不可替代因为哪些信息值得入库、哪些只是临时判断仍然需要人来判断。如果你也在搭类似系统最值得参考的可能不是某个目录名而是这三件事三层分离、schema 写清楚流程、入口 skill 把默认工作方式讲清楚。后面的工具链GitLab、定时 lint、Obsidian都可以按环境替换但这套结构能帮助 Agent 保持比较稳定的行为。