zcbot/skills/documents/SKILL.md

name	description
documents	检索内部 7 个材料学科知识库中的论文、书籍及其他学术文档。适合材料领域主题检索、全文语义检索、性能或工艺数据查找；可与 research(paper_server)并用并按 DOI 或题名去重。

Documents

documents 是内部材料知识库的客户端 skill。知识库覆盖胶凝、陶瓷、玻璃、晶体、复合、耐火和检验检测，提供跨语言语义检索、Markdown 正文片段和原件下载。

选择与协作

• 材料领域主题、性能数据或全文语义检索：优先使用 documents。
• 跨学科发现、精确 DOI 或题录检索：优先使用 research。
• 系统调研、综述或重要引用：可同时查询两者；按 DOI 去重，无 DOI 时按规范化题名、作者和年份去重。
• 用户已提供文件或个人知识库路径：直接读取该来源。

论文、书籍和书籍章节都可作为候选，来源类型本身不决定使用哪个 skill；以相关性、元数据完整度和可核验正文为准。

工具

本 skill 使用宿主工具，API Key 不进入 sandbox：

• document_list_kb()：列出当前有效知识库。用户未指定材料方向且需要缩窄库范围时调用。
• document_search(queries, kb_names=None, classification_ids=None, max_documents=6, content_chars_per_doc=1200)：批量搜索，返回文件元数据与截断的 md_content。中文和英文均可，专业术语可同时准备中英文表达。
• document_download(items)：把选定原件下载到当前任务的 documents/ 目录。items 使用搜索结果中的 file_name 和 kb_name。

工具会自动限制批量大小、去重并控制返回体积。需要更多正文时，对少量高相关候选增加 content_chars_per_doc，或下载原件后读取。

工作流

1. 根据用户问题形成少量有区分度的查询；需要分类时先列知识库。
2. 搜索并依据题名、文件名、正文片段和库来源筛选候选。
3. 相关性判断可使用片段；论点、数据、公式、表格、章节或页码核验应读取足够正文或原件。
4. 与 research 并查时合并去重，优先保留正文更完整、元数据更可靠的记录。
5. 输出时区分“仅题录”“片段已核对”“全文已核对”，并标注可追溯的文件名、DOI 或其他真实标识。

失败与真实性

• 工具不可用或认证失败时，说明 document_search 当前不可用，并改用 research 或用户提供的文件。
• 未命中时可调整术语、语言或库范围；没有新增检索思路时如实说明覆盖不足。
• 只使用工具返回的 file_name、kb_name 和来源信息，不推测缺失的作者、DOI、ISBN、页码或正文内容。