前言¶

在 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