在 Claude Code / Codex 里怎么提 Zotero 任务

这页只讲一件事：怎么自然开口。

如果你已经装了 zot-skills，就不要先想命令。直接把 Zotero 任务说出来。

最常见的开口方式

1. 查条目

直接说：

• “帮我在 Zotero 里找 reward hacking 相关的论文”
• “按 Smith2024 找到那篇文献”
• “看一下 Transformers 这个 collection 里有什么”

最好补的约束：

• 只看某个 tag / creator / year
• 先给我 3 篇最相关的
• 找到后继续给我引用

2. 取证据

直接说：

• “把这篇论文的 PDF 批注和 note 拉出来”
• “给我看这篇的详情、children 和引用”
• “把附件 ATCH005 下载到当前目录”

最好补的约束：

• 先告诉我当前环境支不支持 PDF / annotation
• 如果 key 不对，直接指出来

3. 建 workspace

直接说：

• “给我建一个 llm-safety workspace，把相关论文整理进去”
• “我后面要围绕 mechanistic interpretability 做问答检索”

最好补的约束：

• 名字用什么
• 导入范围按 query、collection 还是 tag
• 建好后要不要马上建索引

4. 保存查询

直接说：

• “把这个筛选条件保存成一个 Zotero saved search”
• “列出我现在有哪些 saved searches”

最好补的约束：

• 名字叫什么
• 条件是什么
• 是新建还是删除旧的

5. 安全写入

直接说：

• “给这篇文献加一条 note”
• “打上 priority 标签”
• “把这个条目挂到某个 collection”

这里最好顺手补一句：

• “如果当前环境没写权限，先告诉我缺什么”

这样 agent 会先过安全门，不会假装成功。

6. 配置排障

直接说：

• “先帮我看当前配置和默认 profile”
• “如果这个环境还没配好，就帮我初始化”
• “切到 work 这个 profile，再继续后面的任务”

什么样的说法最省事

推荐这种句式：

• “帮我在 Zotero 里……”
• “先从我现有的 Zotero 库里……”
• “如果当前环境不支持……就直接告诉我”
• “找到后继续……”
• “先别写库，只读分析就行”

这些句式会让 agent 更容易判断：

• 内容来自 Zotero
• 是只读还是写入
• 要不要先跑 doctor
• 找到结果后下一步要做什么

不推荐的说法

不推荐先说：

• “给我一个命令”
• “skills 里应该怎么调用 CLI”
• “你先把底层命令列出来”

这种说法会把注意力拉回执行层，不利于直接完成任务。

一条完整示例

你可以直接这样说：

帮我在 Zotero 里找 reward hacking 相关的论文。先给我最相关的 5 篇。然后挑一篇最值得读的，把详情、PDF 批注和 APA 引用都给我。如果当前环境拿不到 PDF 证据，直接告诉我缺什么。

这比拆成 4 个命令更好，因为 agent 能一次把主线跑完。