菜单
为给定 Zotero 论文条目创建或完善 Better Note 风格的 Markdown 总结笔记。用于用户要求在 Zotero 中为某篇论文生成简洁清晰的中文总结时，尤其适用于需要先确认 Better Notes 与本地 bridge 插件可用、检查论文下是否已有总结、再按“研究动机”“研究内容”“核心技术或核心结论”三部分各写一段并提炼具体关键结论或技术的场景。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/yicheng-fu/skills --skill zotero-better-note-summary命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | zotero-better-note-summary |
| description | 为给定 Zotero 论文条目创建或完善 Better Note 风格的 Markdown 总结笔记。用于用户要求在 Zotero 中为某篇论文生成简洁清晰的中文总结时，尤其适用于需要先确认 Better Notes 与本地 bridge 插件可用、检查论文下是否已有总结、再按“研究动机”“研究内容”“核心技术或核心结论”三部分各写一段并提炼具体关键结论或技术的场景。 |
为单篇论文生成或完善可直接用于 Zotero Better Notes 的 Markdown 笔记，并在可用时自动把笔记创建或更新到 Zotero 的目标论文条目下。默认使用中文，输出三段式总结，每一部分只写一段，优先做到信息密度高、表达直白、便于快速回顾。
优先使用 Zotero Better Notes 插件和本 skill 自带的本地桥接脚本完成自动创建或更新；只有在用户明确接受纯文本草稿时，才退回到输出一份可直接粘贴到 Better Notes 的 Markdown 正文。
在正式总结前，必须先确认 Zotero Better Notes 插件和本 skill 的 Codex Zotero Bridge 插件都已安装并可用。先检查 Zotero 桥接：
python3 scripts/zotero_bridge.py ping
若命令成功返回 JSON，且 betterNotesAvailable 为 true，说明 Better Notes 和 bridge 都可用，可以直接读写 Zotero。
若命令超时或报错，说明 bridge 不可用。先构建并安装本 skill 附带的 Zotero bridge 插件：
python3 scripts/build_zotero_bridge_xpi.py
这会生成 assets/codex-zotero-bridge.xpi。帮助用户把该文件安装到 Zotero 的 Add-ons 或 Zotero profile 的 extensions/ 目录中，然后重启 Zotero，再重新运行 ping 确认可用。插件源码位于 assets/zotero-codex-bridge/bootstrap.js 和 assets/zotero-codex-bridge/manifest.json。
若 ping 成功但 betterNotesAvailable 为 false，说明 Better Notes 没有安装、没有启用，或尚未在当前 Zotero 会话中加载。先帮助用户安装或启用 Better Notes 并重启 Zotero；在 betterNotesAvailable: true 前，不要默认创建“Better Note 风格”的正式 note，除非用户明确只要一份可粘贴的 Markdown 草稿。
桥接就绪后，使用 scripts/zotero_bridge.py 完成以下操作：
先确认当前任务是“单篇论文总结”，而不是文献综述或多篇比较。若用户没有额外要求，默认：
如果用户显式要求英文或其他结构，按用户要求覆盖默认行为。
若用户没有显式给出 Zotero item key，且桥接可用，则默认以 Zotero 当前选中的单篇论文作为目标对象。先运行：
python3 scripts/zotero_bridge.py get-selected-item
若未选中条目、选中了多个条目，或返回对象不是单篇论文的顶层条目，则先纠正目标对象。
确认目标论文后，先检查该论文下是否已有论文总结 note：
python3 scripts/zotero_bridge.py list-notes --selected --include-content
若用户提供了明确的 Zotero item key，则改用：
python3 scripts/zotero_bridge.py list-notes --parent-key ITEMKEY --include-content
将标题或正文中包含 论文总结、研究动机、研究内容、核心技术、核心结论、summary 等特征的 note 视为候选已有总结。若找到候选，先询问用户是否基于已有总结修改完善，还是新建一条总结 note。询问时列出候选 note 的标题、key 和一句判断理由。
若用户选择修改已有总结，先阅读该 note 的 noteText，保留其已有有价值内容，在此基础上补充更具体的关键结论、技术细节和必要的结构调整。除非用户明确要求覆盖，不要直接丢弃原总结；写回前要确认目标 note key。
优先从用户提供的信息，或由 Zotero 桥接返回的标题、摘要、作者、年份、附件路径中提取关键信息，并围绕以下问题归纳：
若桥接返回 bestAttachment.path 且总结质量明显依赖正文细节，应优先进一步读取该 PDF 或附件，尤其是方法、实验设置、结果表和结论部分；否则根据标题、摘要和已有元数据给出简洁总结。
如果只能看到摘要或部分信息，明确按“基于摘要”或“基于可见内容”总结，不要把推断写成确定事实。
根据论文类型，在以下两种写法中二选一：
不要为了保持模板僵硬而误用“核心技术”。若论文的价值主要来自发现、结论或实证结果，就写“核心结论”。
严格输出以下三部分，每部分各一段，不拆成列表：
## 研究动机## 研究内容## 核心技术 或 ## 核心结论写作要求：
默认输出正文使用如下结构：
## 研究动机
...
## 研究内容
...
## 核心技术
...
若第三部分更适合写结论，则将最后一个标题替换为 ## 核心结论。
若桥接可用，优先自动创建 note，而不是只返回文本。推荐流程：
python3 scripts/zotero_bridge.py create-note --selected --markdown-file /tmp/paper-summary.md --title "论文总结" --open
若用户提供了明确的 Zotero item key，则改用：
python3 scripts/zotero_bridge.py create-note --parent-key ITEMKEY --markdown-file /tmp/paper-summary.md --title "论文总结" --open
python3 scripts/zotero_bridge.py update-note --note-key NOTEKEY --markdown-file /tmp/paper-summary.md --title "论文总结" --open
--title "论文总结" 会在正文前补一个顶层标题，目的是让 Zotero 中的 note 列表有稳定标题；不要把这个标题当作三段总结的一部分。
若桥接不可用且用户明确接受纯文本草稿，则直接返回 Markdown 内容，不要额外包裹解释性前言，并明确说明需要先安装桥接插件后才能自动写入 Zotero。
.xpi。/tmp/zotero-codex-bridge 请求并读取、创建或更新 note。交付前检查以下几点：
若论文信息不足，明确说明信息边界，但仍尽量给出可用的精炼总结。