前言¶
個人資料往往散落在 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 流程執行，而不是每次手寫檢索腳本或重複說明文檔位置。
核心功能¶
以下能力均來自官方簡介，未在頁面單獨展開實現細節的部分不臆測：
- 基於知識庫問答：用戶表達「基於知識庫」「查一下知識庫」「根據文檔」「從我的資料」「結合我的筆記」等時觸發，在已索引內容上做問答。
- 報告與思維導圖：支持「幫我寫報告」「整理成報告」「生成思維導圖」「做個導圖」等意圖，在文檔上下文上生成結構化輸出。
- 入庫與向量索引：支持「上傳知識庫」「有新文件」「索引文檔」「建向量庫」等，將文件納入向量庫流程。
- 分區與庫管理：支持「基於某個分區」「有哪些分區」「分區列表」「創建知識庫」「初始化知識庫」「知識庫列表」等表述；簡介中還提到「基於mysql查詢」作爲觸發詞之一，具體查詢方式以 Skill 內說明爲準。
- 依賴標註：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 的對話裏使用：
| 意圖 | 示例說法 |
|---|---|
| 問答 | 「基於知識庫，XXX 是什麼？」「查一下知識庫裏關於 YYY 的說明」 |
| 指定分區 | 「基於某個分區查一下 ZZZ」「分區列表」 |
| 報告 | 「根據文檔幫我寫報告」「整理成報告」 |
| 思維導圖 | 「生成思維導圖」「做個導圖」 |
| 上傳與索引 | 「上傳知識庫」「有新文件需要索引」「建向量庫」「索引文檔」 |
| 庫初始化 | 「創建知識庫」「初始化知識庫」「知識庫列表」 |
先做文檔入庫或索引（若庫尚未建立），再在同一客戶端裏用問答或報告類觸發詞；具體步驟順序以安裝後目錄中的 SKILL.md 爲準。
適用場景與注意¶
適合誰
- 本地或團隊內積累了大量 PDF / Markdown / Word，希望在 Agent 裏用口語完成檢索、總結、報告與導圖。
- 需要按「分區」組織資料，並偶爾做向量庫構建與列表查詢的用戶。
限制與注意
- API Key：標籤
requires_api_key=true，未配置時相關能力可能不可用；配置項以 Skill 包內文檔爲準，此處不編造變量名。 - 安裝路徑：務必
skillhub install ... --dir指向正確目錄，避免裝到默認./skills/導致 Agent 不加載。 - 社區來源：版本 1.0.0、來源
community，升級與變更以 SkillHub 頁面爲準；頁面統計（截至資料抓取）爲評分 100000、下載 1776、安裝 18，僅供選型參考。 - 能力邊界：簡介覆蓋問答、報告、導圖、上傳與分區管理；未在官方頁面聲明的集成或數據庫細節不要假設已支持，以
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
