Open Knowledge Format（OKF）と iknow

Open Knowledge Format（OKF）と iknow

出典:

• 公式仕様 OKF SPEC.md（Version 0.1 — Draft）（GoogleCloudPlatform/knowledge-catalog、Apache-2.0）
• 解説 Introducing the Open Knowledge Format（Google Cloud Blog、2026-06-12）

OKF は LLM Wiki パターンを ポータブルで相互運用可能なオープン仕様 として形式化した標準です。2026-06-30 時点の最新は v0.1（Draft） で、後続バージョンはまだ出ていません（詳細は「最新状況」節）。

OKF とは

OKF bundle の構造

sales/
├── index.md
├── datasets/
│   ├── index.md
│   └── orders_db.md
├── tables/
│   ├── index.md
│   ├── orders.md
│   └── customers.md
└── metrics/
    ├── index.md
    └── weekly_active_users.md

• 1 ファイル = 1 concept（テーブル、メトリクス、手順書など）
• ファイルパスが concept の ID
• concept 同士は Markdown リンク でグラフ化
• 任意で index.md（カタログ）と log.md（変更履歴）を含む

YAML frontmatter（v0.1）

---
type: BigQuery Table
title: Orders
description: One row per completed customer order.
resource: https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders
tags: [sales, revenue]
timestamp: 2026-05-28T14:30:00Z
---

設計の3原則

1. Minimally opinionated — type 以外はプロデューサーに委ねる
2. Producer/consumer independence — 書く側と読む側が独立して交換可能
3. Format, not platform — 特定クラウド・DB・モデルに非依存

最新状況（2026-06-30 時点）

バージョン宣言とポリシー（SPEC §11）

• bundle は ルートの index.md の frontmatter に okf_version: "0.1" を書いて対象バージョンを宣言できる（index.md に frontmatter を置ける唯一の例外）。
• マイナー更新＝後方互換の追加（任意フィールド・慣用見出しの追加）、メジャー更新＝破壊的変更（必須フィールド名や予約ファイル名の変更）。
• consumer は理解できないバージョンでも 拒否せずベストエフォートで読む。

v0.1 仕様で確定した要点（現行ナレッジへの補足）

• Concept ID = ファイルパスから .md を除いたもの（例: tables/users.md → tables/users）。
• 予約ファイル名は index.md と log.md のみ。それ以外の .md はすべて concept。
• 本文の 慣用見出し として # Schema / # Examples / # Citations が定義（必須ではない）。外部出典は末尾の # Citations に番号付きで列挙する。
• リンクは無向の関係を表す有向エッジ。/ 始まりの bundle ルート相対リンクが推奨。consumer は リンク切れを許容 しなければならない。
• 適合条件（§9）はゆるい：各 concept に解析可能な frontmatter があり、空でない type を持てば適合。任意フィールド欠落・未知の type・リンク切れ・index.md 不在では 拒否しない。
• ドメイン固有スキーマ（Avro / Protobuf / OpenAPI 等）は 置き換えず参照する（非ゴール）。

iknow と OKF の位置づけ

iknow は LLM Wiki 思想（No.10.1） を実装したプラットフォームです。OKF はそのパターンを ファイル交換フォーマット として標準化したものと捉えられます。

flowchart LR
  OKF["OKF bundle（ファイル形式）"] <-->|エクスポート/インポート| IK["iknow（プラットフォーム）"]
  LLM[LLM Wiki 思想] --> OKF
  LLM --> IK

iknow の frontmatter 出力

iknow はナレッジを エクスポート するとき、本文の先頭に YAML frontmatter を付与し、インポート時に読み戻します。OKF 準拠キー（type・title・tags・resource・timestamp）に加え、iknow 独自の no・related_nos（関連ナレッジ復元用）・service_name / service_key（インポート元）を出力します。

type は OKF では concept 種別ですが、iknow では本文形式（markdown / json）を表します。項目の一覧は No.1.3 を参照してください。

OKF との対応（準拠・差分）

3表に分かれていた比較を 1 つにまとめます。

iknow から OKF へ近づけるには

Ingest（No.13.1）で外部資料を取り込むとき、OKF 互換を意識するなら:

1. concept 種別をタグで補う — frontmatter の type は本文形式（markdown/json）なので、OKF の concept 種別はタグで表す（例: BigQuery Table）
2. 冒頭に description 相当の 1 行要約 を書く
3. 出典 URL を残す — resource frontmatter と本文冒頭の両方に
4. 関連ナレッジと本文リンクを両方張る — OKF consumer も iknow Query も満たす
5. No.0 目次を常に更新 — index.md 維持と同じ運用
6. ZIP エクスポート前に No を振る — related_nos によるリンク復元のため

まとめ

iknow でナレッジを育てる運用（Ingest → Query → Lint）は OKF の思想と一致します。将来 OKF へのエクスポート／インポートが強化された場合も、No.0 目次・タグ・関連リンク・1 テーマ 1 ページ の設計を守っておけば移行コストを下げられます。