前言¶

在 Agent 裏做個人資料管理，通常有兩條路：要麼讓模型每次現寫 HTTP 調用，要麼自己維護一套針對某個產品的封裝腳本。前者重複、容易漏參數；後者綁定一個具體實現，產品接口一變就要跟着改。

ima技能解決的是中間這層：把 IMA OpenAPI 的筆記管理與知識庫操作收成一個統一 Skill，Agent 側只描述意圖，具體調用交給 Skill 處理。

這是什麼¶

ima技能是一個基於通用 SKILL.md 格式的社區技能，座標 @user_7e25a48a/ima2-skill，當前版本 12.1.10，來源標記爲 community。

它的定位是統一的 IMA OpenAPI 技能，覆蓋兩類操作：筆記管理（搜索、瀏覽、創建、編輯）和知識庫操作（上傳文件、添加網頁、搜索知識庫內容）。

解決的痛點是觸發分散：用戶說「幫我記一下」「搜一下知識庫裏有沒有 XX」時，並沒有出現「知識庫」「筆記」這樣的關鍵詞，靠關鍵詞匹配的方案會漏掉。這個 Skill 的觸發條件把這類隱含意圖也包含進來。

核心功能¶

官方簡介列出的能力如下：

1、知識庫文件上傳。把本地文件存入知識庫。
2、網頁收藏。把指定 URL 添加到知識庫。
3、知識庫內容搜索。按內容檢索已有資料。
4、筆記檢索與瀏覽。搜索、列出已有筆記。
5、筆記創建與編輯。新建筆記或修改已有筆記。

觸發方式方面，除了顯式提到知識庫、資料庫、筆記、備忘錄、記事的場景，簡介也明確：只要意圖涉及文件上傳到知識庫、網頁收藏、知識搜索、個人文檔存取，即使用戶沒有說出「知識庫」或「筆記」，同樣應觸發此 Skill。

安裝與啓用¶

SkillHub 頁面列出的座標和版本信息：

座標: @user_7e25a48a/ima2-skill
版本: 12.1.10
分類: knowledge-management
標籤: requires_api_key=true

其中 requires_api_key=true 表示該 Skill 需要 API Key 才能使用。已抓取資料裏沒有給出安裝命令、目錄路徑和 Key 配置項的具體寫法，因此這裏不臆造。安裝前請打開官方頁面確認當前版本的安裝步驟與配置字段：

https://api.skillhub.cn/user_7e25a48a/ima2-skill

SkillHub 頁面地址爲：

https://www.skillhub.cn/skills/user_7e25a48a/ima2-skill

Cursor、Codex CLI、Claude Code 的接入方式差異，資料中未提供，此處不分別說明。

典型用法¶

以下場景取自官方簡介中列出的觸發意圖，作爲調用時的輸入參考：

幫我記一下今天會議的結論

把這份 PDF 上傳到知識庫

把這個網頁收藏進知識庫

搜一下知識庫裏有沒有關於退款流程的資料

列出我最近的筆記

改一下上週那篇筆記裏的日期

前四類對應知識庫操作，後兩類對應筆記管理。實際調用時，Agent 按用戶意圖匹配到上述能力後，由 Skill 向 IMA OpenAPI 發起請求，用戶側不需要關心具體接口。

適用場景與注意¶

適合誰：

• 已經在使用 IMA 開放接口、希望 Agent 直接讀寫個人筆記和知識庫的開發者。
• 需要在對話裏完成文件存檔、網頁收藏、資料檢索，而不是手工整理的使用者。

注意點：

1、API Key 必需。requires_api_key=true，沒有配置 Key 時技能無法工作。
2、觸發靠意圖而非關鍵詞。如果對話裏明確出現了上傳、收藏、記一下、搜資料這類動作，即使沒提「知識庫」，也應把它接到這個 Skill 上。
3、接口能力受 IMA OpenAPI 當前範圍限制。Skill 封裝的是 OpenAPI 已有能力，IMA 側接口變化會直接影響可用功能。
4、安裝數據目前偏低。SkillHub 頁面顯示下載 1285 次、安裝 0 次，說明實際部署樣本很少，接入前建議在自己的數據上先驗證一輪。

結尾¶

ima技能的價值在於把筆記管理和知識庫操作收斂到一處，並把「用戶沒說關鍵詞但意圖明確」的場景也納入觸發範圍。對需要讓 Agent 直接管理個人資料的人來說，它比每次現寫接口調用少一層維護成本。

官方地址：https://api.skillhub.cn/user_7e25a48a/ima2-skill