用途:该技能提供 OKF v0.2 的语义规范指导,用于创建、阅读、审阅与维护 OKF bundle,并处理 OpenKnowledge okf 插件的相关响应。其 /open-knowledge 技能负责工具使用,本技能专注 OKF 语义。
主要能力与核心规则:bundle 是 .md 文件的目录树,每个非保留文件是一个概念,去掉 .md 的路径即其 ID。每个概念必须带有可解析 frontmatter,且含非空字符串 type,其他字段均非始终必需。类型为开放词汇,消费者必须接受不熟悉的类型与元数据。关系使用标准 Markdown 链接;允许断链与缺失索引。index.md 和 log.md 在每层均为保留文件,文件名用小写。index.md 通常无 frontmatter,仅根索引可声明 okf_version: "0.2"。log.md 按最新在前排列,条目标题以 ISO 日期开头,如 ## YYYY-MM-DD: Summary,日期后可省略摘要,裸 ## YYYY-MM-DD 同样合规。消费者读取 .md,而非 .mdx。
撰写判断:每个概念应是可链接或引用的最小有用单元;选用稳定、描述性的类型,Document 仅作通用兜底。不得编造事实、关系、资源、来源、验证或历史;缺失知识优于虚假结构。title、description、resource、tags 仅在增加真实信息时使用。在 sources 中记录来源,通过匹配 sources[].id 与 Markdown 脚注进行陈述级引用。生成者与验证者需分开:generated 表示谁产出内容,verified 表示谁确认内容,适用时使用精确小写的 human: 与 process: 前缀。所有来源时间戳须为带显式 UTC 偏移的 ISO 8601 日期时间(如 stale_after: 2026-12-31T00:00:00Z),不得使用裸日期或无偏移时间,涵盖 generated.at、verified[].at、stale_after、sources[].last_modified 及 usage_window 两端;而 log.md 条目标题仍是纯 YYYY-MM-DD 日期。status: deprecated 与已过期的 stale_after 视为信任信号而非校验错误。对 type: Attested Computation,遵循声明的 runtime 与 parameters,不得改写既定计算。
读取与维护:从最近的 index.md 开始,查看 frontmatter,再仅跟随相关链接;优先采用当前、已验证来源,但容忍未知类型与不完整链接。若 bundle 与假设冲突,以 bundle 为准;若缺失或不一致,应如实说明。将持久发现写回相关概念与作者枚举。在持久修改后,若 bundle 使用日志,添加真实的带日期 log.md 条目。可读取旧版时间戳与正文引用,但更新概念时优先 v0.2 的 generated.at 与 sources,迁移时不得编造来源。
okf 插件:可选项目插件提供持续可移植性反馈且不阻塞写入。写入时警告与项目审计检查结构、frontmatter、保留文件、链接及 .mdx 使用。.ok/okf/*.schema.json 含精确字段契约,应读取这些生成文件而非猜测,且不要编辑。确定性 lint 结果确立合规性,但元数据是否真实有用仍由智能体判断。可选索引生成会维护 index.md,生成的索引归机器所有,切勿编辑,因为 OpenKnowledge 会替换其内容;log.md 仍为人工撰写而非生成。插件默认关闭,每条规则可禁用,其价值在于当 OpenKnowledge 原生内容可能被其他 OKF 消费者误读时提前预警。
限制与暂未提供:资料未说明具体安装命令、价格、平台支持范围或性能数据。