Agent Skills
返回列表
Nick IMA 知识助手

Nick IMA 知识助手

知识管理 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

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

技能介绍

要解决的问题

IMA 的笔记和知识库操作分散在多个接口里，直接调用容易踩坑：文本写入可能因编码问题变成乱码，PowerShell 5.1 会静默把请求体转成 GBK，知识库上传又要求文件名原样保留、二进制文件不转码，并且 notes 与 knowledge-base 的路由边界容易混淆。这个技能把接口约束整理成可执行规则，减少误路由和不可逆的数据污染。

技能如何工作

  • 笔记模块：搜索笔记、浏览笔记本、获取笔记内容、创建笔记、追加内容，核心 API 包括 import_doc 和 append_doc。
  • 知识库模块：上传文件、添加网页链接、搜索知识库、浏览知识库内容、获取原文信息，常见路径包括 create_media、add_knowledge 和 get_media_info。
  • 路由规则：目标是笔记内容时走 notes；目标是知识库条目、上传文件或添加链接时走 knowledge-base；跨模块任务需要先读取两个子模块，再按顺序执行。
  • 编码约束：调用 notes 写入类 API 前，必须确认 content 和 title 为合法 UTF-8；上传二进制文件时保持原内容，不做编码转换。
  • 运行检查：调用前检查 ~/.config/ima/client_id 与 ~/.config/ima/api_key，请求统一 POST 到官方 IMA 接口，并区分脚本层 -100、-200 错误和后端业务 code 错误。

使用场景

  • 把会议记录整理成 IMA 笔记，并追加到已有笔记本中的指定笔记。
  • 将本地 PDF、网页链接加入知识库，再搜索相关条目并查看原文。
  • 把知识库中的笔记型条目关联到知识库，或从知识库读取内容写入新笔记。
  • 在 PowerShell 5.1 环境调用 IMA 接口前校验 UTF-8 请求体与凭证。

适合人员

  • 维护 IMA 笔记流的运营，需要批量搜索、创建和追加指定笔记本中的笔记。
  • 管理知识库资料的知识工程师，需要上传文件、添加网页链接并检索原文。
  • 在 Windows PowerShell 环境集成 IMA API 的后端工程师，需要规避 GBK 乱码。
  • 负责 Agent 工具链的自动化工程师，需要按 notes/knowledge-base 路由调用接口。