Nick小助手:用一条 Skill 对接 IMA 笔记与知识库

前言

在 Agent 里做个人知识管理,常见做法是各写一套工具说明,或让用户每次手动说明「去哪个 API、带什么参数」。笔记和知识库往往是两套入口:搜资料、存网页、改备忘录,触发词也不统一。下面介绍 SkillHub 上的 Nick小助手(坐标 @user_6b3ace61/nick):它把 IMA OpenAPI 下的笔记管理与知识库操作收进同一个 Skill,由 Agent 按用户意图自动选用,减少重复配置。

这是什么

Nick小助手 是社区来源(community)的 knowledge-management 类 Skill,当前版本 1.0.0,发布者为 user_6b3ace61。官方简介将其定位为「统一的 IMA OpenAPI 技能」,面向两类能力:

  • 笔记:搜索、浏览、创建、编辑;
  • 知识库:上传文件、添加网页、搜索库内内容。

SkillHub 页面标注 requires_api_key=false(标签层面不要求 API Key);具体运行时是否还需 IMA 侧鉴权,以 Skill 包内说明为准,本文不展开未在公开页出现的配置字段。

核心功能

以下能力均来自 SkillHub 与 API 元数据中的简介,未单独列出底层接口名,安装后以 Skill 内 SKILL.md 及工具定义为准。

  1. 知识库:向知识库上传文件;将网页加入知识库;在知识库内搜索内容。
  2. 笔记:对笔记进行搜索、浏览、创建、编辑。
  3. 意图触发:除明确提到「知识库」「资料库」「笔记」「备忘录」「记事」外,下列口语也应触发本 Skill——例如「帮我记一下」「搜一下知识库里有没有 XX」、网页收藏、个人文档存取、把文件放进知识库等,即使用户未说出「知识库」或「笔记」二字。

安装与启用

Skill 基于通用 SKILL.md 格式。在 SkillHub 上可通过两种方式安装。

方式一:让当前 Agent 按官方安装说明执行

将下列意图发给 AI(SkillHub 页面提供的标准提示):

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_6b3ace61/nick`。

方式二:使用 SkillHub CLI

先确认本机是否已有 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

安装 Nick小助手时,必须用 --dir 指向当前 Agent 的 skills 目录;默认装到 ./skills/ 可能不会被识别。Cursor 常用路径为:

skillhub install user_6b3ace61/nick --dir ~/.cursor/skills/

其他客户端路径(摘自 SkillHub 安装文档):Claude Code 为 ~/.claude/skills/;Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。装好后按所用客户端要求重启或刷新 Skill 列表。

典型用法

公开资料未给出固定 curl 或代码示例,触发方式以自然语言为主。下列表述与官方简介一致,可用于验证 Skill 是否被正确选中:

用户意图(示例) 预期走向
「把这份 PDF 上传到知识库」 知识库文件上传
「把这个网页收藏进资料库」 知识库添加网页
「搜一下知识库里有没有关于 XX 的文档」 知识库搜索
「帮我记一下:明天十点开会」 笔记创建
「打开我最近写的备忘录改一段」 笔记浏览 / 编辑

经过上面的步骤安装并启用后,在对话中直接使用上述句式即可,由 Agent 加载本 Skill 后调用 IMA OpenAPI 侧封装好的能力。

适用场景与注意

适合谁

  • 已在使用或计划使用 IMA 生态做笔记与个人知识库,并希望 Cursor、Claude Code、Codex 等 Agent 用统一 Skill 处理「记、搜、传、收藏」。
  • 希望减少为「知识库 vs 笔记」分别维护两套 Skill 或提示词的成本。

需要注意

  • 版本与元数据以 SkillHub 为准:当前 v1.0.0,分类 knowledge-management;页面展示的评分与下载量会变动,撰写时 SkillHub 记录为评分 100000、下载 818 次(与用户线索中的数字不一致时,以 SkillHub 页面为准)。
  • 安装目录错误是常见坑:务必 skillhub install ... --dir <当前 Agent 的 skills 目录>。
  • 本文未核实 IMA OpenAPI 的账号开通、配额与网络策略;若调用失败,应先查 Skill 包内说明与 IMA 官方文档,而非假定仅需本地 Skill 文件。

结尾

Nick小助手把 IMA 的笔记与知识库操作收敛到一个 Skill 坐标 @user_6b3ace61/nick,用统一的触发语义覆盖上传、收藏、搜索和备忘录类需求。需要查看简介与安装提示时,可打开 SkillHub 页面:

  • SkillHub:https://www.skillhub.cn/skills/user_6b3ace61/nick
  • API 元数据:https://api.skillhub.cn/user_6b3ace61/nick
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye