西瓜沒瓤:用 IMA OpenAPI 把知識庫和筆記接到 Agent

前言

在 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 官方簡介,表述保持與原文一致的範圍,不補充未公開的接口清單。

  1. 知識庫:上傳文件、將網頁添加到知識庫、搜索知識庫內容。
  2. 筆記:搜索、瀏覽、創建、編輯筆記(含備忘錄、記事等同類意圖)。
  3. 觸發範圍:除明確提到「知識庫」「筆記」外,用戶說「幫我記一下」「搜一下知識庫裏有沒有 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 簡介中的觸發說明一致,便於在對話中復現:

  1. 「把這份 PDF 上傳到知識庫。」
  2. 「把這個網頁鏈接加到資料庫。」
  3. 「在知識庫裏搜一下有沒有關於 OAuth 的筆記。」
  4. 「幫我記一下:明天十點要和後端對齊接口字段。」
  5. 「打開我最近寫的備忘錄,改一下第二段。」

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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜