前言¶

把资料收进 IMA、写笔记、按关键词找回内容，通常要在客户端和网页之间切换，或者自己对接 IMA OpenAPI、记接口名、管凭证。若希望 Agent 在对话里完成「上传这份 PDF」「把链接放进知识库」「搜一下库里有没有某主题」，需要一层把自然语言意图映射到 IMA 能力的 Skill。

下面介绍 SkillHub 上的 乾穹·知识库助手（坐标 @user_3ef04463/qianqiong-ima，文中亦称 IMA 知识库相关能力）。它把笔记管理与知识库操作收敛到统一的 IMA OpenAPI 技能里，由模块自动路由，不必在对话里背诵具体接口。

这是什么¶

乾穹·知识库助手 是社区来源（community）的 Agent Skill，当前版本 v3.1.4，分类为 knowledge-management，发布者为 user_3ef04463。官方简介概括为：在对话里直接管理 IMA——新建或追加笔记、上传常见文档与图片、收藏网页进知识库、搜索并读回内容；凭证动态获取、不外泄；模块自动路由，不用记接口名。

Skill 带有 requires_api_key=true 标签，表示使用前需要完成与 IMA 相关的 API 凭证配置，具体字段以安装后 Skill 包内 SKILL.md 及说明为准。

在 SkillHub 上，该技能评分 100000，下载 3828 次（数据取自 SkillHub 页面展示，会随时间变化）。

核心功能¶

以下能力均来自官方页面与 Skill 简介，未列出的接口或格式请勿自行假设。

1. 笔记：新建笔记、向已有笔记追加内容；对应用户侧的浏览、创建、编辑笔记意图。
2. 知识库文件：支持上传 PDF、Word、Excel、图片 等到知识库。
3. 网页收藏：将网页添加进知识库，便于后续检索。
4. 检索与读回：在知识库内搜索，并把匹配内容读回对话。
5. 接入方式：统一走 IMA OpenAPI；Agent 按 Skill 内路由选择模块，用户侧用自然语言描述任务即可。

何时应启用此 Skill（与官方触发说明一致）：用户提到知识库、资料库、笔记、备忘录、记事，或要上传文件、添加网页、搜索库内内容、搜索/浏览/创建/编辑笔记时。即未明说「知识库」「笔记」，只要意图是文件进库、网页收藏、库内搜索、个人文档存取（例如「帮我记一下」「搜一下知识库里有没有 XX」），也应走本 Skill。

安装与启用¶

安装流程遵循 SkillHub 通用说明 skillhub.cn/install/skillhub.md。官方页面给出的安装提示为：让 AI 按该文档安装 @user_3ef04463/qianqiong-ima。

1、检查或安装 SkillHub CLI¶

先确认本机是否已有 skillhub：

command -v skillhub && skillhub --version

若未安装，可使用官方安装脚本（完整安装含 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

2、安装本 Skill 到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前 Agent 识别的 skills 目录；装到默认 ./skills/ 可能不会被加载，且部分环境安装后需重启 Agent。

skillhub install @user_3ef04463/qianqiong-ima --dir <skills 目录>

常用路径（摘自 SkillHub 安装文档）：

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

也可在 SkillHub 技能页通过「将提示词发送给你的 AI 安装该 skills」的方式，把坐标 @user_3ef04463/qianqiong-ima 交给 Agent 按上述文档完成安装。

3、API 凭证¶

Skill 标记为需要 API Key（requires_api_key=true）。官方强调凭证动态获取、不外泄；具体配置项与获取步骤以安装后的 Skill 说明为准，本文不臆造环境变量名或密钥格式。

典型用法¶

官方资料未提供固定 Shell 示例，实际使用以对话意图驱动 Agent 调用 Skill 内封装的 IMA OpenAPI。下面几类表述与简介中的能力对应，便于自测是否已正确安装与授权：

1. 记笔记：「新建一条笔记，标题是本周会议纪要，正文先写待办三条。」或「把下面这段话追加到我昨天的项目笔记里。」
2. 入库文件：「把这个 PDF / Word / Excel / 图片上传到 IMA 知识库。」（需 Agent 能访问本地或对话中的文件路径。）
3. 收藏网页：「把这个 URL 加到知识库，方便以后搜。」
4. 检索：「在知识库里搜一下有没有关于 XX 的文档，把相关段落总结给我。」

经过上面的步骤，若 Agent 能完成对应操作并读回库内内容，说明 Skill 路由与凭证配置基本正常。

适用场景与注意¶

适合谁：已在用 IMA 做个人或团队资料沉淀，希望 Cursor、Claude Code、Codex 等带 Skills 的 Agent 在同一对话里完成记笔记、传文件、收网页、库内搜索，而不想手写 OpenAPI 调用链的开发者或重度用户。

限制与注意：

• 依赖 IMA 服务与有效 API 凭证；requires_api_key=true，未配置时 Skill 无法真正访问远端。
• 上传格式以官方列出的 PDF、Word、Excel、图片 为准，其他格式是否支持需以 Skill 包内文档为准。
• SkillHub 安装文档要求 --dir 指向正确目录，否则安装成功但 Agent 不加载。
• 评分、下载量等统计来自 SkillHub 展示，仅作选型参考。

结尾¶

乾穹·知识库助手把 IMA 的笔记与知识库能力收成一条 OpenAPI Skill：对话里完成写入、上传、收藏与搜索，接口路由与凭证由 Skill 侧处理。需要安装或查看详情时，可打开 SkillHub 技能页：

• https://www.skillhub.cn/skills/user_3ef04463/qianqiong-ima
• https://api.skillhub.cn/user_3ef04463/qianqiong-ima