前言¶

把資料收進 IMA、寫筆記、按關鍵詞找回內容，通常要在客戶端和網頁之間切換，或者自己對接 IMA OpenAPI、記接口名、管憑證。若希望 Agent 在對話裏完成「上傳這份 PDF」「把鏈接放進知識庫」「搜一下庫裏有沒有某主題」，需要一層把自然語言意圖映射到 IMA 能力的 Skill。

下面介紹 SkillHub 上的 乾穹·知識庫助手（座標 @user_3ef04463/qianqiong-ima，文中亦稱 IMA 知識庫相關能力）。它把筆記管理與知識庫操作收斂到統一的 IMA OpenAPI 技能裏，由模塊自動路由，不必在對話裏背誦具體接口。

這是什麼¶

乾穹·知識庫助手 是社區來源（community）的 Agent Skill，當前版本 v3.1.4，分類爲 knowledge-management，發佈者爲 user_3ef04463。官方簡介概括爲：在對話裏直接管理 IMA——新建或追加筆記、上傳常見文檔與圖片、收藏網頁進知識庫、搜索並讀回內容；憑證動態獲取、不外泄；模塊自動路由，不用記接口名。

Skill 帶有 requires_api_key=true 標籤，表示使用前需要完成與 IMA 相關的 API 憑證配置，具體字段以安裝後 Skill 包內 SKILL.md 及說明爲準。

在 SkillHub 上，該技能評分 100000，下載 3828 次（數據取自 SkillHub 頁面展示，會隨時間變化）。

核心功能¶

以下能力均來自官方頁面與 Skill 簡介，未列出的接口或格式請勿自行假設。

1. 筆記：新建筆記、向已有筆記追加內容；對應用戶側的瀏覽、創建、編輯筆記意圖。
2. 知識庫文件：支持上傳 PDF、Word、Excel、圖片 等到知識庫。
3. 網頁收藏：將網頁添加進知識庫，便於後續檢索。
4. 檢索與讀回：在知識庫內搜索，並把匹配內容讀回對話。
5. 接入方式：統一走 IMA OpenAPI；Agent 按 Skill 內路由選擇模塊，用戶側用自然語言描述任務即可。

何時應啓用此 Skill（與官方觸發說明一致）：用戶提到知識庫、資料庫、筆記、備忘錄、記事，或要上傳文件、添加網頁、搜索庫內內容、搜索/瀏覽/創建/編輯筆記時。即未明說「知識庫」「筆記」，只要意圖是文件進庫、網頁收藏、庫內搜索、個人文檔存取（例如「幫我記一下」「搜一下知識庫裏有沒有 XX」），也應走本 Skill。

安裝與啓用¶

安裝流程遵循 SkillHub 通用說明 skillhub.cn/install/skillhub.md。官方頁面給出的安裝提示爲：讓 AI 按該文檔安裝 @user_3ef04463/qianqiong-ima。

1、檢查或安裝 SkillHub CLI¶

先確認本機是否已有 skillhub：

command -v skillhub && skillhub --version

若未安裝，可使用官方安裝腳本（完整安裝含 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 到當前 Agent 的 skills 目錄¶

安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄；裝到默認 ./skills/ 可能不會被加載，且部分環境安裝後需重啓 Agent。

skillhub install @user_3ef04463/qianqiong-ima --dir <skills 目錄>

常用路徑（摘自 SkillHub 安裝文檔）：

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

也可在 SkillHub 技能頁通過「將提示詞發送給你的 AI 安裝該 skills」的方式，把座標 @user_3ef04463/qianqiong-ima 交給 Agent 按上述文檔完成安裝。

3、API 憑證¶

Skill 標記爲需要 API Key（requires_api_key=true）。官方強調憑證動態獲取、不外泄；具體配置項與獲取步驟以安裝後的 Skill 說明爲準，本文不臆造環境變量名或密鑰格式。

典型用法¶

官方資料未提供固定 Shell 示例，實際使用以對話意圖驅動 Agent 調用 Skill 內封裝的 IMA OpenAPI。下面幾類表述與簡介中的能力對應，便於自測是否已正確安裝與授權：

1. 記筆記：「新建一條筆記，標題是本週會議紀要，正文先寫待辦三條。」或「把下面這段話追加到我昨天的項目筆記裏。」
2. 入庫文件：「把這個 PDF / Word / Excel / 圖片上傳到 IMA 知識庫。」（需 Agent 能訪問本地或對話中的文件路徑。）
3. 收藏網頁：「把這個 URL 加到知識庫，方便以後搜。」
4. 檢索：「在知識庫裏搜一下有沒有關於 XX 的文檔，把相關段落總結給我。」

經過上面的步驟，若 Agent 能完成對應操作並讀回庫內內容，說明 Skill 路由與憑證配置基本正常。

適用場景與注意¶

適合誰：已在用 IMA 做個人或團隊資料沉澱，希望 Cursor、Claude Code、Codex 等帶 Skills 的 Agent 在同一對話裏完成記筆記、傳文件、收網頁、庫內搜索，而不想手寫 OpenAPI 調用鏈的開發者或重度用戶。

限制與注意：

• 依賴 IMA 服務與有效 API 憑證；requires_api_key=true，未配置時 Skill 無法真正訪問遠端。
• 上傳格式以官方列出的 PDF、Word、Excel、圖片 爲準，其他格式是否支持需以 Skill 包內文檔爲準。
• SkillHub 安裝文檔要求 --dir 指向正確目錄，否則安裝成功但 Agent 不加載。
• 評分、下載量等統計來自 SkillHub 展示，僅作選型參考。

結尾¶

乾穹·知識庫助手把 IMA 的筆記與知識庫能力收成一條 OpenAPI Skill：對話裏完成寫入、上傳、收藏與搜索，接口路由與憑證由 Skill 側處理。需要安裝或查看詳情時，可打開 SkillHub 技能頁：

• https://www.skillhub.cn/skills/user_3ef04463/qianqiong-ima
• https://api.skillhub.cn/user_3ef04463/qianqiong-ima