Awesome OKF
August 30, 2026 · View on GitHub
中文 | English
开放知识格式(OKF)的中文资料和工具。规范翻译、七个 producer 插件、七个 Claude Code skill、三份向上游的扩展提案。
OKF 是 Google Cloud 发布的一份开放规范——把知识定义为一个目录的 Markdown 文件,带 YAML frontmatter,加一小套约定。没有运行时,没有 SDK。
📌 规范已升到 v0.2:新增出处(
sources)、信任(generated/verified)、生命周期(status/stale_after)与可验算计算(Attested Computation)四个家族;两处破坏性变更是timestamp→generated.at、正文# Citations→ 头信息sources。本仓库(规范译文、校验器、七个插件、全部文档)已完成迁移,详见 规范中文版 §13。
快速开始
# 安装
pip install myokf-cli
# 从一个 GitHub 仓库拉取 OKF bundle
myokf from-github yzfly/awesome-okf -o ./kb
# 校验
myokf validate ./kb
# 打包成单文件网页
myokf to-web ./kb -o kb.html
内容
工具(plugins/)
| 工具 | 输入 → OKF |
|---|---|
| feishu-to-okf | 飞书知识空间 / 文档 |
| obsidian-to-okf | Obsidian vault(wikilink → OKF 链接) |
| notion-to-okf | Notion Markdown 导出 |
| github-to-okf | GitHub 仓库(提取代码符号) |
| awesome-to-okf | GitHub awesome-xx 列表 |
| html-to-okf | HTML 文件 |
| myokf-cli | 以上工具的统一 CLI 入口 |
全部零第三方依赖,标准库,产物通过符合性校验。
Skill(skills/) —— Claude Code 配套工作流
| Skill | 用途 |
|---|---|
| okf-creator | 从零创建高质量 OKF 知识库 |
| awesome-to-okf | 导入 awesome 列表并富化 |
| book-to-okf | 书 / 长文拆成互链概念库 |
| code-to-okf | 代码库转 OKF |
| github-to-okf | 仓库 → OKF 富化工作流 |
| okf-to-book | OKF 发布为 VitePress 文档站 |
| okf-to-web | OKF 打包成单文件网页(含图谱) |
文档(docs/)
- OKF 规范中文版 —— 全文翻译,标注硬要求与留白
- 发布博客中文版
- Karpathy 的 LLM Wiki —— OKF 的思想来源
- 代码 / PDF / 图片支持度调研
- 全网资料汇总
- 仓库自身怎么做成 OKF bundle 的
三份扩展提案 —— 向后兼容,不动任何 MUST
OKF 热门仓库
| 仓库 | ★ | 语言 | 形态 |
|---|---|---|---|
| knowledge-catalog(官方) | HTML | OKF 规范 + 参考实现 + 示例 bundle 总入口 | |
| open-knowledge-format | HTML | 官方规范独立仓库(2026-08 从 knowledge-catalog 拆出):SPEC v0.2 + PoC 生成 agent + 可视化器 + 4 个示例 bundle,规范的最新提交在这里 | |
| openwiki(LangChain) | TS | LangChain 官方:为代码库写并维护 agent 文档的 CLI,产出 OKF v0.2 bundle(生态 star 最高) | |
| iwe | Rust | Markdown 知识图谱:编辑器 LSP + CLI + MCP,iwe init --okf 一等支持,模板以 v0.2 分发并在 CI 校验 | |
| zosmaai/pi-llm-wiki | TS | 自维护、兼容 Obsidian 的知识库,原始资料→互链 wiki | |
| fellowgeek/mcp-memory | Python | OKF 为底的 MCP server,给 agent 持久长期记忆 + SQL 检索 | |
| coleam00/cole-medin-knowledge-base | JS | OKF 知识库 + Karpathy 式 LLM wiki 合成产物 | |
| UmairBaig8/okf-generator | Python | OKF bundle 生成器:Claude skill + OpenCode 集成 | |
| jyjeanne/okf-rs | Rust | Rust 工具链:生成 / 校验 / serve OKF bundle | |
| openknowledge-sh/openknowledge | Go | 管理 OKF bundle 的 Go CLI | |
| saschb2b/okf-studio | TS | OKF bundle 的原生桌面阅读器,指向一个目录即可浏览 | |
| aws-samples/sample-okf-llm-wiki | Python | AWS 官方示例:把数据转成 OKF bundle 并对外提供 | |
| JuneYaooo/lineage-skill | Python | 带出处(lineage)蒸馏的 Agent Skill,输出 OKF 包 | |
| psinetron/echoes-vault-opencode | TS | OpenCode 持久记忆插件,底层用 OKF | |
| guhcostan/claude-mega-brain | Python | Claude Code 的 OKF 知识上下文注入插件 | |
| takeshy/obsidian-gemini-helper | TS | 支持 OKF 知识源的 Obsidian Gemini 助手 | |
| coleam00/cole-medin-ai-coding | Python | Cole Medin AI 编程视频的 OKF 知识包 | |
| okf-gem | Ruby | 创作 skill + CLI/库 + 图谱,覆盖 bundle 全生命周期 | |
| OWOX Model Canvas | TS | 可视化建模 / 创作端(公司维护) | |
| 0dust/OKFy | TS | 文档 → agent 可读 OKF bundle 转换器 | |
| okf-knowledge | Python | Claude Code /okf skill | |
| PoorvaJ-WW/okft | Python | OKF 规范校验器(okft lint,适合 CI)+ MCP 服务器(okft serve),pip 安装 | |
| longsizhuo/okf-frontmatter | Python | 把仓库文档维护成 OKF 形态的 skill | |
| hermes-okf | Python | 基于 OKF 的 Agent 持久记忆(PyPI) | |
| pumblus/okf-harness | TS | 本地优先的 agent 终端 harness | |
| scaccogatto/okf-skills | Python | Claude Code 的 OKF 技能 | |
| wiki-as-an-mcp | Python | 首个通用 Wiki MCP server | |
| superops-team/okf | Go | 项目级知识库 | |
| xSAVIKx/okf-skills | Go | Go 实现的 OKF agentic skills | |
| okf-rag | Rust | 本地优先 OKF 检索 / RAG | |
| Sudhakaran88/okf-conformance | JS | OKF 一致性校验器 | |
| joshuaswarren/remnic | TS | 面向「认识用户」的 agent 记忆 / 上下文层:记忆目录即 OKF bundle,自带 remnic okf lint,MCP/HTTP 双接口 | |
| ZeroDot1/LLMWikiNG | Python | 本地、隐私优先的 Karpathy 式 LLM Wiki 平台(OKF Edition),由 AI 维护与扩写 | |
| jkroepke/okf-crossplane-v2 | Python | Crossplane v2 的 LLM-wiki,带 CI 校验的真实领域 OKF bundle 样例 | |
| stjbrown/agent-knowledge | JS | 可移植 Agent Skills,用纯 Markdown 构建并维护 OKF 项目 wiki | |
| kiso | Java | OKF 发布引擎:bundle → 面向人与 agent 的静态站,附 MCP server | |
| kushal-omnius/open-knowledge-compiler | Python | 把 Git / PR / 测试历史确定性编译成带出处的可查询知识库(v0.2) | |
| Connorrmcd6/surface | Rust | 「常鲜」文档:hub 是合规 OKF 概念,补上 OKF 留白的新鲜度检查,过期即构建失败 | |
| okfcli/okf | Go | 厂商中立 Go CLI:创建 / 校验 / lint / 索引 / 搜索 / 图谱,为被 agent 驱动而设计 | |
| DavidROliverBA/aix-format | Python | AIX:OKF v0.2 的严格超集——稳定标识、类型化关系、媒体身份、联邦 | |
| W4G1/okf | Rust | 纯 Rust 零依赖实现与 CLI 工具链 |
这个仓库本身
是一个符合 OKF v0.2 的 bundle。每个 .md 带 frontmatter 和非空 type,根目录有 index.md 和 log.md:
python skills/okf-creator/scripts/validate_okf.py .
贡献
PR 欢迎。标准:跟 OKF 相关,能跑或能读。写 producer 前看 CONTRIBUTING。
许可
云中江树 维护,微信公众号:云中江树。MIT。