用途：zot-brainstorm 用于把真实的 Zotero 文献来源集转化为有据可依的研究头脑风暴报告，每个主要发现、缺口与提出的创新方向都应能回溯到 Zotero 条目键或引用。它属于综合（synthesis）技能，所有 Zotero 读取以 zot 为执行层；当命令路由不明确时参考 ../zot/SKILL.md。
触发场景：从若干 Zotero 集合头脑风暴研究方向；跨工作区分析局限性或缺陷；从明确条目键提出创新点；基于选定参考文献生成本地 Markdown/HTML 报告；跨来源集比较主题、证据强度、缺口与下一步想法。不适用：普通网络文献检索（除非用户明确要求补充网络来源）、常规 Zotero 查询/工作区维护/标签/笔记/集合编辑、单篇论文摘要且不含头脑风暴或综合诉求、非 Zotero 的 PDF 审阅、需要 zot mcp serve 的工作流。
主要能力：构建每条文献的证据记录（条目键、标题、作者、年份、类型、发表信息、DOI/URL、摘要与元数据、来源归属、笔记/批注/子项/PDF 全文/大纲/引用导出、证据等级）；划分证据等级为 fulltext、metadata+abstract、annotations、notes、missing；按顺序进行来源覆盖、主题图、共识图、冲突图、缺陷分析、头脑风暴、打分排序与可追溯性映射；生成默认报告章节，并使用 templates/report.md 与 templates/report.html 作为模板。
使用方式：单次运行统一走一条调用路径，优先 zot --json ...；仅在本仓库内，当 zot 不可用时回退到 cargo run -q -p zot-cli -- --json ...。在执行大规模来源提取、PDF/全文/批注工作、工作区索引/查询或任何可选写入路径前先运行 doctor。来源输入包括 Zotero 集合名称/键、工作区名称、明确的条目键及混合集合，按集合 get/search/list/items、工作区 show/list/index/query（嵌入不可用时用 --mode bm25）、条目 get/children 等命令解析；未解析的键应停止并报告，不得静默丢弃。保存时若未给路径，默认写入 zot-brainstorm-reports/<yyyy-mm-dd>-<topic-slug>/ 下同时生成 report.md 与 report.html，除非明确只要一种格式。最终回复须包含：每个已保存报告的本地路径、所用证据基础、未解决的来源或证据缺口、Zotero 是否保持只读。
限制：默认对 Zotero 保持只读；本地 report.md 与 report.html 允许，而 Zotero 笔记、集合、保存搜索、Obsidian 同步、vault 写入或外部发布需单独的明确请求并遵循 base zot 安全门。不得直接读写 zotero.sqlite；不得虚构 zot brainstorm、search-in、expand、s2 或 zot mcp serve 等命令。须保留证据边界：仅有元数据/摘要时不得写出听起来像全文支撑的论断。若 doctor 报告无 PDF 后端，则以元数据/摘要/笔记/批注继续并标注全文论断不可用；嵌入不可用时避免纯语义论断。来源输入含糊时在展示候选后提最小澄清问题；请求来源缺失时在综合前停止，除非用户明确要求用剩余来源继续；语料较大时先总结覆盖范围并提出按集合、工作区、主题、年份或查询限定的分批方案。HTML 报告须自包含且离线：无 CDN、远程字体/图片/脚本/样式表、分析、fetch/XHR 或隐藏网络调用，需有可访问标题与 landmark、跳转链接、焦点样式、表格标题与 scope 属性、不依赖颜色的可见置信度/状态文本、打印友好 CSS 及中英混排安全换行，并优先使用密集证据表格。