sugon-scinsight-skill

---
name:  sugon-scinsight-skill
description: 科学文献洞察智能体，提供多数据库学术文献检索能力
version: "2.2.2"
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 提供科学文献洞察能力，当前核心能力为多数据库学术文献检索。

## 认证说明

本 Connector 使用 WorkBuddy 标准 OAuth 2.1 + PKCE 流程，认证授权由外部 OAuth 服务器完成：

- 首次使用时，WorkBuddy 自动发现 OAuth 服务并打开浏览器授权页面。
- access token 到期后，WorkBuddy 使用 refresh token 自动续期。
- Token 无效、已撤销或授权过期时，需要在 Connector 管理页重新连接。
- 本 Connector 不要求用户手工填写 Token，也不会在 Skill 中收集账号、密码或 OAuth 凭证。

当前默认配置启用多个文献库；实际检索数据源以部署配置和运行时启用状态为准。工具为用户提供学术文献搜索、结果聚合和基础文献元数据查询能力。

---

# 一、检索来源声明（必须遵守）

凡是通过本 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.2.2
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
按用户要求未展示文献链接。
```