前言¶
在 Cursor、Claude Code 等環境裏寫代碼時,常會順手讓 Agent「記一條備忘」「把這篇網頁收進資料庫」或「在知識庫裏搜一下上次整理的接口說明」。若沒有統一技能,要麼口頭描述一長串操作步驟,要麼爲筆記和知識庫各裝一套互不相關的 Skill,觸發詞和調用方式也不一致。
下面介紹 SkillHub 上的社區 Skill「西瓜沒瓤」(@user_e859a008/blue7744611)。它把 IMA OpenAPI 下的筆記管理與知識庫操作收進同一份 SKILL.md 約定裏,由 Agent 按用戶意圖自動選用對應能力。
這是什麼¶
「西瓜沒瓤」是面向 knowledge-management 分類的統一 IMA OpenAPI 技能:支持筆記管理,以及知識庫相關操作(官方簡介中的表述)。
- 座標:
@user_e859a008/blue7744611 - 版本:1.0.0
- 來源:community(SkillHub 社區發佈)
- 發佈者:
user_e859a008 - 官方頁面:https://www.skillhub.cn/skills/user_e859a008/blue7744611
- API 入口(SkillHub 登記):https://api.skillhub.cn/user_e859a008/blue7744611
SkillHub 頁面標註該 Skill 需要 API Key(requires_api_key=true)。具體密鑰字段與配置方式以安裝後目錄內的 SKILL.md 爲準,本文不展開未在公開頁列出的配置項。
核心功能¶
以下能力均來自 SkillHub 官方簡介,表述保持與原文一致的範圍,不補充未公開的接口清單。
- 知識庫:上傳文件、將網頁添加到知識庫、搜索知識庫內容。
- 筆記:搜索、瀏覽、創建、編輯筆記(含備忘錄、記事等同類意圖)。
- 觸發範圍:除明確提到「知識庫」「筆記」外,用戶說「幫我記一下」「搜一下知識庫裏有沒有 XX」、或意圖涉及個人文檔存取、網頁收藏、知識搜索時,也應由該 Skill 承接。
安裝與啓用¶
1、安裝 SkillHub CLI(若尚未安裝)¶
先檢查本機是否已有 skillhub:
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
說明見:https://skillhub.cn/install/skillhub.md
2、安裝「西瓜沒瓤」¶
安裝時必須用 --dir 指向當前 Agent 正在使用的 skills 目錄,否則默認會落到 ./skills/,Agent 可能識別不到。
skillhub install @user_e859a008/blue7744611 --dir <你的 skills 目錄>
常見客戶端的 skills 路徑(摘自 SkillHub 安裝文檔):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
也可將下面提示詞發給支持 Skill 的 AI,由其按安裝文檔完成安裝:
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@user_e859a008/blue7744611`。
3、API Key¶
SkillHub 標籤標明 requires_api_key=true。安裝完成後,在技能目錄內閱讀 SKILL.md,按其中說明配置 IMA OpenAPI 所需的 API Key,再重啓或重新加載 Agent 的 skills 目錄(各客戶端行爲以官方文檔爲準)。
典型用法¶
官方資料未提供固定 shell 命令示例,用法以自然語言意圖 + Skill 內指引爲主。下列表述與 SkillHub 簡介中的觸發說明一致,便於在對話中復現:
- 「把這份 PDF 上傳到知識庫。」
- 「把這個網頁鏈接加到資料庫。」
- 「在知識庫裏搜一下有沒有關於 OAuth 的筆記。」
- 「幫我記一下:明天十點要和後端對齊接口字段。」
- 「打開我最近寫的備忘錄,改一下第二段。」
Agent 加載該 Skill 後,應把上述請求路由到 IMA OpenAPI 對應的筆記或知識庫操作,而不是僅做普通網頁搜索或本地文件讀寫。
適用場景與注意¶
適合誰
- 已在使用或計劃使用 IMA 知識庫與筆記,並希望 Coding Agent 用同一套 OpenAPI 技能處理「收藏、檢索、記筆記」。
- 希望用口語化指令(記一下、搜知識庫)觸發,而不必每次說明具體產品名。
限制與注意
- 依賴 IMA OpenAPI 與有效 API Key;未配置密鑰時,Skill 無法完成真實調用。
- SkillHub 登記爲社區來源(community),版本 1.0.0;升級或行爲變更請以 SkillHub 頁面與本地
SKILL.md爲準。 - 公開頁未區分 Cursor / Codex CLI / Claude Code 的差異化配置;除 skills 目錄路徑外,其餘按各客戶端通用的 Skill 加載方式處理即可。
SkillHub 頁面顯示的評分爲 100000,下載 959 次(數據隨 SkillHub 更新,以頁面爲準)。
結尾¶
「西瓜沒瓤」把 IMA 側的筆記與知識庫能力收斂到一個 Skill 座標裏,適合在開發對話中處理資料入庫、檢索和備忘。安裝時記住 --dir 與 API Key,意圖側儘量貼近官方列出的觸發場景。
官方 SkillHub 頁面:https://www.skillhub.cn/skills/user_e859a008/blue7744611