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

IMA 知识库与笔记

知识管理 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_aa25c9ca/crab-skills。

技能介绍

要解决什么问题

个人知识往往分散在「随手记一条」和「长期资料库」两条线:前者是笔记、备忘录,后者是 PDF、网页收藏和可检索文档。若模型只能泛泛回答「你可以去 IMA 里找」,却无法通过 OpenAPI 真正读写,对话里的「帮我记一下」「知识库里有没有 XX」就落不了地。

本技能把 IMA OpenAPI 收敛成同一套调用约定,在对话中处理笔记管理与知识库操作,而不是各说各的接口名。

技能如何工作

触发意图包括但不限于:知识库/资料库、笔记与备忘、上传文件、添加网页到知识库、搜索库内内容,以及笔记的浏览、创建与编辑。即使用户没直说「知识库」,只要意图是收藏网页、上传文档或检索个人资料,也应走这条技能路径。

当前能力面集中在两类资源:

  • 笔记(notes):创建、编辑、追加与检索个人记事。
  • 知识库(knowledge-base):文档导入、内容搜索与资料组织。

写入笔记时,技能侧会强调若干硬规则,避免不可逆的数据损坏:

  • 调用 import_doc / append_doc 前,content、title 等字符串字段必须是合法 UTF-8;非 UTF-8 会导致乱码且难以恢复。
  • 文件上传时 title 必须与 file_name(含扩展名)一致,不得擅自改名、截断或翻译原文件名。
  • 二进制文件(PDF、图片、Excel 等)上传时保持原字节,不做编码转换。

在 PowerShell 5.1 环境下,还需在首次 API 调用前识别版本,并用 UTF-8 字节数组方式发 Body,否则请求体会被静默转成 GBK。

适用边界与注意点

以下场景应直接拒绝并给出明确说明,而不是让用户「要不要试试」:

  • 视频文件、Bilibili/YouTube 链接、file:// 本地路径等 不支持的类型;可提示改用 IMA 桌面客户端处理。

技能描述中的内部标识为 ima-skill,与 SkillHub 上的包名 crab-skills 并存——安装与引用以清单中的规范名 @user_aa25c9ca/crab-skills 为准,能力语义以 OpenAPI 的笔记与知识库操作为准。

使用场景

  • 研究资料分散在多份 PDF,需要在对话里直接上传到 IMA 知识库并保留原文件名
  • 写会议结论时让模型追加到已有 IMA 笔记,而不是只在聊天窗口里复述一遍
  • 整理竞品网页链接时,要求把指定 URL 收藏进知识库并在库内检索是否已有同类条目
  • 临时想到要点时说「帮我记一下」,由技能创建或编辑 IMA 笔记且保证 UTF-8 正文不乱码

适合人员

  • 用 IMA 做个人资料库、常把 PDF 与网页收进库内再全文检索的研究与写作者
  • 在对话里维护项目备忘,需要浏览、创建、编辑 IMA 笔记的产品经理或项目负责人
  • 把 OpenAPI 接到 Agent 工作流里,要统一走笔记与知识库读写而非手写多套接口的集成开发者
  • 在 Windows PowerShell 5.1 环境调用 IMA 接口、需规避 GBK 静默转码导致写入失败的运维或脚本作者