前言¶

在对话式 Agent 里处理个人资料，常见做法是临时写脚本或手工打开 IMA 客户端：搜知识库、记一条备忘、把网页收进资料库，每一步都要自己拼接口或切换应用。IMA OpenAPI 技能把这类能力收成一份符合通用 SKILL.md 规范的说明，交给 Agent 在合适意图下自动选用，减少重复对接 OpenAPI 的工作。

下面介绍它的定位、已公开的能力边界，以及通过 SkillHub 安装到 Cursor 等客户端的方式。

这是什么¶

IMA OpenAPI 技能（坐标 @user_c54b5ab8/ima-skill-pro，版本 1.0.0）是 SkillHub 上的社区技能，分类为 knowledge-management，由发布者 user_c54b5ab8 维护。

一句话定位：统一的 IMA OpenAPI 技能，支持笔记管理和知识库操作。当用户需要搜索知识库内容，或对笔记进行搜索、浏览、创建、编辑时，应由 Agent 加载此技能并按其中的指引调用 IMA OpenAPI。

官方入口：

• API 页：https://api.skillhub.cn/user_c54b5ab8/ima-skill-pro
• SkillHub 展示页：https://www.skillhub.cn/skills/user_c54b5ab8/ima-skill-pro

核心功能¶

以下能力均来自技能简介与 SkillHub 页面说明，未在公开页展开的具体接口名、参数不在本文臆造。

知识库¶

• 搜索知识库内容。
• 与资料库相关的操作归入「知识库操作」：用户提到知识库、资料库，或意图为把文件上传到知识库、将网页添加到知识库、在知识库中检索某主题时，应触发本技能。

笔记¶

• 搜索、浏览、创建、编辑笔记。
• 用户提到笔记、备忘录、记事，或口语化表达如「帮我记一下」，且意图是个人文档存取时，同样适用。

Agent 侧触发约定¶

技能说明要求：即使用户未明确说出「知识库」或「笔记」，只要意图落在文件上传至知识库、网页收藏、知识搜索、个人文档读写等范围，也应使用此 skill，而不是临时编造调用方式。

SkillHub 标签为 requires_api_key=false；若实际环境仍需 IMA 侧鉴权，以安装后技能包内 SKILL.md 及 IMA 官方 OpenAPI 文档为准。

安装与启用¶

方式一：让 Agent 按 SkillHub 指引安装¶

SkillHub 页面给出的提示词为：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_c54b5ab8/ima-skill-pro`。

可将上述句子发给支持 Skill 安装的 AI 客户端，由其读取安装文档并完成拉取。

方式二：使用 skillhub CLI¶

先确认 CLI 是否可用：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行（完整安装示例）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。示例：

skillhub install @user_c54b5ab8/ima-skill-pro --dir <skills 目录>

常见客户端 skills 路径（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

装到对应目录后，按各客户端要求重启或刷新技能列表，使 ima-skill-pro 生效。

典型用法¶

公开页未提供可复制的 HTTP 请求示例；典型用法是自然语言驱动 Agent，由技能内的流程说明对接 IMA OpenAPI。

1. 检索资料：「搜一下知识库里有没有关于 XX 的文档。」
2. 记笔记：「帮我记一下：明天十点开会，附三条要点。」
3. 收藏网页：「把这个链接加到知识库。」（意图属于知识库操作时触发本技能。）
4. 整理已有笔记：「列出我最近写的笔记标题」或「把某条笔记改成……」

经过上面的步骤安装并启用后，Agent 应在匹配意图时自动选用 IMA OpenAPI 技能，而不是零散猜测接口。

适用场景与注意¶

适合谁

• 已在使用或计划对接 IMA OpenAPI 的开发者与个人用户。
• 希望在 Cursor、Claude Code、Codex 等环境里，用同一套技能描述统一处理笔记与知识库的对话场景。

限制与注意

• 本文依据 SkillHub 公开元数据（截至查阅时：评分 100000，下载 1509 次）；具体行为以安装后的技能包内容为准。
• 社区来源（community），升级与兼容性需自行关注 @user_c54b5ab8/ima-skill-pro 的版本更新。
• 未在 SkillHub 页面展开的 API 细节、错误码、配额等，请查阅 IMA OpenAPI 官方文档及技能内说明。

结尾¶

IMA OpenAPI 技能把笔记管理与知识库相关操作收敛到一份 Agent 可执行的技能里，并通过意图描述降低「每次对话重新讲一遍怎么用 OpenAPI」的成本。若需要安装或查看元数据，请以官方地址为准：https://api.skillhub.cn/user_c54b5ab8/ima-skill-pro（SkillHub：https://www.skillhub.cn/skills/user_c54b5ab8/ima-skill-pro）。