Agent skill · huangwb8
research-literature-search
当用户只需要检索候选论文、建立可审计文献池、为研究选题或其它下游证据任务准备候选文献时使用。执行查询契约校验、多源检索、规范化、去重、来源追踪并输出可验证 manifest bundle；不负责相关性评分、最终选文、综述写作、BibTeX 或 PDF/Word 导出。也可被 research-literature-review 作为必需依赖调用。
What it needs
About 1k tokens when loaded.
What this skill does
Research Literature Search 定位与边界 本 Skill 是文献检索生产者：把主题和 5–25 条查询转换为一个可复核的候选文献 bundle。它只负责召回、字段规范化、canonical 去重、来源审计和可选摘要补全；评分、纳入/排除判断、子主题、参考文献配额、正文和导出交给下游 Skill。 research-literature-review 必须通过本 Skill 的 manifest 和 canonical 候选消费检索结果，不得在阶段 1/2 复制 provider 或再次改变 canonical 去重结果。 输入契约 必需：topic 和显式查询 JSON（--query-file/--queries）。支持 {"queries": [...]}、对象数组、字符串数组。 空查询会剔除；有效查询默认 5–25 条，数量不满足时 fail-closed。 可选：domain、年份/文献类型/预印本过滤、provider 顺序、每查询/总量上限、scope root。 所有输出路径必须位于调用方指定的 scope root 内；不接受路径穿越或 manifest 中的外部绝对路径。 流程 输入 按用户请求和配置文件提供必要输入；缺失信息应明确列出并停止依赖该输入的步骤。 执行步骤 run 默认不对全量候选强制补全。使用 enrich-abstracts 对 selected 或指定子集处理；输出 abstractstatus、abstractprovenance、缺失摘要 warning 和统计。综述仍在选文后调用该能力，以保持请求量和选文行为兼容。 输出 每次运行都生成独立目录，manifest.json 是唯一入口： 候选 schema 版本为 rls.paper.v1，必须有非空 title、字符串数组 authors、identifiers、abstractstatus、publication、sources、querymatches 和 qualitywarnings；同时在边界生成 doi/abstract/venue/year/url/source 等旧扁平字段。缺失值用 null/[]，不填虚构占位文本。 manifest 的 status 只有三种语义：success（完整成功）、partialsuccess（仍有可用候选但存在失败/跳过/截断/字段缺失）、failed（输入、路径、provider 或产物不可消费）。research-literature-review 只接受前两者，并校验 artifact hash、schema 和数量。 输出管理 临时产物写入任务工作区，正式交付物写入项目约定位置；未经授权不覆盖或删除已有文件。 校验 完成后执行 Skill 已有的静态检查、脚本验证或人工复核，并记录通过标准。 失败与恢复 默认行为锁定为 OpenAlex 主力；结果不足时按策略补充 Semantic Scholar/Crossref。mcp 与 duckduckgo 在纯 Python runner 中记录为 skipped/host tool required，不能伪装成功。每次尝试都写入 manifest attempts 和 Search Log。新 provider 或 union 召回策略需要升级 contract，不在本版本隐式引入。manifest contract 常量由独立命名的 rlscontract.py 提供，避免被下游 review skill 的同名模块遮蔽。 Provider 返回 null 结果或列表中混入 null / 非对象条目时，边界层必须跳过无效条目而不能调用 .get()；合法条目继续参与召回、规范化和去重。每次尝试在 attempts 中记录 emptyrecords / invalidrecords，运行级 counts 同步累计并写入 warning。若没有任何合法候选，使用 novalidcandidates 说明是数据无效导致的失败；不得静默丢弃或把空记录计入召回配额。 约束 JSON 使用 UTF-8、稳定排序和确定性序列化；相同夹具/配置下候选顺序可比较。 manifest 保存查询文件 SHA-256、provider policy、attempts、截断数、去重参数、缓存模式、版本和每个 artifact hash。 旧 title/year/id 记录只能通过显式 legacy adapter 适配，并附加 legacyadapted warning；不能冒充新 schema。 不把 API key、Cookie、完整响应或其它凭据写入 raw/provenance/log。 公共硬约束 任务需要落盘时，使用 …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills huangwb8/research-literature-search