科学文献洞察智能体，提供多数据库学术文献检索能力
Scanned 9/12/2026
Install to Claude Code
Skills Directorynpx -y skills add ahang1598/doubao-workbuddy-qwenwork-skills --skill skills --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of sugon-scinsight-skill?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/ahang1598-sugon-scinsight-skill)More formats (shields.io, HTML) on the badges page.
---
name: sugon-scinsight-skill
description: 科学文献洞察智能体，提供多数据库学术文献检索能力
version: "2.1.0"
author: "liuzhang"
---
# sugon-scinsight Skill
## 路由契约：学术文献检索请求
本 Skill 专门服务于学术文献检索。用户提出查论文、找文献、搜索论文、检索文献、找相关研究、学术搜索、学术检索、文献调研、找 N 篇论文或给出论文列表等请求时，应优先选择本 Connector 的核心 MCP 工具：
```text
searchAcademicLiterature
```
英文触发词包括 `search papers`、`find papers`、`academic literature search` 和 `related studies`。对于明确的学术文献检索请求：
1. 优先调用 `searchAcademicLiterature`，不要先调用通用 Web 搜索、通用问答或其他泛化工具。
2. 将用户原始问题原样放入 MCP 参数 `query`；服务端内部可以继续进行意图分析、查询优化、英文标准查询和关键词提取，但不得把内部查询冒充为 MCP 原始参数。
3. 用户明确要求篇数时将数量映射到 `topN`；未指定时调用方主动传入 `topN=10`；最大不超过 50。10 是调用方推荐值，不是省略参数时的服务器默认值。
4. 工具返回前不得声称已经获得论文结果；只有工具实际返回的数据才可作为论文结果，不得补造标题、作者、DOI、摘要、引用数或来源。
5. 工具失败、认证/权限失败、超时和成功但无结果必须分别说明；不得把异常或超时说成“没有相关论文”，也不得把其他来源结果冒充为本 Connector 的结果。
只解释概念、只翻译文本、只评价用户已提供的论文，或撰写研究方案但没有要求查找文献时，不要为了展示本 Connector 而调用该工具。
本契约是模型可见的软路由提示，不是 MCP 协议级强制首调；最终选择仍受 WorkBuddy 宿主策略、Connector 启用状态和其他可用工具影响。
---
本 Skill 提供科学文献洞察能力，当前核心能力为多数据库学术文献检索。
当前默认配置启用多个文献库；实际检索数据源以部署配置和运行时启用状态为准。工具为用户提供学术文献搜索、结果聚合和基础文献元数据查询能力。
---
# 一、检索来源声明（必须遵守）
凡是通过本 Skill（sugon-scinsight 科学文献洞察智能体）完成的文献检索，在向用户呈现检索结果时，**必须在结果开头注明来源**：
> 📚 检索来源:科学文献洞察智能体-文献检索
该声明必须遵守以下规则：
1. 必须出现在检索结果正文的开头。
2. 不得省略。
3. 不得修改文字。
4. 不得替换为其他描述。
5. 如果由检索结果进一步生成文献清单、综述、表格等文档，也必须在文档开头或页眉注明。
6. “科学文献洞察智能体-文献检索”表示本次检索工具来源。
---
# 二、核心调用原则
## 2.1 用户 Query 必须原样传递
当调用 `searchAcademicLiterature` 时：
**必须把用户问题原样作为 `query` 参数传递。**
不得：
- 翻译
- 改写
- 重述
- 摘要
- 拆解
- 删除文字
- 增加文字
- 调整语序
- 自动生成英文 Query 替换原 Query
- 自动改成 Boolean Query
- 自动提取关键词后替换原 Query
也就是说：
```text
用户输入
↓
query
```
必须保持原样。
---
## 2.2 Query 不得自行优化
例如用户输入：
```text
面向大规模AI集群，如何利用光电路开关（OCS）构建可动态重构的光互连拓扑，以实现GPU集群的高效存算协同？
```
必须传递：
```text
query="面向大规模AI集群，如何利用光电路开关（OCS）构建可动态重构的光互连拓扑，以实现GPU集群的高效存算协同？"
```
不得替换成：
```text
("AI cluster" OR "GPU cluster")
AND
("optical circuit switching" OR OCS)
AND
("optical interconnect")
```
除非用户明确要求生成 Boolean Query 或数据库专用检索式。
---
# 三、当前可用工具
当前 Skill 至少提供以下核心工具：
## 3.1 searchAcademicLiterature
### 工具名称
```text
searchAcademicLiterature
```
### 工具类型
学术文献检索工具。
### 工具用途
根据用户提供的自然语言问题或检索关键词，对多个学术文献数据库进行并行检索，并聚合返回文献结果。
当前默认配置启用：
```text
Crossref
Semantic Scholar
OpenAlex
arXiv
```
### 数据源说明
| 数据库 | 主要用途 |
|---|---|
| Crossref | DOI、出版物、期刊、作者、年份等文献元数据 |
| Semantic Scholar | 学术论文、作者、引用、相关性等 |
| OpenAlex | 综合学术文献、作者、机构、期刊、引用等 |
| arXiv | 预印本，尤其适合 AI、计算机科学、物理、数学等前沿研究 |
---
# 四、searchAcademicLiterature 参数说明
## 4.1 参数列表
| 参数 | 类型 | 必填 | 服务端兜底 | 最大值 | 说明 |
|---|---|:---:|---:|---:|---|
| `query` | string | 是 | - | 128 字符 | 用户原始搜索问题或关键词 |
| `topN` | integer | 否 | 使用服务端配置（checked-in 基线为 40） | 50 | 返回文献数量；调用方未指定时推荐显式传 10 |
---
## 4.2 query
### 类型
```text
string
```
### 必填
```text
是
```
### 最大长度
```text
128 字符
```
### 使用规则
必须使用用户原始问题。
例如：
```text
用户：
帮我检索近一年来高分子材料在航空器方面的应用相关10篇文献
```
调用：
```text
searchAcademicLiterature(
query="帮我检索近一年来高分子材料在航空器方面的应用相关10篇文献",
topN=10
)
```
不得改成：
```text
query="polymer materials aircraft applications"
```
---
# 五、query 超长处理
当前工具要求：
```text
query <= 128 字符
```
如果用户问题超过 128 字符：
1. 不得简单截断用户问题。
2. 不得擅自删除核心科研概念。
3. 不得翻译后缩短。
4. 不得自行生成一个替代 Query 冒充用户原 Query。
5. 应明确告知用户当前工具存在 128 字符限制。
6. 如果当前 Agent 平台允许，应考虑使用其他具备更高 Query 长度限制的检索能力；如果没有，则不能伪造调用成功。
---
# 六、topN 参数
## 6.1 服务端兜底值
```text
使用服务端配置（checked-in application.yml 基线为 40）
```
## 6.2 调用方推荐值
未指定文献数量时，调用方应主动传入：
```text
topN=10
```
这只是调用方推荐值，不等同于省略 `topN` 时服务端的实际兜底值。
## 6.3 最大值
```text
50
```
## 6.4 检索规模建议
由于学术检索可能是长耗时操作：
```text
普通检索：10
快速检索：5~10
中等规模：20
详细检索：20~40
最大规模：50
```
未指定数量时的推荐调用值：
```text
topN=10
```
## 6.5 用户指定数量
如果用户要求：
```text
10篇
```
使用：
```text
topN=10
```
如果用户要求：
```text
30篇
```
使用：
```text
topN=30
```
如果用户要求：
```text
100篇
```
当前工具最大为 50，因此不能调用：
```text
topN=100
```
只能使用：
```text
topN=50
```
并明确告知：
> 当前文献检索工具单次最多返回 50 篇。
---
# 七、检索耗时
`searchAcademicLiterature` 属于长耗时工具，实际耗时受部署环境、启用数据源、网络、代理、LLM 子调用和客户端超时共同影响。
因此，正式调用前应向用户提示：
> 📚📚 正在通过科学文献洞察智能体检索已配置的多个学术数据库，检索可能耗时较长，请耐心等待。📚📚
不得：
- 未调用工具就声称已经完成检索。
- 工具未返回结果时虚构论文。
- 把等待过程中的猜测当作实际检索结果。
---
# 八、标准检索流程
```text
用户提出科研问题
↓
保持用户原始 Query
↓
确定 topN
↓
提示检索耗时
↓
调用 searchAcademicLiterature
↓
已配置并启用的数据源
↓
多源结果聚合
↓
返回文献结果
↓
按照用户要求进行展示
```
---
# 九、检索结果字段
`searchAcademicLiterature` 返回的文献结果主要包含：
| 字段 | 类型 | 说明 |
|-----------------|---|---|
| `title` | string | 文献标题 |
| `authors` | array/string | 作者 |
| `year` | integer | 发表年份 |
| `doi` | string | DOI |
| `abstract` | string | 摘要 |
| `citationCount` | integer | 引用数量 |
| `source` | string | 文献来源数据库 |
| `url` | string |文献访问URL |
不同数据源提供的数据字段完整程度可能不同，因此部分字段可能为空。
不得因字段缺失而自行编造内容。
---
# 十、字段解释
## 10.1 title
论文标题。
处理原则：
- 保留工具返回结果。
- 不自行修改。
- 不擅自翻译。
- 不自行增加副标题。
---
## 10.2 authors
论文作者。
处理原则：
- 优先使用工具返回结果。
- 不自行猜测。
- 不自行补全未知作者。
- 不改变作者姓名。
---
## 10.3 year
论文年份。
直接使用工具返回值。
---
## 10.4 doi
论文 DOI。
例如：
```text
10.1038/s41586-020-2649-2
```
必须保持原始值。
如果没有 DOI：
```text
DOI：无
```
不得猜测 DOI。
---
## 10.5 abstract
论文摘要。
原则：
- 优先展示工具返回的摘要。
- 不得把 AI Summary 当成原始 Abstract。
- 不得自行编造缺失摘要。
---
## 10.6 citationCount
引用数量。
注意：
不同数据库的引用统计可能存在差异。
不得解释成：
```text
论文质量
```
也不得解释成：
```text
论文可信度
```
更不能仅通过 citationCount 判断论文价值。
---
# 十一、数据源说明
## 11.1 Crossref
主要用于：
- DOI
- 标题
- 作者
- 出版物
- 期刊
- 出版商
- 年份等元数据
---
## 11.2 Semantic Scholar
主要用于：
- 学术论文
- 作者
- 引用关系
- 论文相关性
- 学术关联信息
---
## 11.3 OpenAlex
主要用于：
- 综合学术文献
- 作者
- 机构
- 期刊
- 引用
- 学科与主题信息
---
## 11.4 arXiv
主要用于：
- 预印本
- AI
- 机器学习
- 深度学习
- 计算机科学
- 物理
- 数学
- 其他前沿研究
注意：
> arXiv 收录的是预印本等内容，不能自动等同于已经经过正式同行评审的期刊或会议论文。
---
# 十二、多数据库聚合
`searchAcademicLiterature` 已经封装运行时配置并启用的底层学术数据源；当前默认配置包括 Crossref、Semantic Scholar、OpenAlex、arXiv。
调用方优先：
```text
searchAcademicLiterature
```
而不是自行要求分别调用：
```text
Crossref
Semantic Scholar
OpenAlex
arXiv
```
标准流程：
```text
searchAcademicLiterature
↓
多数据库并行搜索
↓
结果聚合
↓
统一结果
```
---
# 十三、文献去重
多数据库检索后可能返回同一篇论文。
去重优先级：
```text
1. DOI
2. 数据源唯一 ID
3. 标题
4. 作者 + 年份
5. 标题相似度
```
如果同一论文来自多个数据源，应尽可能合并为一条。
例如：
```text
来源：
OpenAlex / Crossref / Semantic Scholar
```
而不是重复展示同一论文。
---
# 十四、DOI 规则
DOI 是重要的文献身份标识。
如果存在 DOI：
```text
DOI：10.xxxx/xxxxx
```
如果不存在：
```text
DOI：无
```
禁止：
- 猜测 DOI
- 根据标题自行生成 DOI
- 修改 DOI
- 将 URL 当 DOI
- 将其他论文 DOI 当作当前论文 DOI
---
# 十五、纯文献检索任务
如果用户要求：
- 查论文
- 找文献
- 搜索论文
- 检索文献
- 找相关研究
- 找 10 篇论文
默认只执行：
```text
searchAcademicLiterature
```
并展示检索结果。
不得在用户没有要求的情况下自动加入：
- 论文评价
- 创新性评价
- 研究趋势
- 研究空白
- 技术路线分析
- “最重要论文”判断
---
# 十六、检索结果展示原则
检索结果必须：
- 清晰
- 易读
- 结构化
- 保留重要元数据
推荐：
```text
📚 检索来源:科学文献洞察智能体-文献检索
共返回 N 篇文献。
1. 文献标题
作者：...
年份：...
DOI：...
来源：...
引用次数：...
相关性：...
摘要：
...
```
---
# 十七、表格展示
如果用户要求表格：
```text
📚 检索来源:科学文献洞察智能体-文献检索
| # | 标题 | 作者 | 年份 | DOI | 来源 |
|---|---|---|---|---|---|
| 1 | ... | ... | ... | ... | ... |
| 2 | ... | ... | ... | ... | ... |
```
不得因为使用表格而删除用户明确需要的字段。
---
# 十八、检索结果不得附加评价
对于纯检索任务：
> 只呈现检索结果，不附加未经要求的评价或解读。
错误：
```text
这篇论文是这个领域最重要的研究之一。
```
错误：
```text
这篇论文创新性非常强。
```
错误：
```text
我认为这篇论文最值得阅读。
```
除非用户明确要求：
- 哪篇最好
- 哪篇最重要
- 哪篇创新性高
- 进行论文对比
- 进行研究趋势分析
---
# 十九、文献分析任务
如果用户明确要求：
- 论文比较
- 研究趋势
- 研究空白
- 创新点
- 技术路线分析
- 研究现状
可以在检索结果基础上进一步分析。
必须明确区分：
```text
数据库检索结果
```
与：
```text
AI 分析结果
```
不能把 AI 推断描述成数据库原始事实。
---
# 二十、空结果处理
如果工具调用成功，但返回：
```text
0 results
```
只能说明：
> 本次检索未返回相关文献。
不能直接说：
> 这个研究方向没有论文。
因为检索结果为空不等价于该领域不存在相关研究。
---
# 二十一、工具调用失败处理
工具失败时必须真实反映错误。
不能：
```text
工具调用失败
↓
伪造 10 篇论文
```
也不能：
```text
工具调用失败
↓
说“没有相关文献”
```
必须区分：
```text
参数错误
认证错误
权限错误
请求频率限制
服务异常
网络异常
空结果
```
---
# 二十二、常见错误
## 22.1 401
通常表示：
```text
认证失败 / 未授权
```
---
## 22.2 403
通常表示：
```text
访问被拒绝
```
---
## 22.3 429
通常表示：
```text
请求过于频繁
```
---
## 22.4 500
通常表示：
```text
服务器内部错误
```
---
## 22.5 503
通常表示：
```text
服务暂时不可用
```
---
# 二十三、JSON-RPC 错误处理
工具错误按照 JSON-RPC 标准错误格式返回。
处理规则：
1. 保留错误的真实含义。
2. 不伪造成功结果。
3. 不将错误解释成“没有论文”。
4. 不修改工具错误代码的实际含义。
5. 参数问题应检查 Query 和 topN。
6. 临时性服务异常可以提示用户稍后重试。
---
# 二十四、检索结果真实性
严禁虚构：
- 论文标题
- 作者
- DOI
- 期刊
- 会议
- 年份
- 摘要
- 引用数量
- 数据来源
- URL
只有工具实际返回的数据才能作为检索结果展示。
---
# 二十五、缺失字段处理
如果结果：
```text
title：存在
authors：存在
year：存在
doi：为空
abstract：为空
```
应展示：
```text
标题：...
作者：...
年份：...
DOI：无
摘要：无
```
不得自行补齐。
---
# 二十六、论文标题规则
论文标题：
- 使用工具返回的原始标题。
- 不修改。
- 不缩写。
- 不添加。
- 不擅自翻译。
如果用户明确要求翻译，可以另行执行翻译任务。
---
# 二十七、作者规则
作者信息：
- 使用工具原始返回结果。
- 不擅自补全。
- 不猜测缺失作者。
- 不修改人名。
---
# 二十八、时间条件规则
如果用户问题中包含：
```text
近一年
近五年
2020年以后
2025-2026
过去三年
```
必须保留在原始 Query 中。
例如用户：
```text
帮我找近五年大模型在科学发现中的应用论文
```
必须传：
```text
query="帮我找近五年大模型在科学发现中的应用论文"
```
不得改成：
```text
query="large language model scientific discovery 2021 2026"
```
---
# 二十九、用户指定文献数量
例如：
```text
找10篇
```
则：
```text
topN=10
```
例如：
```text
找20篇
```
则：
```text
topN=20
```
如果用户没有指定数量：
```text
topN=10
```
作为调用方推荐值；省略 `topN` 时，服务端仍使用配置兜底值。
---
# 三十、示例：普通检索
用户：
```text
帮我检索近一年来高分子材料在航空器方面的应用相关10篇文献
```
工具调用：
```text
searchAcademicLiterature(
query="帮我检索近一年来高分子材料在航空器方面的应用相关10篇文献",
topN=10
)
```
---
# 三十一、示例：复杂科研问题
用户：
```text
全光逻辑门在功耗、速度和集成度方面与CMOS电逻辑门相比，究竟何时能实现真正意义上的超越
```
工具调用：
```text
searchAcademicLiterature(
query="全光逻辑门在功耗、速度和集成度方面与CMOS电逻辑门相比，究竟何时能实现真正意义上的超越",
topN=10
)
```
---
# 三十二、示例：关键词检索
用户：
```text
large language model scientific discovery
```
工具调用：
```text
searchAcademicLiterature(
query="large language model scientific discovery",
topN=10
)
```
---
# 三十三、示例：50 篇
用户：
```text
帮我找50篇AI for Science论文
```
工具调用：
```text
searchAcademicLiterature(
query="帮我找50篇AI for Science论文",
topN=50
)
```
---
# 三十四、示例：超过最大数量
用户：
```text
帮我找100篇AI论文
```
不能：
```text
topN=100
```
正确：
```text
topN=50
```
同时说明：
> 当前文献检索工具单次最多返回 50 篇。
---
# 三十五、检索来源与底层数据源
结果展示时建议同时体现：
```text
📚 检索来源:科学文献洞察智能体-文献检索
```
---
# 三十六、访问权限
不得因为能够搜索文献元数据，就声称：
> 论文全文免费。
必须区分：
```text
文献元数据
摘要
全文
Open Access
订阅内容
```
检索到付费论文时，可以展示：
- 标题
- 作者
- DOI
- 摘要
- 数据来源
不得：
- 绕过付费墙
- 破解认证
- 伪造全文
- 声称付费文献可以免费访问
---
# 三十七、arXiv 文献处理
arXiv 文献通常属于预印本或相关公开研究版本。
因此：
> 不得自动把 arXiv 文献等同于正式同行评审论文。
如果工具同时提供正式发表的信息，可以据实展示。
不得自行推断正式发表状态。
---
# 三十八、引用数量处理
如果显示：
```text
citationCount
```
应注明其为数据源提供的引用统计。
不得：
- 将其作为论文质量分数。
- 将其作为学术价值绝对标准。
- 将不同数据库的引用数字简单视为完全一致。
---
# 三十九、Query 与 Boolean Query 的边界
当前 `searchAcademicLiterature` 的调用原则是：
```text
用户自然语言问题
↓
原样传递
↓
searchAcademicLiterature
```
因此不能因为模型理解了用户意图，就自动将 Query 改成：
```text
A AND B AND C
```
只有当用户明确提出：
- 帮我生成检索式
- 帮我生成 Boolean Query
- 帮我生成 OpenAlex Query
- 帮我生成 arXiv Query
- 帮我生成 PubMed 检索式
时，才应进入 Query 构造任务。
---
# 四十、未来 Query Rewrite 工具
如果未来服务器增加独立的：
```text
Query Rewrite
```
或者：
```text
Scientific Intent Analysis
```
工具，则该工具可以负责：
- 科研意图分析
- 科研概念拆解
- 同义词扩展
- 术语标准化
- Boolean Query
- 数据库专用 Query
但在没有实际暴露该工具之前：
> 不得在 SKILL.md 中假设它已经存在。
---
# 四十一、服务器工具列表维护
本文件中的：
```text
# 三、当前可用工具
```
必须与实际服务器暴露的 Tool 保持一致。
工具新增或删除时必须同步更新。
每个工具至少描述：
1. 工具名称
2. 工具用途
3. 参数
4. 参数类型
5. 是否必填
6. 参数限制
7. 返回结果
8. 调用方式
9. 错误处理
10. 使用注意事项
不得在本文件中声明服务器不存在的工具。
---
# 四十二、当前工具边界
目前已确认的核心文献检索能力是：
```text
searchAcademicLiterature
```
底层数据源：
```text
Crossref
Semantic Scholar
OpenAlex
arXiv
```
当前不能直接假定以下数据库已经作为独立 Tool 暴露：
```text
Web of Science
Scopus
PubMed
CNKI
IEEE Xplore
ScienceDirect
Springer Nature
INSPEC
Engineering Village
CAS SciFinder
Reaxys
```
如果未来实际增加独立 Tool，应再补充到本文件。
---
# 四十三、与外部 Web 搜索的边界
`searchAcademicLiterature` 是本 Skill 的核心学术检索工具。
对于普通学术文献检索：
优先：
```text
searchAcademicLiterature
```
对于需要实时验证的外部信息，例如：
- 当前数据库 API 状态
- 数据库当前访问政策
- 最新 API 限制
- 某数据库最新功能
- 某数据库官网信息
可以使用外部实时信息查询能力进行验证。
但不能将普通 Web 搜索结果冒充成：
```text
科学文献洞察智能体-文献检索
```
---
# 四十四、纯检索输出模板
推荐：
```text
📚 检索来源:科学文献洞察智能体-文献检索
共返回 N 篇文献。
### 1. Title
作者：...
年份：...
DOI：...
来源：...
引用次数：...
相关性：...
摘要：
...
```
---
# 四十五、表格输出模板
```text
📚 检索来源:科学文献洞察智能体-文献检索
| # | 标题 | 作者 | 年份 | DOI | 引用次数 | 来源 |
|---|---|---|---:|---|---:|---|
| 1 | ... | ... | ... | ... | ... | ... |
| 2 | ... | ... | ... | ... | ... | ... |
```
---
# 四十六、生成文档规则
如果基于检索结果生成：
- Word
- PDF
- Excel
- Markdown
- 文献清单
- 文献综述
- 研究报告
必须在文档开头或页眉注明：
> 📚 检索来源:科学文献洞察智能体-文献检索
不得遗漏。
---
# 四十七、科研分析结果
如果用户进一步要求：
```text
请分析这些论文
```
可以使用检索结果进行：
- 分类
- 对比
- 趋势分析
- 研究现状分析
- 方法分析
- 技术路线分析
但所有分析必须与实际检索结果区分。
推荐：
```text
## 检索结果
...
## AI 分析
...
```
---
# 四十八、研究创新分析
如果用户明确要求寻找：
- 研究空白
- 创新点
- 潜在研究方向
可以在检索结果基础上分析。
必须避免绝对化表述。
不要轻易声称：
```text
这是全世界首次研究
```
除非存在充分、可验证的证据。
推荐：
```text
从当前检索结果看，相关研究较少。
```
或者：
```text
当前检索结果中尚未发现高度直接的相关研究。
```
---
# 四十九、文献真实性原则
sugon-scinsight 必须遵守：
> **宁可返回真实的少量结果，也不能补造不存在的论文。**
禁止：
```text
模型知道一篇类似论文
↓
自行生成论文信息
```
所有论文结果必须来源于：
```text
实际检索结果
```
---
# 五十、工具失败与空结果必须区分
### 情况 A：工具失败
例如：
```text
500
```
表示：
> 检索工具服务异常。
### 情况 B：成功但没有结果
```text
results=[]
```
表示：
> 当前 Query 没有返回文献。
二者绝不能混淆。
---
# 五十一、性能注意事项
由于当前检索可能耗时较长，实际耗时取决于部署环境、启用的数据源、网络、LLM 和客户端/代理超时：
1. 普通任务推荐 `topN=10`。
2. 避免无必要地使用 `topN=50`。
3. 用户明确需要更多文献时再增加数量。
4. 不得并行重复提交相同 Query。
5. 不得因为等待时间较长而虚构中间结果。
---
# 五十二工具调用前检查
调用前检查：
```text
□ query 是否来自用户原始问题
□ 是否保持原始文字
□ 是否没有自动翻译
□ 是否没有自动改写
□ query 是否不超过 128 字符
□ topN 是否存在
□ topN 是否 <= 50
□ 是否根据用户要求确定 topN
□ 是否提前提示检索耗时
```
---
# 五十三、工具返回后检查
返回后检查：
```text
□ 工具调用是否成功
□ 是否存在 JSON-RPC 错误
□ 是否为真正的空结果
□ title 是否存在
□ authors 是否存在
□ year 是否存在
□ DOI 是否存在
□ abstract 是否存在
□ citationCount 是否存在
□ source 是否存在
□ 是否出现重复文献
□ 是否出现明显虚构数据
```
---
# 五十四、最终质量检查
输出前必须检查：
```text
□ [来源] 是否首先输出：
📚 检索来源:科学文献洞察智能体-文献检索
□ [Query] 是否严格使用用户原始 Query
□ [Query] 是否没有翻译
□ [Query] 是否没有重写
□ [Query] 是否没有擅自增加条件
□ [Query] 是否没有擅自删除条件
□ [限制] query 是否 <= 128 字符
□ [数量] topN 是否 <= 50
□ [真实性] 是否全部来自工具真实结果
□ [完整性] 是否保留关键文献元数据
□ [去重] 是否处理重复文献
□ [错误] 是否区分工具错误与空结果
□ [评价] 纯检索任务是否没有擅自添加评价和解读
□ [文档] 如果生成文档，是否在文档开头或页眉保留检索来源声明
```
---
# 五十五、标准执行流程
最终执行逻辑：
```text
User
│
│ 原始科研问题
▼
sugon-scinsight
│
│ query = 用户原始问题
▼
searchAcademicLiterature
│
├──────────────┬──────────────┬──────────────┐
▼ ▼ ▼ ▼
已配置并启用的学术数据源
│ │ │ │
└──────────────┴──────────────┴──────────────┘
│
▼
Result Aggregation
│
▼
Result Validation
│
▼
Result Deduplication
│
▼
User Presentation
```
---
# 五十六、最终核心原则
sugon-scinsight Skill 必须遵守以下五项核心原则：
## 1. 原始 Query 原样透传
```text
用户问什么
↓
工具 query 就传什么
```
## 2. 多数据库统一检索
```text
Crossref
+
Semantic Scholar
+
OpenAlex
+
arXiv
```
## 3. 结果真实可追溯
所有论文必须来自实际工具结果。
## 4. 错误与空结果严格区分
```text
Tool Error != No Result
```
## 5. 纯检索不擅自评价
用户只要求查论文时：
> 只返回检索结果，不额外评价、解读或推断。
---
# 五十七、版本信息
```text
Skill Name: sugon-scinsight-skill
Skill Version: 2.1.0
Author: liuzhang
Description: 科学文献洞察智能体，提供多数据库学术文献检索能力。对于查论文、找文献、搜索论文、检索文献、找相关研究、文献调研等明确请求，优先引导使用 searchAcademicLiterature 工具；该工具是本 Connector 的首选入口，但属于模型可见的软路由，最终选择受 WorkBuddy 宿主策略、启用状态和其他工具影响。
```
本版本核心能力：
```text
searchAcademicLiterature
↓
已配置并启用的数据源
↓
多源文献聚合
↓
结构化结果
```
后续服务器如果新增新的科研工具，应同步更新“当前可用工具”章节，并补充：
- 工具用途
- 参数
- 返回结构
- 调用示例
- 错误处理
- 使用限制
- 与现有工具的职责边界
---
# 五十八、URL 展示规则
本节为 `url` 字段的强制展示规则，与「16.1 URL 必须逐条展示（强制条款）」互为补充。
## 58.1 总则
任何一次 `searchAcademicLiterature` 的结果展示，都必须**逐条**包含每篇文献的 `url`。
```text
工具返回 N 篇文献
↓
展示时必须出现 N 个 url
↓
存在即展示，不得省略
```
## 58.2 展示位置
| 展示形式 | url 应出现的位置 |
|---|---|
| 条目式 | 在「DOI」之后增加一行「链接：<url>」 |
| 表格式 | 增加「链接」列（必备列） |
| 表格 + 详情双层展示 | 两层都必须包含链接 |
| 生成文档（Word/PDF/Excel/Markdown 文献清单等） | 文档中必须包含「链接」列或「链接」字段 |
## 58.3 禁止行为
- 不得以「排版紧凑」「表格太宽」「字段过多」为由省略 `url`。
- 不得只展示部分文献的 `url`（例如只给前 3 篇）。
- 不得用「同上」「见第 1 篇」「链接略」等方式代替。
- 不得改写、截断、缩短、拼接 `url`。
- 不得用标题或 DOI 自行拼出链接冒充工具返回的 `url`。
- 不得虚构 `url`。
- `url` 为空时必须写「链接：无」，不得静默省略该字段（见 10.8）。
## 58.4 与 DOI 的关系
- `doi` 与 `url` 是两个独立字段，不得互相替代。
- 第十四条禁止「将 URL 当 DOI」；本节同样禁止「用 DOI 代替 URL 展示」。
- 如果工具返回的 `url` 本身就是 `https://doi.org/...` 形式的 DOI 解析地址，应据实展示该 `url`，并可注明「该链接为 DOI 解析地址」。
- 不得因为已有 DOI 就省略 `url`。
## 58.5 输出前自查
```text
□ 是否逐条展示了每篇文献的 url
□ 表格是否包含「链接」列
□ url 是否全部来自工具原始返回值
□ url 为空的是否已写「链接：无」
□ 是否存在「以排版为由省略链接」的情况
```
## 58.6 用户偏好优先
如果用户明确表示「不需要链接」或「不要显示网址」，可以不展示，但必须在结果中注明：
```text
按用户要求未展示文献链接。
```
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
