SuperAPI AI 工具集

reference-library-manager

写作与研究

查看项目

更新于 10-15 08:33

技能介绍

Reference Library Manager 是一个面向研究项目的参考资料库管理技能,目标是把项目中的 reference/ 来源目录当作持久的研究基础设施来维护。它要回答的问题是:我们手头有哪些来源,以及这些来源处于什么处理状态。

用途 该技能用于扫描、摄取、索引、去重、监控和跟踪来源的处理状态。它不用于深入理解来源内容,也不用于分析来源对项目的意义。如果用户想知道“这个来源说了什么”,应使用 reference-reading-summarizer;如果想知道“这个来源对我们的项目意味着什么”,应使用 reference-project-synthesizer。

主要能力 技能目录包含 SKILL.md、scripts/scan_reference_library.py、references/library-policy.md,以及 templates/reference-index.md 和 templates/reading-status.md。核心约定包括:默认项目参考根目录为 <project-root>/reference/;来源可以是论文 PDF、协作者提供的 PDF/Word 文档、Markdown 笔记、BibTeX 文件、脚本、规格/配置、笔记本、网页快照或手工构建的文件夹包;原始来源文件可能涉及隐私、许可、体积较大或由协作者提供,不应假定可以提交到公开仓库;只有在经过脱敏且有用时,才提交派生索引、来源卡片和项目使用笔记;优先使用确定性扫描处理文件名、哈希、大小和修改时间;廉价 sidecar 仅用于模糊标题匹配或元数据清理,不用于存储原始来源。

使用方式 技能预期项目布局为 reference/ 下包含 sources/(非论文来源和包,通常被忽略或私有)、papers/(向后兼容的论文/PDF 位置)、cards/(来自 reference-reading-summarizer 的稳定来源卡片)、project-use/(来自 reference-project-synthesizer 的项目含义)、summaries/(可选摘要)、notes/(人工笔记)以及 .agent/ 目录(包含 source-index.md、reference-index.md、processing-status.md、reading-status.md、metadata-gaps.md、duplicate-check.md 和 runs/)。

工作流程为:定位项目根目录和 reference/,优先使用 reference/sources/ 加向后兼容的 reference/papers/,若两者都不存在,则递归扫描 reference/ 下支持的来源文件;读取 references/library-policy.md;在需要索引时运行扫描器:python3 <installed-skill-dir>/scripts/scan_reference_library.py --project-root .;检查生成或更新的文件;在已知时为每个来源标记预期角色,可选角色包括 idea-seed、writing-exemplar、method-source、theory-source、benchmark-source、implementation-source、collaborator-feedback、project-spec、baseline、citation-support、closest-work、reviewer-risk;然后路由下一步操作:未读但重要则转 reference-reading-summarizer,已有卡片且需要项目决策则转 reference-project-synthesizer,草稿中引用覆盖缺失则转 citation-coverage-audit,广泛领域搜索则转 literature-review-sprint。

模型路由方面,Tier 0 脚本负责扫描文件/文件夹、哈希、大小、修改时间、缺失卡片和处理状态骨架;Tier 1 廉价 sidecar 负责模糊重复标题、文件名到标题的清理、粗略来源类型和角色标签;Tier 2/3 模型在此不需要,应路由到阅读或项目综合技能。

输出规则 原始扫描轨迹仅在有用时存放在 reference/.agent/runs/ 下;持久索引状态存放在 reference/.agent/ 下;稳定摘要作为来源卡片存放在 reference/cards/ 下;绝不将长段原始来源文本粘贴到记忆或公开文档中;除非用户要求细节,否则只报告计数、主要缺口、重复项和建议的下一步来源。记忆回写方面,当来源被添加、去重或状态变化时,更新 reference/.agent/processing-status.md;项目级记忆回写(主张/证据/风险看板)由 reference-project-synthesizer 在综合后处理,而非本技能。

适用场景 适用于需要维护项目参考资料库、跟踪来源处理状态、生成索引、检测重复、发现元数据缺口的研究工作流。

限制 该技能不负责深入理解来源内容或分析项目含义;原始来源文件可能不适合公开提交;Tier 2/3 模型不在此使用。关于收费、价格、平台等具体信息,资料中暂未提供。