SuperAPI AI 工具集

zot-skills

智能体与模型

查看项目

更新于 10-15 17:24

技能介绍

用途:该 skill 面向 Claude Code、Codex 或类似 agent,把用户的自然语言 Zotero 任务路由到 zot 命令行执行,操作已有本地 Zotero 库或 reading workspace,即使用户未提及 zot 也适用。

主要能力:库内检索(library search)、citation key 直达(library citekey)、最近入库(library recent --count)、collection 读取、库级标签与 feeds;单篇证据提取(item get / children / cite / export、item pdf / fulltext / outline、item annotation list / search、item download);workspace 的 new / add / import / index / search / query;saved search 的 list / create / delete;安全写入(note、tag、update、add-doi、add-url、add-file、merge、collection 关系、duplicates 管理、sync update-status);配置排障(doctor、config show / init / set、profiles list / use)。

使用方式:自然语言提出需求,由 skill 转为运行时动作。已安装 zot 时优先 zot --json ...;仅在开发仓库且 zot 不在 PATH 时退回 cargo run -q -p zot-cli -- ...,同一轮保持一种调用方式。首次接触环境、任何写操作、PDF/批注/附件任务、语义检索、citation key 与配置排障,默认先运行 zot --json doctor。

重要约束:--library 只接受 user 或 group:<id>;workspace 名须为 kebab-case;zot mcp serve 当前不可用;item add-file 不支持 --attach-mode;annotation create 仅适用于 PDF attachment;saved-search 处理的是查询条件而非结果项;禁止直接修改 zotero.sqlite。高风险写操作(trash、note delete、merge --confirm、collection delete、saved-search delete、duplicates-merge --confirm、sync update-status --apply)应先总结变更再执行;无写权限时停在只读分析。缺乏 Better BibTeX、Pdfium、embedding 时相关能力会降级或不可用。s2、search-in、expand、field-scoped metadata search、zotagent 风格全量附件索引等当前未实现。输出应先给结论与证据,而非 raw JSON。