西瓜没瓤:用 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

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

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

Xiaoye