Agent Skills
返回列表
IMA 笔记与知识库助手

IMA 笔记与知识库助手

知识管理 更新于 2026.08.30

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

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

技能介绍

解决什么问题

在 Agent 工作流里，IMA 的笔记和知识库看起来都是“保存内容”，但 API 对象不同：一篇已有笔记需要 note_id，一个知识库条目需要 media_id，上传文件、关联笔记、添加网页链接也分属不同路径。若直接把用户指令映射成接口调用，容易出现把“记到笔记”误判成“上传到知识库”，或跨模块操作时只读取一个子模块。资料还显示中文内容在 PowerShell 5.1 环境下可能因 GBK 转码而乱码，这类问题不会返回明显错误，但会污染写入结果。

技能如何工作

该技能把 IMA OpenAPI 收敛到统一入口，按 模块决策表 路由到 notes 或 knowledge-base。核心能力包括：

  • notes：搜索笔记、浏览笔记本、获取笔记内容、创建笔记、追加内容；写入前要求 content、title 等字段为合法 UTF-8。
  • knowledge-base：上传文件、添加网页链接、搜索知识库、浏览知识库内容、获取知识库信息和可添加列表。
  • 跨模块任务：如“把知识库内容记到笔记”或“把笔记添加到知识库”，必须先读取两个子模块，再按 KB 读取 -> Notes 写入 或 Notes 搜索 -> KB 关联 的顺序执行。

关键步骤是先检查凭证，再发起 HTTP POST + JSON Body 请求；脚本层会处理程序错误和更新检查，后端返回 code=0 才表示成功。上传文件时 title 必须等于原始文件名，二进制内容保持原样，不做转码。

适用边界

当前资料只覆盖笔记与知识库两类能力，不支持视频文件、Bilibili/YouTube URL 或 file:// 链接。用户未指定新建还是追加时，技能要求先确认意图。遇到 -100 直接展示错误原因，遇到 -200 需要按更新指引处理后重试。

使用场景

  • 在整理会议记录时，把新增结论按标题搜索目标笔记后追加到 IMA 笔记正文。
  • 在沉淀网页资料时，把链接加入指定 IMA 知识库并确认该库可添加状态。
  • 在导出资料时，根据知识库 media_id 定位笔记型条目并读取原文内容。
  • 在上传文档时，保持 PDF 原文件名与二进制内容不变，上传到 IMA 知识库。

适合人员

  • 负责整理 IMA 笔记的运营，需要把零散结论追加到指定笔记。
  • 管理知识库内容的产品助理，需要上传 PDF、网页链接并浏览库内条目。
  • 做资料归档的研究助理，需要从知识库笔记型条目读取原文并导出。
  • 维护自动化 Agent 的工程师，需要按模块路由调用 IMA OpenAPI。