步骤 2：搜索文档

使用提取的关键词调用 yuque_search：

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

如果搜索未返回结果：

1. 尝试替代关键词（同义词、更宽泛的术语）
2. 尝试拆分复合词（例如，“部署流程” → “部署” 或 “流程”）
3. 如果仍然没有结果，如实告知用户：“在你的语雀知识库中未找到相关文档，建议尝试其他关键词或确认文档是否存在。”

步骤 3：筛选和排序结果

从搜索结果中，根据以下标准选择最相关的 3-5 个文档：

• 标题与查询的相关性
• 文档更新时间（优先选择最近的）
• 知识库上下文（专注于用户的个人知识库）

步骤 4：读取文档内容

对于每个选定的文档，获取完整内容：

Tool: yuque_get_doc
Parameters:
  repo_id: "<namespace>"    # 例如："username/my-notes"（来自搜索结果中的 book.namespace）
  doc_id: "<slug>"          # 例如："api"（来自搜索结果中的 target.slug）

注意：搜索结果包含嵌套数据。提取以下关键字段：

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

最多读取 3 个文档。如果第一个文档已完全回答了问题，可以跳过其余部分。

步骤 5：综合与回复

按以下格式撰写答案：

## 回答

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

## 关键要点

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

## 参考文档

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

指导原则

• 始终使用用户使用的语言（中文或英文）进行回答
• 相关时引用文档中的具体内容 — 使用 > 引用块
• 如果文档包含冲突信息，请注明差异并提及哪个文档更新
• 如果答案仅部分找到，说明已找到的内容和缺失的内容
• 切勿编造文档中不存在的信息
• 包含文档链接，以便用户阅读完整来源
• 此技能搜索用户的个人知识库 — 对于团队知识库，请使用 yuque-group 插件中的 smart-search 技能

错误处理

每周安装数

156

代码仓库

yuque/yuque-plugin

GitHub Stars

62

首次出现

Feb 28, 2026

安全审计

Gen Agent Trust HubPassSocketPassSnykWarn

安装于

codex156

claude-code145

kimi-cli50

gemini-cli50

amp50

cline50