前言¶
在 Cursor、Claude Code 等环境里，模型默认只能处理当前对话和本地工作区里的文件。个人笔记、资料库里的网页收藏、已上传的文档，往往落在 IMA 一类产品里，和 Agent 之间没有稳定桥梁。常见做法是每次手动复制粘贴，或自己写脚本对接零散接口，维护成本高，也很难让模型判断「该不该走知识库」。
下面介绍 SkillHub 上的社区 Skill 20260425001：它把 IMA OpenAPI 封装成一套 Agent Skill，在对话里统一处理笔记管理与知识库相关意图。
这是什么¶
20260425001（坐标 @user_58e185f9/20260425001，版本 1.0.0）是发布者 user_58e185f9 在 SkillHub 上架的 community 来源技能，分类为 knowledge-management。官方简介将其定位为：统一的 IMA OpenAPI 技能，支持笔记管理和知识库操作。
Skill 页面标注 requires_api_key=false（标签层面未要求单独配置 API Key 字段）；具体鉴权与账号绑定以 Skill 包内 SKILL.md 及 IMA 侧要求为准，安装后应由 Agent 按技能说明执行。
核心功能¶
依据 SkillHub 页面与已抓取元数据，可核实的能力边界如下。
知识库¶
- 上传文件到知识库
- 将网页添加到知识库
- 搜索知识库内容
笔记¶
- 搜索、浏览笔记
- 创建、编辑笔记
触发意图（Skill 自述）¶
官方说明中写明：除明确提到「知识库」「资料库」「笔记」「备忘录」「记事」外，下列口语化意图也应触发本 Skill，例如：
- 文件上传到知识库、网页收藏
- 「帮我记一下」类个人文档存取
- 「搜一下知识库里有没有 XX」类检索
即使用户未说出「知识库」或「笔记」关键词，只要意图落在上述范围，Agent 应选用此 Skill。
安装与启用¶
SkillHub 推荐通过 skillhub CLI 安装，并必须把技能目录指向当前 Agent 的 skills 路径，否则默认装到 ./skills/ 可能无法被识别。
1、安装或检查 CLI¶
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装流程与优先源策略见：SkillHub 安装与优先源配置。
2、安装本 Skill¶
官方页面给出的安装提示为：根据 https://skillhub.cn/install/skillhub.md，安装 @user_58e185f9/20260425001。
命令行形式示例（将 <skills 目录> 换成当前环境路径）：
skillhub install user_58e185f9/20260425001 --dir <skills 目录>
常用 Agent 的 skills 目录（摘自 SkillHub 安装文档）：
| 环境 | 路径 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
也可在 Skill 页面将安装提示词发给 AI，让其按上述文档完成安装。安装或更新技能后，按各客户端说明重启或刷新 Agent，使 SKILL.md 被加载。
典型用法¶
本 Skill 面向自然语言驱动，而非在文章里重复未公开的 OpenAPI 路径。可复现的用法来自官方自述的意图示例：
- 检索资料库：用户说「搜一下知识库里有没有关于 XX 的文档」，Agent 应触发本 Skill 并走知识库搜索能力。
- 收藏网页：用户要求「把这个链接加到资料库」，对应添加网页到知识库。
- 快速记事：用户说「帮我记一下：明天十点开会」，对应笔记创建或编辑类操作。
- 文件入库：用户上传或指定本地文件并要求「放进知识库」，对应文件上传至知识库。
具体调用顺序、参数与错误处理以技能包内说明为准；Agent 读取 SKILL.md 后按 IMA OpenAPI 约定执行。
适用场景与注意¶
适合谁
- 已在使用 IMA 生态，希望 Cursor / Claude Code / Codex 等 Agent 直接操作笔记与知识库的团队或个人。
- 希望用一套 Skill 覆盖「搜索 / 上传 / 收藏 / 记事」，减少为每个动作单独写提示词或脚本的维护成本。
元数据与限制
- SkillHub 统计（以已抓取资料为准）：评分 100000，下载 955，分类 knowledge-management。
- 来源为 community，升级与兼容性需关注 SkillHub 上的版本号（当前 1.0.0）。
- 标签
requires_api_key=false表示 SkillHub 侧未标记必须填写 API Key 字段；若 IMA 账号或 OpenAPI 仍有登录、令牌等要求，需在技能说明中逐项配置，本文无法从公开摘要中展开未列出的字段名。
注意
- 安装时务必使用
--dir指向正确的 skills 目录。 - 勿将本 Skill 能力等同于「任意云盘」；能力范围以 IMA OpenAPI 与技能文档为准。
结尾¶
20260425001 把笔记与知识库操作收敛到一条 IMA OpenAPI 技能链路上，并用明确的触发意图降低 Agent 误用其他工具的概率。需要查看详情或复制安装提示时，可打开 SkillHub 页面或 API 元数据地址：
- SkillHub：https://www.skillhub.cn/skills/user_58e185f9/20260425001
- API：https://api.skillhub.cn/user_58e185f9/20260425001
