SuperAPI AI 工具集

reference-corpus-analyzer

写作与研究

查看项目

更新于 10-13 15:03

技能介绍

用途

Reference Corpus Analyzer 用于把一个文献语料库综合成结构化的对比矩阵。它回答的问题是:在这 N 篇论文中,谁做了什么、彼此有何差异、空白在哪里。

适用场景包括:related-work 写作需要跨多篇论文的方法并排对比;想识别最接近的 3–5 篇论文并理解它们彼此的确切差异;文献综述需要跨发表年份或会场进行趋势识别;在撰写 related-work 部分前梳理一组现有方法的开放空白;已有 5 张以上源卡片并希望得到对比表而非单篇摘要。

不适用场景:本技能不用于创建单篇论文的源卡片(应使用 reference-reading-summarizer);也不用于把论文与项目主张关联(应使用 reference-project-synthesizer)。本技能应在源卡片已存在后使用;除非卡片信息不足,否则避免重新阅读原始 PDF。

配套技能:上游 reference-reading-summarizer 用于先产出源卡片;上游或下游 reference-project-synthesizer 用于在对比前后将单篇论文链接到项目记忆;下游 related-work-positioning-writer 使用对比矩阵撰写新颖性边界段落;下游 baseline-selection-audit 使用排名识别必备基线;literature-review-sprint 用于语料尚未汇集、需要先做更广泛主题调研时。

技能目录布局

<installed-skill-dir>/ ├── SKILL.md └── templates/ └── comparison-matrix.md

渐进式加载

在阅读原始来源前,先阅读 reference/cards/ 以找到可用的源卡片。 阅读 reference/.agent/source-index.md 或 reference/.agent/reference-index.md 获取语料库清单。 当对比需要锚定到具体项目主张时,阅读 memory/claim-board.md。 在撰写输出矩阵前,阅读 templates/comparison-matrix.md。

核心原则

分层深度:只深入阅读最接近的前 N 篇论文,其余略读以用于定位。 对比矩阵是项目产物,不是自由文本文章——它应当是可查询的。 对最接近工作的排名需要明确标准:任务重叠、方法重叠或主张重叠。 空白应具体陈述:“没有论文在约束 Y 下做 X”优于“X 未被充分探索”。 不得编造源卡片或论文本身未陈述的论文属性。

步骤 1 —— 汇总语料库

阅读 reference/.agent/source-index.md(或 reference-index.md)列出可用来源。 对每个来源记录:来源 ID 与标题;卡片可用性(has-card、no-card、partial-card);初始相关性估计(core、related、background、tangential)。 若看起来高度相关的来源缺少卡片,先路由到 reference-reading-summarizer。

步骤 2 —— 选择分层阅读深度

为每个来源分配阅读深度:Deep 层(按任务+方法重叠最接近的前 3–5 篇)——完整源卡片,卡片不足时重读原始来源;Standard 层(接下来 5–10 篇相关工作)——仅源卡片;Survey 层(其余背景论文)——标题+摘要+卡片小结。 “最接近”的标准:相同任务、相同主张类型、方法族重叠或共享基准。

步骤 3 —— 构建对比矩阵

阅读 templates/comparison-matrix.md。可对比的维度(选择与项目相关的):任务/问题;方法族(核心机制,如 attention、diffusion、RL、prompting 等);关键创新(论文声称贡献的单一要点);基准/数据集;主要指标;最佳报告结果(头条数字,并附会场与年份以提供语境);承认的局限;与本研究的关系(更接近/互补/正交/被本研究取代)。 对每篇一级(深度)论文,另加:与本研究最接近的主张;关键差异点(一句话说明本研究与该论文的不同)。 保存到 reference/corpus-analysis-<date>.md。

步骤 4 —— 对最接近工作排名

产出前 5 篇最接近论文的排名列表,包含:排名;论文(标题、会场年份);重叠度(task=high/method=medium/claim=high);最接近主张;差异点(一句话);新颖性风险(high/medium/low);审稿人动作(作为最接近工作引用/作为基线引用/作为背景引用)。 新颖性风险 high 且 method 重叠 high 的论文,其 related-work 段落需要最清晰的边界陈述。

步骤 5 —— 识别空白与趋势

空白:语料库中尚无任何论文处理的(任务、方法、约束、基准)组合。格式示例:Gap:没有论文在约束 Y 下用方法族 Z 处理 X。Evidence:论文 A、B、C 处理了 X 但不在 Y 下;论文 D、E 处理了 Y 但未处理 X。Opportunity:本研究通过……填补该空白。 趋势(可选,用于 survey 模式):过去 3 年哪些方法族的论文在增加/减少?哪些基准正在成为标准或逐渐弃用?哪些主张两年前有争议而现在被接受?

步骤 6 —— 写回记忆

用阅读深度分配更新 reference/.agent/source-index.md。 对任何高新颖性风险的最接近工作发现,更新 memory/risk-board.md。 若对比改变了某主张的新颖性表述,更新 memory/claim-board.md。 对比矩阵本身保存在 reference/ 中,不要复制到 memory/。

最终检查

一级论文已按完整卡片深度阅读;对比矩阵在所有论文间维度一致;前 5 最接近工作排名的差异点均为一句话;空白陈述具体(而非模糊的“未来工作”措辞);新颖性风险论文已标记给 related-work-positioning-writer。