SuperAPI AI 工具集

reference-reading-summarizer

写作与研究

查看项目

更新于 10-15 08:33

技能介绍

Reference Reading Summarizer 是一个用于阅读和总结项目参考文献来源的技能,其输出为结构化的、版权安全的来源卡片。根据技能说明,它回答的核心问题是:这份来源说了什么?技能同时明确提醒,不要强制将每一份来源都关联到项目决策;如果确实需要项目层面的含义,应在来源卡片已存在且项目含义重要时,再使用 reference-project-synthesizer。

用途与来源类型

该技能面向需要处理多种参考资料的研究与写作场景。支持的来源类型包括:paper-or-pdf(论文 PDF、报告、幻灯片导出或其他 PDF 参考资料)、collaborator-doc(PDF、Word、文本反馈或协作者撰写的笔记)、markdown / text-note / latex-source(笔记、规格、草稿或设计文档)、bibliography(BibTeX 集合与引用集)、script / notebook / config-or-spec(实现提示、协议、任务定义),以及 bundle(包含多个文档、脚本、BibTeX、配置并应作为一个整体解读的文件夹)。

主要能力:阅读模式

技能按“阅读模式”来提取内容,而不是默认穷尽阅读。可用模式包括:skim(判断相关性、角色标签、是否需要深入阅读)、extract-writing(引言框架、段落推进、贡献措辞、图表说明)、extract-method(算法、目标、架构、推理、实现细节)、extract-theory(假设、定理陈述、证明思路、形式化定义)、extract-benchmark(任务、数据集、划分、指标、协议、算力、评估注意事项)、extract-baseline(基线方法角色、公平条件、比较要求)、extract-risk(最接近工作的威胁、新颖性边界、审稿人攻击面)、extract-feedback(协作者评论、要求的修改、矛盾、决策、待办事项)、extract-spec(需求、约束、接口、验收标准、项目假设)、extract-bundle(捆绑清单、内部关系、最有用的文件、缺失的上下文)、extract-implementation-hints(可复用脚本、配置、API、预处理、命令、陷阱)、extract-project-seed(初始想法、问题、假设、资源、开放问题、首批行动),以及 deep-read(高价值来源,误解会改变项目方向时使用)。

模型路由

技能采用分层模型路由。Tier 0 为确定性工具,用于元数据、文件清单、页面/文本提取、捆绑清单;Tier 1 为低成本辅助模型,用于略读、简单卡片骨架、写作模式提取、捆绑清单;Tier 2 为主模型,用于基准/协议提取、方法提取、协作者反馈结构化、引用支持;Tier 3 为强模型/深度模型,用于核心理论、最接近工作、必备基线、最终论文声明、项目种子、协作者决策冲突。以下情况应升级模型:来源是最接近工作、核心算法来源、理论来源、基准来源、项目种子或协作者约束;或者卡片将支持某项声明、实验、基线、实现、论文修改或 rebuttal。

使用方式与工作流

使用流程为:首先定位 reference/.agent/source-index.md,若不存在则回退到 reference/.agent/reference-index.md;然后识别来源路径、来源类型和请求的阅读模式;当提取并非简单操作时,在 reference/.agent/runs/<run-id>/ 下创建运行产物,包括 input-manifest.md、extraction-notes.md、model.json、decision.md;仅提取所需的文本、页面或文件,优先使用本地工具,若不可用则基于已有元数据继续并标注限制;将 templates/source-card.md 填入 reference/cards/<source-id>.md,对于纯论文,templates/paper-card.md 仍作为兼容的子类型;在适当情况下将 reference/.agent/processing-status.md 从 unread 或 skimmed 更新为 carded,若存在 reading-status.md 也一并更新以保持兼容。技能会写入 reference/cards/ 和 reference/.agent/;项目级记忆回写(claim/evidence/risk 面板)由 reference-project-synthesizer 在综合之后负责。之后按需路由:需要项目含义则转到 reference-project-synthesizer,需要广泛领域地图则转到 literature-review-sprint,需要引用覆盖则转到 citation-coverage-audit。

来源卡片规则与限制

每张卡片应包含:元数据与来源类型、阅读模式、角色标签、仅与相关部分对应的摘要或提取内容、局限性与不确定性、可复用资产、溯源与置信度。技能明确要求不得将低成本的 skim 卡片变成强结论,并在适当情况下标注 confidence: skim 或 needs-deep-read。核心契约还要求保留溯源信息,如来源路径、来源类型、检查过的页/节/文件、阅读模式、模型层级、置信度和审阅状态;不得将长篇原始来源文本粘贴到卡片中,而应总结并指向具体页/节/文件;并始终区分来源内容与项目含义。技能目录布局包含 SKILL.md、references/(model-routing.md、reading-modes.md)和 templates/(source-card.md、paper-card.md、reading-run.md)。关于收费、价格、平台支持范围或实际效果,资料中暂未提供。