让 AI 代理在纯 Markdown 中管理结构化知识——无向量数据库，无特殊工具链。
概览
安装 & 更新
前提： 已安装 Hermes Agent。
告诉 Hermes：
安装或更新 kb skill：从 https://github.com/ouranoshong/okf-kb-skill.git 安装
验证：hermes skills list | grep kb
更新：再次执行同一句话即可。
使用（零配置）
使用 kb skill 初始化知识库 | knowledge-base/ → SCHEMA.md + CONVENTIONS.md + index.md + log.md + 子目录索引 |
将 raw/articles/ 下的所有文档编译为 Concept | |
基于知识库回答：什么是 Actor Model？ | |
对知识库做一次健康检查 |
目录结构
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineknowledge-base/├── SCHEMA.md # 类型系统 + frontmatter 规范├── CONVENTIONS.md # 命名 + 质量规则├── index.md # 根索引├── log.md # 变更历史├── raw/ # 原始资料（只读）├── concepts/ # OKF Concept 文档（按类型分目录）├── entities/ # 可复用实体页面└── assets/ # 图表、图片
Concept 类型
Technology | |
Architecture | |
Protocol | |
Research | |
Playbook | |
Entity | |
Reference | |
Metric | |
Decision |
Frontmatter 示例
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line---type: Technologytitle: Actor Modeldescription: 基于消息传递的并发计算模型source: /raw/papers/actor-model.pdftags: [concurrency, distributed]confidence: highrelated: - /concepts/technology/csp.mdcontradicts: - /concepts/technology/shared-memory.mdtimestamp: 2026-06-17T00:00:00Z---
实战场景
初始化：使用 kb skill 初始化知识库，放入 raw/ 后执行 Ingest。
导入资料： 把 Markdown 放入 raw/articles/，然后说 将 raw/articles/ 下的所有文档编译为 Concept。
查询：基于知识库回答：。
更新： 告诉代理 更新 concepts/technology/xxx.md，添加新内容。
冲突： 在 contradicts 字段中显式声明，两侧都标注。
常见问题
hermes skills list | /reload-skills |
设计原则
纯文本：Markdown + YAML， cat可读，git可 diff无向量库依赖：< 50k 全量加载，50k-200k 按导航加载，> 200k 才需要索引 显式矛盾 > 沉默不一致 永不删除：git 保留完整历史
