OKF v0.3 正式发布

Open Knowledge Format(OKF)是一个开放规范,用纯 Markdown 和 YAML 给 agent 提供上下文。六月首次发布,七月 v0.2 加入 provenance、trust、freshness、lifecycle、attestation 等信任信号。今天发布 OKF v0.3,重点解决生产环境里的互操作问题:bundle 在组织间流转、多个 agent 编辑同一语料、独立工具要以同样方式读取 bundle。核心设计不变:type 仍是唯一必需字段,已有 bundle 继续可用。

v0.3 把正式的一致性规则写进规范,使用 RFC 2119 关键词,让独立的生产者和消费者可以按设计协作。格式栈保持最小:YAML 1.2 frontmatter、CommonMark 加 GFM 表格和脚注、RFC 3339 时间戳。没有 type 的 .md 文件(如 README.md、AGENTS.md)会被跳过,非 Markdown 文件作为 assets 存在。面对多 agent 写入可能产生的 null、空字符串、单项而非常规列表等情况,规范要求消费者接受这些输入,validators 记录警告;bundle 不会因为缺少可选字段或链接断裂而失败。

信任层级方面,v0.2 定义了 unverified、machine-confirmed、human-reviewed 三档。v0.3 规定只有“当前”的验证才计入层级:验证时间必须在内容最后一次有意义改动之后,改动时间记录在 generated.at。比如一个人审过定义,一周后 agent 修改了文本,这条概念会从 human-reviewed 降回 machine-confirmed,直到人再确认;旧的签署留在文件里作为历史记录。Actor 标识符也标准化了:工具是 /,其他实体是 :,并新增 team: 前缀。只有 human: 能获得 human-reviewed,因为 team 不代表具体的人。

bundle 级元数据支持渐进式披露。bundle 根目录的 index.md 可以带 frontmatter:description 用于路由,license 说明收到他人知识后可以如何使用,okf_version 让消费者按版本规则处理,兼容旧 bundle。重新生成 index.md 的工具必须保留这些 frontmatter。知识退役和移动用 superseded_by 解决:旧路径留一个 deprecated concept 指向新位置,过滤到当前知识的消费者会跟随指针返回替代内容,已有链接和引用继续可用。链接和路径的解析规则也统一了:带 scheme 的值(如 https:)是绝对 URL;以 / 开头的从 bundle root 解析;其他从文件所在目录解析。v0.2 或没有版本的 bundle 仍可从 root 解析路径。链接不是父子关系,层级只由目录树决定;链接是无类型的定向关系,具体含义由周围文字表达。

扩展机制变成了一等规则:扩展 key 可以在任何层级使用,包括 sources entries、verified events、executor、attester。编辑文件的 producer 必须保留它不认识的 key,避免一个工具覆盖另一个工具写的元数据。建议用 x– 命名,例如 x-acme-owner,确保将来规范版本不会冲突。版本策略:1.0 之前,minor 版本允许破坏性变更,但每项变更要给出 consumer fallback;1.0 开始,minor 版本严格增量,已发布的规范性文本不会原处修改。规范还列出了暂缓议题:typed relationships、完整 attestation runtime protocol(receipt 和 verdict wire format)、semantic-layer attestation、validity windows、refuted verification event,这些先用扩展 key 实验。与 OKF 配套的 use cases 解释某个行业标准与 OKF 的边界在哪里、如何链接两者、agent 应该如何处理组合,并提供可复制的完整例子。use cases 叠加在核心规范之上,不是规范一部分,忽略它们的 bundle 仍然符合规范。每个 use case 在仓库 usecases// 文件夹里,直接通过 GitHub PR 提议和评审。

v0.3 有两个破坏性变更,但 v0.2 bundle 保持可读。路径字段改为相对文件解析,旧 bundle 可回退到 root 解析;只有当前验证计入信任层级,这一条不需要回退,因为层级只会下降。v0.1 的回退(timestamp、body # Citations)继续适用。仓库还新增两个 agent skills:okf-generate 负责从可用来源写、更新、迁移和验证 bundle,每个声明都要引用来源,只在人确认时记录 human review,并从有授权的来源复制已验证的计算;okf-consume 负责从 bundle 回答问题时报告每个概念的 trust tier、status、freshness 和 attestation result,只通过 bundle 配置的 executor 和 attester 运行已验证计算。技能遵循开放的 Agent Skills 格式,支持 skills 的 agent 都能加载。项目已从 Google Cloud Platform 的 GitHub 组织迁到独立组织,仓库地址:https://github.com/open-knowledge-format/open-knowledge-format/。

Introducing OKF v0.3

查看原文