什么是ima skills
ima skills 是一组围绕 IMA OpenAPI 封装的统一技能，重点处理个人笔记与知识整理相关的操作。按证据包给出的范围，它覆盖的核心对象是“笔记”和“笔记本”，既能查找、浏览、读取已有内容，也能新建笔记或向既有笔记追加文本。对用户来说，这类能力对应的往往是日常工作里最常见的几个动作：找一篇旧记录、看某个笔记本里最近写了什么、把一段材料存成新笔记，或者把补充内容续写到原来的文档里。
从接口设计看，这个技能并不是单一的“记事”入口，而是一套比较完整的笔记管理能力。读取侧包括按标题或正文搜索、列出笔记本、浏览某个笔记本下的笔记，以及读取指定笔记正文；写入侧则区分为“新建一篇笔记”和“向已有笔记追加内容”两类操作。证据包对这一区分写得很严格：凡是“新建”“创建”“写一篇”这样的明确表达，应当直接创建新笔记；凡是“追加到”“在末尾加上”这类说法，才进入追加流程，而且如果目标笔记不明确，必须先确认，不能自行猜测。
这套技能的另一个特点是对隐私和风险边界有清楚约束。笔记正文被视为用户隐私，在群聊场景中只能展示标题和摘要，不能直接展示正文；展示笔记列表时也只应给出标题、摘要和修改时间。写入时同样有明确限制，接口当前只接受纯文本或 Markdown 形式的文本内容，且实际写入仅支持 Markdown，不支持把本地图片直接塞进笔记里；如果内容里夹带了本地图片路径，需要先过滤，再提醒用户相关图片未被写入。也就是说，它更适合做结构化的文字积累、检索和整理，而不是多媒体笔记同步工具。
核心功能特点
- 同时覆盖笔记搜索、笔记本浏览、正文读取、新建笔记和追加内容，笔记管理链路比较完整
- 支持按标题检索和按正文检索，查找旧资料时可以从关键词或笔记主题两个入口切入
- 把“新建”与“追加”明确分开，已有笔记的修改要求先锁定目标，能减少误写和误改
- 读取与展示遵循隐私约束，群聊中只展示标题和摘要，不直接暴露笔记正文
- 采用游标分页和偏移分页处理笔记本、笔记列表与搜索结果，适合逐步浏览较多内容
- 写入结果会返回唯一 doc_id，便于后续继续补充同一篇笔记或进行再次读取
适用场景
如果把它放进日常办公场景，ima skills 最适合处理“资料散、记录多、需要随时回看”的工作流。比如开完会后，用户想找上周写过的《会议纪要》，可以先按标题搜索，再读取对应正文；如果只记得其中提过“项目排期”这类词，也可以按正文搜索。对于有明确归档习惯的人，还能先查看笔记本列表，再进入某个笔记本继续浏览其中的笔记。它在这里承担的是一个统一入口：先缩小范围，再定位内容，而不是让用户自己在多层目录里手动翻找。
在个人知识积累和备忘记录场景里，这个技能也很实用。用户可以把新的想法、待办梳理、阅读记录或零散素材新建成一篇笔记，也可以在已有主题下持续追加后续内容，例如持续补充一份长期维护的项目记录。证据包特别强调，涉及追加时必须明确目标笔记，这意味着它更适合那些已经形成标题、主题或归档习惯的用户：先确定记录要落到哪里，再把新增内容写进去，避免把材料误加到不相干的文档中。
它同样适用于对内容合规和展示边界有要求的场合。因为笔记正文被定义为用户隐私，在群聊里只能展示标题和摘要，这使得它更适合作为“帮用户找到哪一篇”的工具，而不是在多人环境里直接展开私人记录全文。再加上写入只支持文本和 Markdown、本地图片会被过滤，这也决定了它更偏向文字型知识管理、会议记录、备忘整理、资料索引等场景。对于需要大量插入本地图像、直接做富媒体文档保存的需求，这套能力并不是重点方向；但如果目标是把个人笔记查得快、存得稳、追加时不出错，它提供的规则和边界反而比较清晰。