group-search

用途

group-search 是一个团队语雀知识库搜索与问答技能，用于在群组（团队）语雀知识库中检索文档并生成汇总回答。当你提出的问题可能由团队语雀文档解答，或需要查找群组知识库中的特定信息时，可以使用该技能。触发场景包括用户说“搜一下团队文档”“search group Yuque”“团队知识库里有没有……”等。

该技能仅搜索群组知识库，会过滤掉个人文档；如需搜索个人文档，应改用 personal-search。

主要能力

用自然语言检索群组语雀知识库
读取相关文档全文
综合出带有引用来源的清晰回答，包含回答、关键要点和参考文档
支持中英文回答（与用户所用语言一致）
当文档存在冲突信息时指出差异并说明哪个文档更新

依赖的 MCP 工具

以下工具均来自 yuque-mcp 服务器：

yuque_list_repos — 列出群组知识库以确定检索范围
yuque_search — 按关键词搜索文档
yuque_get_doc — 按 slug/id 读取文档全文

使用方式（工作流程）

第一步：确定团队范围

先获取群组知识库列表以了解检索范围：

Tool: yuque_list_repos
Parameters:
  login: "<group_login>"
  type: "group"

若用户未指定 group login，需询问：“请告诉我团队的语雀团队标识（group login），我来搜索团队知识库。”

第二步：提取搜索关键词

从用户自然语言问题中提取 1-3 个简洁的中文关键词。语雀搜索更适合简短、具体的词。示例：

“团队的部署流程是什么？” → 关键词：部署流程
“我们的 API 规范文档” → 关键词：API 规范
“上次技术评审的结论” → 关键词：技术评审

第三步：搜索文档

Tool: yuque_search
Parameters:
  query: "<keywords>"
  type: "doc"

若搜索无结果：

尝试替代关键词（同义词、更宽泛的词）
尝试拆分复合词（如“部署流程” → “部署”或“流程”）
若仍无结果，如实告知：“在团队语雀知识库中未找到相关文档，建议尝试其他关键词或确认文档是否存在。”

第四步：筛选与排序结果

从搜索结果中选出最相关的 3-5 篇文档，依据：

标题与查询的相关性
文档更新时间（优先较新的）
知识库上下文（优先第一步中识别出的群组知识库结果）

过滤掉不属于团队知识库的结果。

第五步：读取文档内容

对每篇选定文档获取全文：

Tool: yuque_get_doc
Parameters:
  repo_id: "<namespace>"    # 例如 "my-team/tech-docs"（来自搜索结果的 book.namespace）
  doc_id: "<slug>"          # 例如 "api-spec"（来自搜索结果的 target.slug）

搜索结果包含嵌套数据，需提取以下关键字段：

target.slug → 用作 doc_id
target.book.namespace → 用作 repo_id
target.title → 文档标题
target.updated_at → 最后更新时间

最多读取 3 篇文档。若第一篇文档已完整回答该问题，可跳过其余文档。

第六步：综合并回答

按以下格式组织回答：

## 回答

[直接回答用户的问题，2-4 句话，简洁明了]

## 关键要点

- **要点 1**：[从文档中提取的关键信息]
- **要点 2**：[从文档中提取的关键信息]
- **要点 3**：[从文档中提取的关键信息]

## 参考文档

1. [文档标题](文档链接) — 来自「知识库名称」，更新于 YYYY-MM-DD
2. [文档标题](文档链接) — 来自「知识库名称」，更新于 YYYY-MM-DD

准则

始终使用用户所用的语言回答（中文或英文）
相关时引用文档中的具体内容，使用 > 引用块
若文档包含冲突信息，指出差异并说明哪个文档更新
若答案只找到部分，说明找到的内容与缺失的内容
绝不编造文档中不存在的信息
附上文档链接，方便用户阅读完整来源
仅返回群组知识库结果，过滤掉个人文档

错误处理

情况	处理方式
yuque_list_repos 失败	检查 group login 是否正确、群组 Token 是否已配置
yuque_search 返回空	尝试替代关键词，然后告知用户
yuque_get_doc 失败（404）	跳过该文档，提示其可能已被删除
yuque_get_doc 失败（403）	告知用户可能缺少权限，检查群组 Token 范围
API 超时	重试一次，然后告知用户连接问题
结果过多	聚焦相关性最高的前 3 篇，说明还有更多结果
用户想搜索个人文档	建议改用 personal-search 技能
团队 Token 未配置	告知用户群组搜索需要团队级 Token

适用场景

查找可能由团队语雀文档解答的问题
在群组知识库中查找特定信息，如部署流程、API 规范、技术评审结论等

限制

仅搜索群组知识库，无法搜索个人文档（个人文档需使用 personal-search）
需要提供 group login 并配置团队级 Token
单次最多读取 3 篇文档，结果过多时聚焦前 3 篇
资料未提供价格、平台支持范围、安装命令等更多信息