正在打开每日关注
正在打开每日关注
lat.md 将架构、业务与测试知识组织成可互链图谱,帮助 Agent 持续检索并维护上下文。
AGENTS.md 会写基本的原则和一些全局性的东西。 但项目一大,单个 AGENTS.md 装不下,关键决策被埋掉,Agent 开始瞎编本可以查到的上下文。 lat.md 这个开源工具,把代码库知识压成一张用 markdown 写出来的图。 它在项目根目录建一个 lat.md/ 文件夹,里面放架构、业务逻辑、测试规范这些 markdown 文件。 文件之间有互链。 核心是 lat 这个 CLI: lat init # 给项目搭好 lat.md/ 目录 lat check # 校验所有 wiki link 和代码引用对得上 lat locate # 按名字找章节 lat search # 用 embedding 做语义搜索 Agent 改用 lat search 替代无止境的 grep,code review 时先看 lat.md/ 的语义改动再看代码改动,整套知识能在不同 session 之间留存下来。 如果你的项目代码库大到 Agent 经常找不到关键约束,lat.md 是目前最值得一试的方案。 开源地址:https://t.co/t9eJ5Oiran
是什么 lat.md 是把代码库知识组织成 Markdown 知识图谱的 Agent 工程工具,解决大型项目中单一 AGENTS.md 难以承载上下文、决策被埋没、Agent 反复猜测的问题。它在根目录建立 lat.md/,拆分架构、业务逻辑与测试规范,并用链接组织关系。
核心设计 文档用 [[wiki links]] 互链,文档可指向源码符号,源码通过 @lat 注释回链;lat check 校验引用一致性。lat locate、section、refs、expand 用于定位与上下文展开,lat search 基于 embedding 检索。README 说明默认使用本地 all-MiniLM-L6-v2 WASM,也支持 OpenAI 或 Vercel AI Gateway 远程 embedding;测试规范可用 require-code-mention 强制关联测试代码。
关键洞察 它把 session 中易丢失的决策变成可导航、可校验、可审查的工程资产:Agent 用语义搜索替代无休止 grep,人类先读 lat.md/ 的知识 diff,再看代码 diff。文档、源码、测试三者的双向引用,是最值得借鉴的设计。
边界与风险 README 不能证明搜索质量或自动维护收益。图谱若无人更新,也会变成新的知识债务;应从高频领域和关键测试开始,并把 lat check 纳入 CI,作为 AGENTS.md 的补充,而非自动替代。