用途:OKF(Open Knowledge Format,v0.2,由 Google Cloud 发布)是一套厂商中立的开放规范,把知识表示为「Markdown 文件 + YAML frontmatter」组成的目录树(bundle),无需 SDK。本技能用于创建、校验和丰富 OKF bundle,让不同生产者编写的知识库可被不同智能体直接消费。
主要能力: 创建 bundle:每个概念一个 .md 文件,仅 type 为必填字段;推荐填写 title、description、resource、tags。v0.2 增加信任与生命周期字段(generated、verified、status、stale_after)、溯源字段(sources、usage_window)以及 type: Attested Computation 概念(含 runtime、parameters、executor、attester)。 交叉链接:使用标准 Markdown 链接,绝对路径 customers 优先,相对路径亦可;允许存在失效链接。 溯源与脚注:在 frontmatter 的 sources 中记录来源,并在正文用脚注引用。 生成 index.md(按目录做渐进披露,无 frontmatter)与 log.md(按 ISO 8601 日期倒序记录变更)。可信度由 verified 字段派生:unverified、machine-confirmed、human-reviewed。
使用方式: 校验优先使用 okflint: uv tool install okflint pip install okflint okflint validate --manifest okf-base.yaml ./bundle/ okflint audit --bundle ./bundle --vault ./bundle okflint validate --manifest okf-base.yaml --json ./bundle/ okflint index --manifest okf-base.yaml --apply 未安装 okflint 时可用 scripts/validate.sh 做基础校验。核心三条一致性规则:每个非保留 .md 有可解析 YAML frontmatter、frontmatter 含非空 type、保留文件符合既定结构。
适用场景:数据表、指标、API、手册等组织知识的编写与校验;需要审计轨迹的财务指标计算等可验证、可复现的计算。
限制:信任层级只是建议性信号,不是访问控制;消费者不应因缺少可选字段、未知 type、失效链接或缺少 index 文件而拒收 bundle。具体平台、收费与效果资料暂未提供。