技能介绍

要解决的问题

研究工作里常见的断点是：文献在 Zotero，精读想法在 Obsidian，检索和提问又跳到另一个工具。结果不是找不到某条笔记，就是索引页看起来很完整，但结论其实来自模型常识，而不是 Vault 里的真实附件和批注。这个技能把三者接到一个可验收的最小闭环上，让一篇论文能从 Zotero 分类走到 Obsidian 笔记，再被 WorkBuddy 通过 Vault 实际定位。

工作方式

它不会重新实现论文分析。流程是先确认 Vault 路径、Zotero Desktop 和目标分类、是否允许写入精读结果，以及 WorkBuddy 中相关的 skills 是否已启用。随后区分两种入口：新建 Vault 时读取 references/setup-guide.md 并运行初始化脚本；检查已有 Vault 时只报告缺失项和冲突，在征得同意后补建，且不移动或重命名用户既有笔记。

处理 Zotero 分类时，先验证可访问，再精确确认分类名称和条目数量，用一篇论文做端到端试运行。确认元数据、全文、批注和附件可用后，按 templates/paper-template.md 生成笔记写入 notes/，并在 Frontmatter 的 collection 中保留 Zotero 分类。接着更新处理日志和索引，单篇验收通过后才批量处理；批量运行支持断点续传，并以稳定的 item key 而不是标题判断重复。

使用边界

Dataview 是可选展示层，不是知识库的数据来源。未安装 Dataview 时，Markdown 笔记仍应可读；索引依赖稳定 YAML 属性和目录约定。安装社区插件、启用 Zotero 本地 API、批量写入或修改 Obsidian 设置前，需要遵循当前环境的授权规则。技能不得扫描整台电脑、处理整个 Zotero 库或覆盖已有 Vault。验收时会区分已验证、未验证和需要用户操作的步骤；如果只有元数据没有全文，或 WorkBuddy 查不到笔记，应回到日志、附件权限和实际写入路径排查，而不是用常识补结论。