Lore – 向您的编码代理提供您团队所做的决策

Lore 快速入门 · 比较方式 · 工作原理 · 文档 · CLI · 变更日志 为您的编码代理提供您团队已经做出的决策 - 这样它就不会重复您排除的事情。 Lore 保留您团队记录的知识（需求、决策、设计、路线图和提示），并以 Markdown 的形式保存在您的存储库中，并通过 MCP 将其以只读方式提供给 Claude Code、Cursor 和 Claude Desktop，因此代理会引用您的决定，而不是违反它们。没有 RAG，没有嵌入，没有模型调用来决定什么是相关的——检索是确定性的和可重复的。它基于 RAC — 需求即代码 (Requirements as Code)，即底层的开源引擎；软件包、CLI 和 MCP 服务器以 rac 名称提供。比较 Lore 不是搜索索引或记忆工具——它是代理所依据的确定性记录系统。模糊检索（RAG，代理记忆）擅长查找松散问题附近的内容； Lore 擅长返回准确的当前决定并拒绝您已取代的决定。他们写得很好——模糊地回忆，然后在传说中验证。 Lore 模糊检索（RAG / 代理内存） 擅长准确、当前的决策，查找问题附近的内容 检索确定性、可重复的相似性排名，随运行而变化 角色事实来源，只读快速索引或工作副本 在 CI 强制执行（ rac validate / rac gateway ）中，而不是它的工作 快速入门 安装引擎：pip install rac-core 脚手架身份和您的第一个工件：rac 快速启动 连接您的代理（Claude Code，来自您的存储库） root): claude mcp add lore -- rac mcp 在 CI 中执行，如此糟糕的知识永远不会落地： rac validate rac/ && rac gateway rac/ 安装命令 让你 pip install rac-core rac CLI + lore MCP 服务器 pip install 'rac-core[ingest]' + DOCX / HTML import pip install 'rac-core[ingest-all]' + PDF / PPTX / XLSX import pip install 'rac-core[explorer]' + 终端资源管理器 ( rac explorer ) 需要 Python 3.11+。 uv 工具安装 rac-core 也可以。它是如何工作的 在您的存储库中键入 Markdown。每个工件都是纯 Markdown 格式，带有一个很小的封面信封；引擎确定性地对其进行分类，并根据每种类型的模式对其进行验证。服务时只读。 MCP 服务器只读取；信任边界是人工公关审查，代理无法改变商店。在写入时强制执行。 rac validate 和 rac gateway 拒绝畸形的工件、损坏的或不明确的链接以及对被取代决策的引用——在 CI 中，在知识落地之前。设计上有气隙。引擎不进行 LLM 调用，也不进行网络调用；唯一的出口是同意门禁、无内容的使用 ping，默认情况下处于关闭状态，受监管的安装可以证明它在 rac telemetry off --enterprise 下保持关闭状态（安全态势，ADR-086）。连接您的代理 Claude Code（从您的存储库根目录）： claude mcp add lore -- rac mcp Claude Desktop / Cursor（客户端配置中的 mcpServers）： { "mcpServers" : { "lore" : { "command" : " rac " , "args" : [ " mcp " , " --root " , " /absolute/path/to/your/repo " ] }编写和执行工件 rac Quickstart # 设置身份 + 搭建你的第一个工件 rac 新决策 adr.md # 搭建一个类型化的工件（生成 id） rac validate rac/ # 检查目录中的每个工件 rac Inspection require.md # 查看其类型和完整性 rac review rac/ # 完整的存储库审查，首先出现最严重的问题 rac gateway rac/ # 合并门：验证 + 关系 + 审查 导入现有决策 已经在 Confluence 中做出决策，概念，还是松散的 Markdown？ rac-import 代理技能将一份现有文档转变为一个有效的工件，并在编写任何内容之前进行人工审核步骤： rac Skill install rac-import 然后用简单的语言询问您的代理：“将此决策文档导入到 Lore 中。”它仅根据您的文档内容起草，向您显示建议的类型、标题和要确认的关系，使用 rac new 搭建脚手架，并在 rac validate 上关闭。对于多格式或批量转换，请使用 rac-ingest 技能。导出语料库 rac export rac/ --html --out lore.html # 门户：整个图，一个文件 rac export rac/ --okf # 一个符合开放知识格式的捆绑包 rac export rac/ --documents # 用于内存/RAG 后端的 JSONL rac export rac/ --graph # 图形后端的类型化决策图 --documents 和 --graph 模式提供外部存储器、RAG 和图形工具，以便代理可以在那里模糊地回忆，然后在其中进行验证知识 — 请参阅 CLI 参考。连接器本身位于单独的 lore-connectors 同伴中。 Python API 引擎也是一个库；它的公共表面是 rac.__all__ 。 from rac import parse_file , Classify , find_artifacts art = parse_file("rac/decisions/adr-001-markdown-first.md") print (classify(art).type ) # -> "decision" result = find_artifacts("rac/" , "caching") # 返回 result 中命中的 SearchResult 。匹配 : print ( hit . id , hit . title ) 与 OKF 的关系 Google 的开放知识格式 (OKF) 标准化了载体 — Markdown 的 Git 树