TokenRollAI/llmdoc

解决的问题

编码代理往往难以理解仓库的架构、设计决策和跨模块契约，因为这些高层上下文很少在源代码本身中完整体现。这导致代理必须在每个会话中重新发现架构，这在令牌使用量方面既低效又昂贵。

工作原理

llmdoc 在仓库内的专用 llmdoc/ 目录中创建一个持久且耐用的知识地图。它不复制源代码，而是存储“工程含义”——决策、约束和不变量。

它通过两层运作：

1. 代理工作流：负责知识库判断和维护的高层角色（调查者、反思者、记录者）。
2. 运行时 CLI：用于检索和机制的确定性工具，允许代理根据当前任务搜索、索引和检索特定上下文。

当发生代码更改时，系统会识别受影响的知识，并为代理创建审查义务，以验证事实，而不是自动重写文档。

适用对象

适用于使用 AI 编码代理（如 Claude Code 或 Codex）并希望维护跨会话持久化的长期结构化架构上下文的开发者。

亮点

• 任务范围检索：仅检索特定任务所需的最小有用知识集，以节省令牌。
• 语义维护：随着代码演进验证知识，防止陈旧笔记的积累。
• 插件集成：为 Claude Code 和 Codex 提供原生插件，并为其他代理提供可移植的集成配方。
• 知识边界：严格分离稳定知识（llmdoc/）和临时调查（.llmdoc-tmp/）。