前言¶

在 Agent 里用 IMA OpenAPI，通常要自己处理三件事：判断用户这次到底想干什么、把动作映射到对应的接口、把返回结果拼成用户能看的一段内容。笔记有搜索、浏览、创建、编辑四类操作，知识库还有上传文件、添加网页、搜索内容，挨个写提示词或者写工具调用逻辑，代码会越堆越散。

ima-skill 做的事情是把这套动作打包成一个 SKILL.md 格式的 Skill，由 SkillHub 上的社区开发者维护。下面介绍它的定位、能力和用法。

这是什么¶

ima-skill（专业版）是一个基于通用 SKILL.md 格式的 Agent Skill，定位是「统一的 IMA OpenAPI 技能」，把笔记管理和知识库操作放进同一个入口。

• 出品方：SkillHub 社区发布者 user_87f6522b
• 坐标：@user_87f6522b/ima-skill
• 版本：1.0.0
• 来源：community
• 分类：knowledge-management
• 标签：requires_api_key=true

它解决的问题是：用户说「帮我记一下」「搜一下知识库里有没有 XX」这类话时，Agent 往往判断不出这属于笔记还是知识库操作，也就不知道该调哪个接口。这个 Skill 把意图识别和操作分发固化下来，让 Agent 直接按统一流程执行。

核心功能¶

资料中列出的能力分两类。

笔记管理：搜索、浏览、创建、编辑笔记。

知识库操作：上传文件、添加网页到知识库、搜索知识库内容。

触发方式上，除了显式提到「知识库」「资料库」「笔记」「备忘录」「记事」，还覆盖了没有明确说出这些词的场景，比如文件上传到知识库、网页收藏、知识搜索、个人文档存取。专业版还规定了输出方式：先给一句话结论再展开，交付结构化结果文件，关键判断标注依据。

安装与启用¶

预抓取的资料里没有给出安装命令和配置字段，只给出了一个标签：requires_api_key=true。这意味着启用前需要准备好 IMA OpenAPI 的密钥，具体填在哪个配置文件、字段名是什么，需要到页面确认后再写，不要凭推测填写。

安装入口：

https://api.skillhub.cn/user_ed811e0b/ima-skill

SkillHub 页面：

https://www.skillhub.cn/skills/user_87f6522b/ima-skill

由于资料中没有区分 Cursor、Codex CLI、Claude Code 各自的安装差异，这里不做分别说明。

典型用法¶

官方简介中给出了几类可复现的触发场景，下面按这些场景列出 Agent 侧的预期行为。

1、用户说「帮我记一下 XX」，属于个人文档存取。Agent 应识别为笔记创建，写入后返回结构化结果。

2、用户说「搜一下知识库里有没有 XX」，属于知识搜索。Agent 应先在知识库中检索，再给出结论和依据。

3、用户给了一个文件并说「传到知识库」，属于文件上传。Agent 应执行上传文件到知识库的操作。

4、用户给了一个网址并希望收藏，属于网页添加到知识库。

5、用户要改某条笔记，属于笔记编辑，对应搜索/浏览定位后编辑的流程。

专业版的输出要求是：先一句话结论，再展开细节，交付结构化结果文件，关键判断标注依据。

适用场景与注意¶

适合的使用者：已经在用 IMA OpenAPI、希望 Agent 自己完成笔记和知识库操作、不想为每类操作单独写提示词的开发者。

需要注意三点。

一是 requires_api_key=true，密钥缺失时 Skill 无法调用接口，部署前要先确认配置。

二是资料中显示的安装数为 0、下载数为 77，评分 100000（截至抓取时间）。下载量不高意味着社区反馈样本少，遇到边界问题可能没有现成答案，需要自己看接口文档。

三是意图识别依赖 Skill 中列出的触发词和语义描述。如果用户表达方式与「知识库」「笔记」「资料库」等差异较大，命中可能不稳定，需要在提示词层面做补充。

小结¶

ima-skill 的价值在于把 IMA OpenAPI 的笔记管理和知识库操作收敛到一个 Skill，省掉意图判断和接口分发的手工工作。适合个人知识库、资料收集、轻量记事这类场景。

官方地址：https://api.skillhub.cn/user_ed811e0b/ima-skill