Smart Search — Yuque Personal Knowledge Base Search & Q&A

When to Use

• User asks a question that might be answered by their personal Yuque docs
• User wants to find specific information in their own knowledge base
• User says "搜一下我的文档", "search my Yuque", "我的知识库里有没有..."

Required MCP Tools

yuque-mcp

• yuque_search

  — Search documents by keyword

• yuque_get_doc

  — Read full document content by slug/id

Workflow

Step 1: Extract Search Keywords

• "我的部署流程文档在哪？" → keywords:

  部署流程

• "How do I handle error logging?" → keywords:

  错误日志

  or

  日志处理

• "我之前写的技术评审笔记" → keywords:

  技术评审

Step 2: Search Documents

yuque_search

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

1. Try alternative keywords (synonyms, broader terms)
2. Try splitting compound terms (e.g., "部署流程" → "部署" or "流程")
3. If still no results, tell the user honestly: "在你的语雀知识库中未找到相关文档，建议尝试其他关键词或确认文档是否存在。"

Step 3: Filter and Rank Results

• Title relevance to the query
• Document update time (prefer recent)
• Repository context (focus on user's personal repos)

Step 4: Read Document Content

Tool: yuque_get_doc
Parameters:
  repo_id: "<namespace>"    # e.g., "username/my-notes" (from search result's book.namespace)
  doc_id: "<slug>"          # e.g., "api" (from search result's target.slug)

• target.slug

  → use as

  doc_id

• target.book.namespace

  → use as

  repo_id

• target.title

  → document title

• target.updated_at

  → last update time

Step 5: Synthesize and Respond

## 回答

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

## 关键要点

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

## 参考文档

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

Guidelines

• Always answer in the same language the user used (Chinese or English)
• Quote specific content from documents when relevant — use

  >

  blockquotes
• If documents contain conflicting information, note the discrepancy and mention which doc is more recent
• If the answer is only partially found, say what you found and what's missing
• Never fabricate information not present in the documents
• Include document links so the user can read the full source
• This skill searches the user's personal knowledge bases — for team knowledge bases, use the

  smart-search

  skill in the

  yuque-group

  plugin

Error Handling

yuque_search

yuque_get_doc

yuque_get_doc