WeChat (Duang的碎碎记)
ai-engineeringdev-tools
Original source

了解下 OKF — Open Knowledge Format（开放知识格式）

Summary

Google Cloud 2026年6月发布的开放规范 OKF（Open Knowledge Format）— 用 Markdown + YAML frontmatter 组织知识，让人和 AI agent 都能直接读取。

要解决的问题

组织内部知识极度分散：元数据目录、Wiki、云盘、代码注释、工程师脑中。每个用 AI 的人都在重复解决”上下文组装”问题。

已有模式

Karpathy 的 LLM Wiki 模式被反复验证（Obsidian Vault、AGENTS.md/CLAUDE.md、index.md+log.md 仓库），但各自不兼容。OKF 就是要统一这些。

核心设计

  • 一个目录，包含带 YAML frontmatter 的 Markdown 文件
  • frontmatter 只有 type 字段必填，其余由生产者决定
  • 概念之间通过普通 Markdown 链接关联 → 目录变成关系图
  • index.md 实现渐进式披露，log.md 记录变更历史

三项设计原则

  1. 尽可能少作预设（只强制 type 字段）
  2. 生产者与消费者独立（人写/流水线生成/LLM 合成都行）
  3. 是格式不是平台（不绑定任何云/数据库/模型）

格式要求

  • 任何人能生产（不需要 SDK）
  • 任何人能消费（不需要集成）
  • 能在系统和组织间迁移
  • 和代码放在版本控制中
  • 人和 agent 都能直接读取

参考实现

  • Google 发布了自动遍历数据集生成 OKF 文档的 agent
  • 可视化工具将 OKF 包渲染为交互式图形
  • Google Cloud Knowledge Catalog 已支持导入 OKF

相关链接

  • Spec: github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md
  • Karpathy LLM Wiki: gist.github.com/karpathy/442a6bf555914893e9891c11519de94f