前言¶
在 Agent 里处理「记一条备忘」「把网页收进资料库」「在知识库里搜某段话」时，常见做法是手写脚本或零散 MCP，笔记与知识库两套接口各管一块，触发词也不统一。下面介绍 SkillHub 上的 ima（@user_58b36e40/ima-pro）：把 IMA OpenAPI 封装成一套 Skill，让模型在对话里按意图走笔记管理与知识库操作，而不是每次从零拼调用链。
这是什么¶
ima 是社区发布的 knowledge-management 类 Skill，当前版本 1.0.0，发布者为 user_58b36e40。官方定位是「统一的 IMA OpenAPI 技能」，覆盖笔记管理以及知识库相关操作。
SkillHub 页面与 API 入口：
- 展示页：https://www.skillhub.cn/skills/user_58b36e40/ima-pro
- API：https://api.skillhub.cn/user_58b36e40/ima-pro
页面标签标明 requires_api_key=false（以 SkillHub 元数据为准）；具体鉴权与 OpenAPI 字段以安装后 Skill 包内的 SKILL.md 为准。
核心功能¶
依据官方简介，已核实的能力范围如下。
知识库
- 上传文件到知识库
- 将网页添加到知识库
- 搜索知识库内容
笔记
- 搜索、浏览笔记
- 创建、编辑笔记
触发意图（Skill 自带说明）
除明确提到「知识库」「资料库」「笔记」「备忘录」「记事」外，下列口语也应走本 Skill，例如：
- 文件上传到知识库、网页收藏
- 知识搜索、个人文档存取
- 「帮我记一下」「搜一下知识库里有没有 XX」
即：用户未点名「知识库」或「笔记」，只要意图落在上述范围，Agent 应选用 ima。
安装与启用¶
安装流程遵循 SkillHub 通用文档 skillhub.md。先做 CLI 检查，再把技能装进当前 Agent 的 skills 目录（--dir 必填，否则默认 ./skills/ 可能不被识别）。
1、检查 SkillHub CLI
command -v skillhub && skillhub --version
未安装时可执行完整安装（文档推荐）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装 ima
坐标为 @user_58b36e40/ima-pro。官方页面给出的安装提示为：按 skillhub.md 安装该坐标。命令形态如下（将 <skills 目录> 换成你当前客户端的路径）：
skillhub install @user_58b36e40/ima-pro --dir <skills 目录>
常用客户端 skills 目录（摘自 skillhub.md）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
也可把安装提示直接发给 AI：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_58b36e40/ima-pro`。
安装完成后，按你所用 Agent 的惯例刷新或重启，使新 Skill 被加载。
典型用法¶
公开资料未附带独立 REST 示例；用法以「自然语言意图 + Skill 内 OpenAPI 封装」为主。下列表述与官方触发说明一致，可在启用 ima 后直接复现（具体工具名与参数由 SKILL.md 定义）：
- 「把这份 PDF 上传到知识库。」
- 「把这个网页链接加到资料库。」
- 「搜一下知识库里有没有关于 Redis 持久化的内容。」
- 「帮我记一下：明天十点和产品对需求评审。」
- 「打开我最近写的笔记，把第二段改成……」
经过上面的步骤，Agent 应自动选用 ima，而不是临时编写与 IMA 无关的占位逻辑。
适用场景与注意¶
适合谁
- 已使用或计划使用 IMA 作为笔记与知识库后端，希望在 Cursor、Claude Code、Codex 等环境里用同一套 Skill 完成存取与检索。
- 希望用统一触发规则覆盖「收藏网页、上传文件、搜库、记备忘」等高频意图的开发者。
注意
- 来源为 community，升级与维护节奏以发布者为准；安装前可在 SkillHub 查看版本与简介。
- SkillHub 统计（以抓取资料为准）：分类 knowledge-management，评分 100000，下载 1845；与页面展示一致时以页面为准。
- 本文未列出 IMA OpenAPI 的 endpoint 与请求体；实施集成时请只依赖安装包内文档与 IMA 官方 API 说明，避免臆造配置项。
- 沙箱或限网环境安装 CLI 时需允许访问 SkillHub 安装脚本域名。
结尾¶
ima 把 IMA OpenAPI 收敛成一条 Skill 路径：笔记的增删改查与知识库的上传、收录、检索，用同一套意图规则触发。若你的 Agent 工作流里经常碰个人知识库与备忘，可先按上文安装 @user_58b36e40/ima-pro，再从官方页核对版本与说明：https://www.skillhub.cn/skills/user_58b36e40/ima-pro 。
