用途:供 agent 在 Open Knowledge Protocol 中检索结构化知识(角色、画风、操作手册、社媒分享等),并可通过 links 遍历概念之间的关系。本 skill 为只读,写入权限见 okp-import。
使用前提:需先确认 okp CLI 已安装并可连接 API: npm install -g @markbangwu/okp okp domains
检索流程(须按顺序):
- 确定 domain:okp domains,或用 okp domains -q <keyword> 模糊查找。返回字段有 domain、concept_count、has_readme、visibility;concept_count=0 表示已定义 README 但尚无 concept。private domain 未获邀请前不会出现在列表、搜索、sample、links 或 export 结果中。
- 读 domain README(必做):okp domain <domain>。README 定义数据是什么、有哪些 type、frontmatter 可过滤字段及搜索方式,禁止跳过 README 直接搜。
- 不熟悉时先 sample:okp sample --domain <domain> --limit 5,确认真实数据结构。
- 按 README 的 schema 精确搜索:如 okp search --domain <domain>;okp search --domain <domain> --type <type>;--tag <tag>;--filter <field>=<value>;okp search "<query>" --domain <domain>。多字段为 AND,时序数据用 --sort。
- Light list 后精读:搜索结果仅为摘要,选 1–3 条用 okp get <id> 获取正文,禁止批量拉取 body。
- 沿关系导航:okp links <id>,返回 outgoing 与 backlinks。
- 不满意时重读 README、改写 query(全名/简称/中英文)、调整 type/tag/filter,或换 domain 重新摸底。
常用 flag:--domain/-d、--type/-t、--tag、--filter key=val、--sort(如 date:desc)、--limit/-n。结果字段:id(domain/type/slug)、domain、type、title、description、tags、frontmatter,完整正文仅通过 okp get <id> 获取。
权限与范围:公开 domain 对所有已认证用户可读;private domain 仅对显式受邀的 reader/writer 和创建者 host 可见,全局 admin 也无读取旁路,须先接受邀请。知识导入/写权限/邀请码、domain README 维护(okp domain <domain> --set readme.md)、OKF bundle 导出(okp export <domain> --out <dir>)不在本 skill 范围。