用途:面向学术论文查找请求,例如“找关于某主题的论文”“文献怎么说”“有没有相关研究”。
主要能力:多来源学术检索并自动去重、DOI 解析与期刊过滤。来源包括 scholar lookup(关键词/引用排序,默认启用)、consensus CLI(实证语料,按引用排序,默认启用)、Paperpile bib(个人库 My Library.bib,默认启用),以及可选的 scholar search(自然语言语义检索,需加 --scholar-search,因与 lookup 共享限流)。
使用方式:必须使用脚本而非手动依次运行各来源。命令为 uv run python3 "${CLAUDE_SKILL_DIR}/scripts/research.py" "<query>" [--n 50] [--min-citations N]。常用参数:--journals-only 在 consensus 来源服务端按可信期刊列表过滤;--n 控制结果数;--min-citations 设引用下限;--no-stream 关闭流式、等全部来源完成后输出格式化 JSON。默认流式模式按事件输出 NDJSON,source 事件为各来源原始结果,final 事件为去重并解析后的统一集合。
结果处理:脚本输出 JSON 数组,字段含 title、authors、year、journal、journal_resolved、doi、citations、takeaway、url、sources。展示前须读取 ${CLAUDE_PLUGIN_ROOT}/references/trusted-journals.local.md,用 journal_resolved(若存在)否则 journal 与可信列表比对,命中标 ★;多来源命中表示置信度更高;来自 bib 的标记为已在个人库。展示时可信论文按引用降序优先,其余放入折叠表格。
限制与注意:不要手动串行运行来源,会显著增加耗时;不要直接调用 mcp__consensus__search(限 3 条结果);展示前必须先读可信期刊文件;向可信列表追加期刊前需先用 consensus journals "<partial>" 验证确切名称,否则会静默失效;存在 journal_resolved 时应优先使用而非 journal。若 skill-toc 不可用,references 与 scripts 不会被列出,需安装 plugin-utils 插件或新开会话使 bin/ 进入 PATH。