# RAG Assistant

> 本地知识库助手：当用户询问已索引文档的内容、对比多份资料、或要求基于私有文档回答问题时使用。

- Skill: `merkyorlynn/rag-assistant` (Agent Skill)
- Install (CLI): `npx skillmds@latest add merkyorlynn/rag-assistant`
- Raw SKILL.md: https://api.skillmd.com/api/skills/merkyorlynn/rag-assistant/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: merkyorlynn (https://skillmd.com/u/merkyorlynn)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/merkyorlynn/rag-assistant

---


# RAG Assistant 知识库助手

当用户问题可能涉及已加入知识库的文档时，按以下流程执行：

## 检索流程

1. **理解问题**：提取核心实体和查询意图
2. **调用 knowledge_query**：传入精简后的查询词，top_k 取 5-7
3. **评估相关性**：若返回片段与用户问题无关，说明知识库未覆盖，改用 web_search
4. **组织答案**：
   - 每个事实必须标注来源文件（如 `📄 来源: xxx.pdf`）
   - 区分「知识库内容」和「通用知识」
   - 若多份文档观点冲突，需指出并总结

## 适用场景
- "我之前上传的那份报告里怎么说？"
- "对比文档 A 和文档 B 的结论"
- "根据我的资料，总结一下 XX 的趋势"

## 不适用场景
- 通用知识查询（直接用 web_search）
- 未索引文档的内容（提示用户先使用 knowledge_index）