Agent Skills
返回列表
🤖

IMA 笔记 ID 自动注册

AI Agent 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_310a65be/ima-note-registry。

技能介绍

要解决的问题

多 Agent 同时向 IMA 写笔记时，note_id 往往只留在各次执行日志、临时脚本或会话记录里。之后如果想确认某条笔记由哪个 Agent 创建、创建时间是什么、标签如何组织，或者要把分散笔记批量补进同一个知识库，就需要反复翻找上下文。这类元数据缺少统一入口，后续检索和归责都会变得困难。

技能如何工作

  • 注册入口：调用 register_note(title, note_id, agent_id, tags?) 后，技能将标题、note_id、agent_id 和可选标签写入共享 registry.json，形成可查询的本地注册表。
  • 知识库同步：注册成功后，技能自动使用 kb_id 调用 IMA OpenAPI 的 import_doc，把笔记写入指定知识库，并将同步状态记录到 registry.log，减少手动补录。
  • 查询能力：get_all_notes() 按创建时间倒序返回全部记录；find_notes(keyword) 对标题或标签做大小写不敏感的模糊匹配；get_notes_by_agent(agent_id) 可按 Agent 维度回溯所有笔记。

使用边界

使用技能需要配置 IMA OpenAPI 的 clientId 和 API Key，可通过环境变量或本地凭证文件提供；IMA_REGISTRY_DISABLED=1 会临时关闭注册行为。知识库同步依赖 IMA 接口返回，接口失败时本地注册仍可能成功，适合先把 note_id 沉淀到共享 registry，再根据 registry.log 排查同步问题。

使用场景

  • 多个 Agent 批量生成 IMA 笔记后，把 note_id 与 Agent 身份写入共享 registry 便于回溯。
  • 按关键词或标签查找已注册笔记，再根据 note_id 执行后续 IMA 操作。
  • 按 agent_id 查看某个 Agent 创建过的全部笔记，核对创建时间和主题。
  • 在 IMA 存档流程中注册笔记，自动同步到指定知识库并检查 registry.log。

适合人员

  • 维护多 Agent IMA 工作流的工程师，需要统一记录各 Agent 产生的 note_id。
  • 负责 IMA 知识库归档的技术运营，需要快速检索已同步笔记的创建者、时间和标签。
  • 调试 IMA OpenAPI 同步失败的开发者，需要查看本地 registry 和同步日志。
  • 编写 Agent 存档流程的自动化负责人，需要把 note_id 注册与知识库同步串起来。