前言¶
在 Cursor、Claude Code 等环境里，用户常说「帮我记一下」「把这篇网页收进资料库」「搜一下知识库里有没有某段话」。若 Agent 只能生成文本、不能调用外部知识服务，这些意图会落在本地对话里，无法落到真实的笔记或知识库。
下面介绍 SkillHub 社区技能「小助手」：它把 IMA OpenAPI 封装成统一 Skill，在对话中覆盖笔记管理与知识库相关操作，并在意图匹配时由 Agent 自动选用。
这是什么¶
「小助手」是面向 knowledge-management 的社区 Skill（发布者 user_7c82ad18，版本 1.0.0，来源 community）。官方定位为：统一的 IMA OpenAPI 技能，支持笔记管理和知识库操作。
Skill 坐标为 @user_7c82ad18/f212d0b8e8775e6a9b9dd816d43cd08d。SkillHub 页面标注标签 requires_api_key=true，使用前需准备 IMA OpenAPI 所需的 API Key（具体环境变量或配置项以安装后的 SKILL.md 为准）。
核心功能¶
以下能力均来自 SkillHub 官方简介与触发说明，未单独列出的接口细节不在本文展开。
- 知识库：上传文件、将网页添加到知识库、搜索知识库内容。
- 笔记：搜索、浏览、创建、编辑笔记（含备忘录、记事等同类表述）。
- 意图触发：除明确提到「知识库」「笔记」外，以下场景也应启用本 Skill：
- 文件上传到知识库、网页收藏；
- 知识搜索、个人文档存取；
- 口语化请求，例如「帮我记一下」「搜一下知识库里有没有 XX」。
安装与启用¶
方式一：让 AI 按 SkillHub 文档安装¶
将下面提示词发给当前 Agent，由其读取安装说明并完成安装（适用于已支持 SkillHub 安装流程的客户端）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_7c82ad18/f212d0b8e8775e6a9b9dd816d43cd08d`。
方式二：SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装页执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，客户端可能无法识别。示例：
skillhub install user_7c82ad18/f212d0b8e8775e6a9b9dd816d43cd08d --dir <skills 目录>
常见客户端 skills 目录（摘自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装或更新 Skill 后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 生效。
API Key¶
页面标签 requires_api_key=true 表示依赖 IMA OpenAPI 凭证。请在安装完成后打开该 Skill 目录内的 SKILL.md，按其中说明配置 API Key；本文不臆造字段名或端点。
典型用法¶
本 Skill 通过自然语言意图驱动，无单独公布的可复制 HTTP 示例。可与官方触发说明对照使用：
- 记笔记：「帮我记一下：下周一把会议纪要发给产品组。」
- 搜知识库：「搜一下知识库里有没有关于 OpenAPI 限流的说明。」
- 收藏网页：「把这个链接加到知识库：[URL]。」
- 上传文件：「把这份 PDF 上传到知识库。」（需 Agent 能访问本地或对话中的文件路径。）
Agent 在识别到知识库、笔记或上述隐含意图时，应加载「小助手」并调用 IMA OpenAPI，而不是仅在回复中复述内容。
适用场景与注意¶
适合谁
- 已使用或计划使用 IMA 知识库与笔记能力，并希望 Cursor、Claude Code、Codex 等 Agent 直接操作，而不是手动切应用。
- 希望用统一 Skill 覆盖「上传 / 收藏 / 搜索 / 笔记 CRUD」，减少为每个动作单独写提示词。
限制与注意
- 依赖 IMA OpenAPI 与有效 API Key；网络或鉴权失败时，Skill 无法完成写库或检索。
- 社区来源（community），行为与 IMA 侧 API 变更以官方 Skill 包与 IMA 文档为准。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 1061 次；选用前可在 SkillHub 页面核对最新版本与说明。
结尾¶
「小助手」把 IMA 的笔记与知识库能力收敛到一个 Skill 里，并用较宽的意图描述降低漏触发概率。若你的工作流里频繁出现资料入库、检索和个人备忘，可先按上文安装到对应 skills 目录，配置 API Key 后，用几条真实任务验证端到端是否可用。
- SkillHub 页面：https://www.skillhub.cn/skills/user_7c82ad18/f212d0b8e8775e6a9b9dd816d43cd08d
- API 资源地址：https://api.skillhub.cn/user_7c82ad18/f212d0b8e8775e6a9b9dd816d43cd08d
