SuperAPI AI 工具集

literature-survey

写作与研究

查看项目

更新于 10-15 21:49

技能介绍

用途:对某个研究问题做多来源、可饱和的结构化文献综述,产出证据/矛盾矩阵(主张×来源,标注每个来源的支持、反对或限定立场),而非一段概述。

主要能力:搜索→抽取→映射→扩展循环;每轮从真实检索中提取逐字片段作为单元格证据;主动寻找矛盾与空白;按新增“改变矩阵的来源”数量判断饱和;输出经 schema 校验的 matrix.json 与 survey.md(按共识、争议、空白组织,并附覆盖说明)。

使用方式:先交互式确认绑定项(问题、评估深度、矩阵路径、沙箱根目录、预算、耐心轮数、饱和阈值),写入 loop.run.yaml;检索依赖同级的 literature-search 技能,命令为 python3 <lit_skill_dir>/tools/lit_search.py,子命令包括 search、snippet、cite、fulltext,可加 --cache-dir <sandbox_root>/literature/.cache 复用缓存。评估深度分 low/medium/high,控制每轮查询数、引用遍历、全文阅读数与新来源上限。循环从 Round 0 种子开始,经扩展、纳入抽取、映射、饱和检查,记录 ledger.tsv,达到饱和、耐心或预算即停止。

适用场景:需要诚实呈现文献一致、分歧与沉默之处的多来源调研。

限制:不用于按文献给提案打分,也不用于提出新假设;缺失 S2_API_KEY 时降级为无密钥池或 WebSearch/WebFetch,并将证据标记为 web;不得编造来源、片段或立场;不安装依赖,密钥不得打印或提交;沙箱自包含,不允许 ../ 逃逸。具体安装与运行细节以官方资料为准,暂未提供更多。