关于 ccf-literature-searcher
ccf-literature-searcher 是面向研究人员的文献检索技能,可用于构思研究、撰写论文或规划实验。它核验来源、归类最相关工作,并区分有证据支持的发现与推断。
主要功能
- 01检索并核验研究论文
- 02归类相关及最接近工作
- 03发现基准与数据集
- 04识别有依据的研究空白
- 05整理候选引用
适用场景
- 01为创新性和研究定位提供依据
- 02构建相关工作章节
- 03为实验计划寻找基准
- 04核查候选构想的既有研究
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mikubaka88/ ccfa-skills --skill ccf-literature-searcher安装后在 Claude Code 中输入/ccf-literature-searcher确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/report-template.mdsearch-and-scoring.md详细介绍
CCF 文献检索器
家族文件约定
处理文件前,复用规范路径,并使用一个任务/产物工作目录;默认路径为项目根目录下的 ccfa-workfiles/<purpose>/<artifact-id>/。在原位置更新,保留输入文件,并使用 UTF-8,同时检查中文文本。命名、归属和任务创建文件的清理请遵循 artifact-contracts.md;交接时沿用这些路径。
协作约定
执行专业任务前,先阅读并应用 ccf-humanization,再阅读并应用 ccf-common。每次交接时,复用其中适用的现行规则,或刷新缺失/变更的规则。即使没有文案,也必须完成这两项预检。仅在相关时启用详细编辑、实验和维护模式。
将必要的专业贡献整合到单一负责人之下;复用有效的前置成果,并核验受影响的结果。遵循协作路由,避免重复报告。
调用控制
CCFA 交接模式:PARTIAL(推荐)。 遵循 metadata.ccf_skill_controls.handoff_question_mode 和 ../ccf-common/references/handoff-modes.md。使用 ../ccf-common/references/routing.md,将文献检索与创意优化、论文撰写、实验设计、论文评审和 rebuttal 分开。
在决定采用探索、快速还是标准模式前,先加载 ../ccf-common/references/task-modes.md。对于早期方向摸索、“看看还有没有机会”、“这个方向是不是被做完了”,或旨在为创意优化提供依据、而非给出最终新颖性结论的文献检索,使用探索模式。对于范围较窄的相关工作检索,或少量候选引文,使用快速模式。对于 Related Work、Introduction、成熟创意的新颖性依据、基准发现、实验设计或大量多项交付工作,使用标准模式。即使后续有写作者使用,小规模引文查询仍采用快速模式。
如果用户要求定期监测、最新论文追踪、竞品追踪、“最近有没有类似创意”、扫描 arXiv/OpenReview 动态,或跟踪实验室/项目,请按照共享交接模式转交给 ccf-literature-monitor。本技能用于深度检索、最相近工作的聚类、相关工作结构梳理、基准/数据集发现和候选引文。
将用户创意、草稿文本、未发表结果和私人手稿视为私有材料。浏览前加载 ../ccf-common/references/privacy-and-evidence.md。使用公开关键词、公开标题、会议名称、方法名称、公开摘要或经用户批准的查询文本进行检索。除非用户明确授权,不要将私人草稿中的句子粘贴到搜索查询中。
来源质量排除规则:不得搜索、引用、推荐或收录政策排除的会议、期刊、URL 或 PDF。共享政策将 MDPI 来源列入排除范围;仅在内部筛选记录或检索备注文件中记录排除情况。
核心规则
基于高质量且可核查的来源来支撑新颖性和定位。优先选择有影响力的会议、优秀期刊、官方论文集页面、档案库和公开论文页面。不得捏造论文、引文、会议、链接、录用状态、基准状态或数值结果。区分检索到的证据与推断。评估实际重合情况:相关工作可能揭示尚待解决的问题,也可能表明候选创意的核心主张已被涵盖。在有依据时提出有意义的差异化方向;不要强行挽救,也不要放弃用户的整体目标。遵循用户要求的输出形式:短列表、相关工作聚类、机会图谱、BibTeX 候选条目、基准表、检索文件夹或交接摘要。
强制搜索清单
在标准模式下,完成此清单后再输出最终内容。在快速模式下,执行相关子集并返回简洁的清单状态。
- 将用户的主题转换为安全的公开搜索查询。
- 对搜索域、候选项和最终输出应用通用的来源质量排除规则。
- 优先选择主要或高可信度的来源:官方会议论文集、适用时的 arXiv/OpenReview、ACL Anthology、CVF、PMLR、ACM、IEEE、USENIX、DBLP、Semantic Scholar、OpenAlex、Crossref,以及会议或项目页面。
- 按标题对候选论文去重,并链接到稳定 URL。
- 每篇纳入的论文均标注会议/年份/来源状态、论文类型和相关性说明。
- 仅在用户要求或进行大规模筛选时确有帮助的情况下,才对论文质量的见解、完整性和实验数值证据进行评分;评分范围不得超出已查阅文本所支持的程度。纯基准测试论文跳过数值结果评分,改为附上基准测试质量说明。
- 论文类型必须属于
纯基准测试、纯方法、方法 + 基准测试、综述、系统/工具、理论/证明或其他。 - 关于论文的每项主张都必须能追溯到所链接的来源,或明确标注为推断。
- 对于创意阶段的搜索,报告每个最接近工作类别已涵盖的内容,以及有证据支持的未解问题。只有在能够说明有意义的区别时才提出差异化方案;否则,应说明在已查阅的证据中未发现有价值的区别。将此发现反馈给创意提出者,不得编造补救模块,也不得放弃用户的更广泛目标。
- 仅当用户要求可复用的输出,或授权工作需要时,才编写文献搜索文件夹。范围有限的辅助查询可以在上下文中返回已核实的证据,无须另行编写报告。
- 当搜索结果用于创意优化时,创意依据资料包应区分来源支持的观察与推断出的缺口,并包含机制原语、协议锚点、跨来源冲突/开放缺口关系及置信度。
- 按照 CCFA 交接模式,可选择将工作交接给
ccf-literature-monitor、ccf-paper-writer、ccf-idea-optimizer、ccf-idea-reviewer、ccf-experiment-designer或ccf-paper-reviewer。
工作流
-
确定搜索目的:相关工作、引言支持、新颖性检查、方向探索、创意优化、创意评审、实验设计、基准/数据集发现,或评审风险诊断。
-
根据用户主题创建公开查询。如果主题过于私密或信息不足,只询问非敏感关键词,或推断较宽泛的关键词并降低置信度。
-
加载
references/search-and-scoring.md。将以下搜索范围作为起始预算,而非配额。覆盖所需的主题簇、最接近的竞争工作和证据需求后,如果继续检索不会增加实质信息,就停止;如果仍存在具体空缺,则扩大搜索范围。默认搜索广度:- 探索性:筛选 10-20 篇候选论文,最终纳入 5-10 篇论文或主题簇,另加机会缺口。
- 快速:筛选 6-10 篇候选论文,最终纳入 3-6 篇论文。
- 标准:筛选 15-30 篇候选论文,最终纳入 8-15 篇论文,除非用户要求其他数量。
这些是独立搜索的规划范围,并非配额。辅助查询只检索解决指定问题所需的来源,并将结果交回发起查询的负责人。遵循用户指定的广度;不要重复已验证的搜索,也不要仅为达到默认数量而收集额外论文。
-
先搜索发现索引,再尽可能通过稳定的论文页面或官方会议录验证候选结果。仅使用广泛的网络搜索来查找一手来源链接;最终结论不要依赖搜索摘要。
-
根据影响力和相关性筛选。优先考虑 CCF-A/B 类会议、领域顶级会议、优质期刊、广泛使用的基准,或可信团队近期发布且信号较强的预印本。排除低质量、掠夺性、无法访问或受政策限制的来源。对于探索性搜索,如果“相近但不匹配”的主题簇或负面信号主题簇揭示了开放缺口、失败的假设、过时的基准、缺失的用户群体或被忽视的系统约束,则纳入其中一两个。
-
根据需要对论文进行分类筛选。仅在用户要求或与决策相关时对已检查的论文评分,使用以下维度:
insight:核心思想的清晰度和非显而易见程度。completeness:方法/评估/证明/数据集/可复现性方面的覆盖情况。experimental numeric evidence:所报告数值证据的力度和相关性;纯基准论文标记为N/A benchmark。
-
仅在需要可复用成果,或授权工作流中需要写入文件时才写入文件。遵守不新建文件的限制。更新时复用现有的规范搜索文件夹;否则使用
references/report-template.md,默认文件夹名称为:
ccfa-workfiles/literature/<topic-slug>/
papers.md
papers.csv # only when structured reuse/export is needed
search-notes.md # only when queries/coverage must persist separately
idea-grounding.md # include when the search feeds idea optimization
复用现有的按日期或自定义命名的搜索文件夹,而不要重命名。将当前搜索日期和来源版本记录在报告中;普通更新时不要新建文件夹。根据同一组已筛选来源生成所需的 Markdown/CSV 视图,而不要分别编写重复副本。跳过空白或未要求的评分列,以及通用状态章节。
- 如果搜索结果将提供给其他模块,则提供简洁的交接信息,列出规范来源路径和仅与决策相关的证据:
- 写作:最接近的工作分组、新颖性缺口、引用注意事项。
- 创意优化:精简的创意依据资料包,包含证据卡片、机制原语、协议锚点、缺口/冲突关系、过时/拥挤的方向、时机恰当的转向方向,以及最低可行研究问题。交接内容不要包含完整摘要和通用背景。
- 创意评审:新颖性置信度和可能的先前技术风险。
- 文献监控:监控查询、跟踪的竞争工作和反复出现的重叠信号。
- 实验设计:数据集、基线、指标、基准协议。
- 论文评审:缺失的相关工作和基线风险。
自适应输出规范
先返回用户请求的成果。如果用户要求论文列表,直接输出列表或表格。如果用户要求相关工作材料,则输出主题分组和定位说明。如果用户要求文件夹,则创建文件夹并概述其内容。对于标准搜索或快速搜索报告,请使用以下默认格式。
标准搜索的返回格式:
Search purpose:
Queries used:
Source policy:
Folder written:
Top paper table:
Closest-work clusters:
Opportunity map:
Quality-score rationale:
Benchmark/dataset candidates:
Novelty and positioning risks:
Recommended next module:
Checklist status:
快速搜索的返回格式:
Quick search scope:
Top candidates:
High-risk missing literature:
Opportunity hint:
Folder written:
Compact checklist status:
参考文件
仅加载所需内容:
references/search-and-scoring.md:用于了解来源政策、来源质量排除标准、来源分级、论文类型分类和评分基准。references/report-template.md:用于编写文献搜索文件夹中的文件。
检索执行
在支持的情况下,对相互独立且公开安全的查询主题进行批量检索,然后依据 DOI/arXiv 标识符和标准化标题去重,再深入阅读。应在论文正文或主要来源页面中核实重要主张,不要仅依赖摘要片段。记录已检查的章节以及出版/版本状态。不要给未读过的方法评分,也不要将无法访问的结果视为不存在。来源不可用会限制相应主张;请继续依据可用的主要证据开展检索,并报告相关的覆盖缺口。