用途:这是 OpenKnowledge(OK)项目的智能体操作契约。OK 是通过 MCP 暴露的 Markdown-CRDT 协作知识库,本技能规定在该项目内读写内容的规范做法。
主要能力:提供工具路由索引,包含 exec(读取文件与目录并附文档上下文)、search(排序检索)、links(链接关系)、lint(内容规则检查与自动修复)、audit(内容规则与内部链接校验)、write/edit/delete/move(写入、就地修改、删除、移动)、install/import(技能来源与导入)、history/checkpoint/restore_version(版本)、skills(按名称与作用域发现技能)、palette、config、preview_url、share_link 等 19 个工具。
使用方式:读取用 exec("cat …")、exec("ls -A …")、exec("grep …"),检索用 search;写入用 write({ document: { path, content } }),正文替换用 edit({ document: { path, find, replace } }),frontmatter 用 edit({ document: { path, frontmatter } }),删除用 delete({ document }),移动用 move({ from, to })。每次内容写入附带不超过 80 字符的一行摘要。写作前先执行 exec("ls -A <folder>") 查看文件夹规范与模板。
适用场景:在 OK 项目内读取、创建、编辑、审校与版本管理文档,处理来源引证、内部链接、文件夹与模板,以及预览和共享。
限制:对项目内 .md/.mdx 必须经由 OK 的 MCP 工具,禁止使用宿主的原生 Read/Grep/Glob/Edit 等;仅当未注册 OK MCP 或调用确实失败时,才可在用户可见句首注明 OpenKnowledge MCP unavailable: 后使用原生工具。源码等非 Markdown 文件仍用原生工具。每项事实性声明须引用库内来源,裸外链只是待办。具体 setup、ingest、research、consolidate 等细节在 references 中,其中 research 与 consolidate 需 ok seed --pack knowledge-base 提供。更多命令与配置资料暂未提供。