前言¶
在 Agent 里做笔记和知识库操作,常见的做法是针对每个动作单独写一段工具调用:上传文件写一遍,收藏网页写一遍,搜知识库再写一遍。结果逻辑分散、容易漏掉鉴权和参数校验,接入新的笔记类需求时又得从头再来。下面介绍的 ima-skills-new 把这两类操作统一到一个 Skill 里,用一套声明式的能力描述替代零散的调用代码。
这是什么¶
ima-skills-new 是一个基于通用 SKILL.md 格式的 Agent 技能,坐标 @user_d455dfaa/ima-skills-new,当前版本 1.0.0,由社区开发者 user_d455dfaa 发布,来源标注为 community,分类属于 knowledge-management。
它解决的问题是:让 Agent 在用户提到知识库、资料库、笔记、备忘录、记事,或者要上传文件、收藏网页、搜索知识库时,能够识别意图并调用对应的 IMA OpenAPI 操作,而不需要使用者自己去拼装每一次请求。
核心功能¶
这个 Skill 定位为「统一的 IMA OpenAPI 技能」,能力分两条线:
1、笔记管理:搜索、浏览、创建、编辑笔记。
2、知识库操作:上传文件到知识库、把网页添加到知识库、搜索知识库内容。
触发条件不只是显式提到「知识库」或「笔记」。按官方说明,只要意图落在文件上传、网页收藏、知识搜索、个人文档存取这类范围,就应该触发这个 Skill,例如「帮我记一下」「搜一下知识库里有没有 XX」这类说法。
安装与启用¶
官方页面:
https://api.skillhub.cn/user_d455dfaa/ima-skills-new
SkillHub 页面:
https://www.skillhub.cn/skills/user_d455dfaa/ima-skills-new
需要说明的是,本次抓取中官方页面只返回了站点标题,没有取到页面正文里的安装命令和目录规范,因此这里不给出具体的安装命令或配置文件内容,避免写入无法核实的步骤。可以确认的是两点:该 Skill 基于通用 SKILL.md 格式,标签中带有 requires_api_key=true,说明启用前需要准备好对应的 API Key。具体在 Cursor、Codex CLI、Claude Code 中各自的启用方式,以官方页面为准。
典型用法¶
下面的用法来自官方简介中列出的能力范围,作为接入后可以覆盖的调用类型参考。
上传文件到知识库:使用者说「把这个文档放到知识库里」,Agent 识别为知识库操作,走上传文件这条路。
收藏网页到知识库:使用者提供网址并要求保存,对应把网页添加到知识库的操作。
搜索知识库:使用者询问「知识库里有没有 XX」,对应搜索知识库内容的接口。
笔记的增改查:使用者要求新建一条备忘、改一下某条笔记、或者翻一下之前的记录,分别对应创建、编辑、浏览/搜索笔记。
这些示例描述的是意图与能力的对应关系,具体接口路径、入参与返回结构需要查阅 IMA OpenAPI 文档和 SKILL.md 正文。
适用场景与注意¶
适合的使用者:需要在 Agent 里统一处理笔记和知识库的开发者,希望用一个技能覆盖上传、收藏、搜索这类高频动作,而不是逐个接口自己封装。
需要注意的地方:
1、该 Skill 依赖 IMA OpenAPI,需要有效的 API Key,没有 Key 的情况下调用会失败。
2、分类为 knowledge-management,范围集中在笔记和知识库,不适合当作通用文件系统或数据库操作技能。
3、发布者为社区开发者(来源 community),不是官方 IMA 团队直接发布,采用前建议先跑通一次完整流程。
4、SkillHub 页面显示的当前统计为评分 100000、下载 1528、安装 0(以抓取到的资料为准)。安装量为 0,说明实际部署案例尚不充分,接入前建议自行验证。
结尾¶
ima-skills-new 的价值在于把笔记管理和知识库操作收敛到一个技能里,并把触发条件放宽到「个人文档存取」这类模糊表达,减少使用者在意图描述上的负担。它依赖 IMA OpenAPI 和 API Key,安装命令等细节请以官方页面为准。
官方地址:https://api.skillhub.cn/user_d455dfaa/ima-skills-new