前言¶

个人资料往往散落在 PDF、Markdown、Word 里，检索靠文件名和全文搜索，很难在对话里直接「按内容回答」或「按笔记写报告」。通用大模型没有你的私有文档上下文，把整库贴进提示词也不现实。

下面介绍 SkillHub 社区技能「本地知识库智能问答」（坐标 @user_4c392ef3/knowledge-qa）。它在 Agent 侧封装知识库相关意图：基于已入库文档问答、生成报告与思维导图、上传与索引文件、管理分区与向量库。触发方式以自然语言为主，适合在 Cursor 等支持 Skills 的客户端里长期挂着使用。

这是什么¶

一句话定位：面向个人知识库文档（PDF / Markdown / Word）的智能问答与内容产出 Skill，并覆盖上传、索引、分区与向量库相关操作。

维护与来源：社区发布（community），发布者 user_4c392ef3，当前版本 1.0.0，分类为 knowledge-management。SkillHub 页面与 API 入口见文末链接。

解决的问题：把「查知识库、写报告、做导图、建库索引」等需求收敛到同一套 Skill 触发规则里，由 Agent 在识别意图后按 SKILL.md 流程执行，而不是每次手写检索脚本或重复说明文档位置。

核心功能¶

以下能力均来自官方简介，未在页面单独展开实现细节的部分不臆测：

1. 基于知识库问答：用户表达「基于知识库」「查一下知识库」「根据文档」「从我的资料」「结合我的笔记」等时触发，在已索引内容上做问答。
2. 报告与思维导图：支持「帮我写报告」「整理成报告」「生成思维导图」「做个导图」等意图，在文档上下文上生成结构化输出。
3. 入库与向量索引：支持「上传知识库」「有新文件」「索引文档」「建向量库」等，将文件纳入向量库流程。
4. 分区与库管理：支持「基于某个分区」「有哪些分区」「分区列表」「创建知识库」「初始化知识库」「知识库列表」等表述；简介中还提到「基于mysql查询」作为触发词之一，具体查询方式以 Skill 内说明为准。
5. 依赖标注：SkillHub 标签为 requires_api_key=true，使用前需按 Skill 要求配置 API Key（页面未列出具体环境变量名时，以安装后的 SKILL.md 为准）。

安装与启用¶

官方推荐两种方式：用 SkillHub CLI 安装到当前 Agent 的 skills 目录，或把安装提示交给 AI 按 SkillHub 安装文档执行。

1. 安装 SkillHub CLI（若尚未安装）¶

先检查是否已有 CLI：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2. 安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认装到 ./skills/ 可能不会被加载。

skillhub install @user_4c392ef3/knowledge-qa --dir <你的 skills 目录>

常见客户端路径（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

示例（Cursor）：

skillhub install @user_4c392ef3/knowledge-qa --dir ~/.cursor/skills/

3. 交给 AI 安装¶

SkillHub 技能页提供的提示等价于：请根据 SkillHub 安装与优先源配置，安装 @user_4c392ef3/knowledge-qa。

经过上面的步骤，重启或刷新 Agent 后，在对话中使用下文触发词即可唤起该 Skill。

典型用法¶

官方未给出固定 CLI 子命令示例，典型用法是自然语言触发。下列表述与 SkillHub 简介中的触发词一致，可直接在已启用 Skill 的对话里使用：

先做文档入库或索引（若库尚未建立），再在同一客户端里用问答或报告类触发词；具体步骤顺序以安装后目录中的 SKILL.md 为准。

适用场景与注意¶

适合谁

• 本地或团队内积累了大量 PDF / Markdown / Word，希望在 Agent 里用口语完成检索、总结、报告与导图。
• 需要按「分区」组织资料，并偶尔做向量库构建与列表查询的用户。

限制与注意

1. API Key：标签 requires_api_key=true，未配置时相关能力可能不可用；配置项以 Skill 包内文档为准，此处不编造变量名。
2. 安装路径：务必 skillhub install ... --dir 指向正确目录，避免装到默认 ./skills/ 导致 Agent 不加载。
3. 社区来源：版本 1.0.0、来源 community，升级与变更以 SkillHub 页面为准；页面统计（截至资料抓取）为评分 100000、下载 1776、安装 18，仅供选型参考。
4. 能力边界：简介覆盖问答、报告、导图、上传与分区管理；未在官方页面声明的集成或数据库细节不要假设已支持，以 SKILL.md 为最终说明。

结尾¶

「本地知识库智能问答」把个人文档场景下的问答、报告、思维导图和向量库运维意图收拢到一套 Skill 里，通过明确的触发词在 Agent 中启用。若你正在 SkillHub 上选型知识管理类能力，可先按上文安装到 Cursor 等环境的 skills 目录，再对照 SKILL.md 完成 API Key 与索引流程。

官方地址

• SkillHub 技能页：https://www.skillhub.cn/skills/user_4c392ef3/knowledge-qa
• API / 资源入口：https://api.skillhub.cn/user_4c392ef3/knowledge-qa
• 安装说明：https://skillhub.cn/install/skillhub.md