SuperAPI AI 工具集

retrieve-memory

智能体与模型

查看项目

更新于 10-15 20:34

技能介绍

用途:在做出非平凡假设前先查记忆。默认规则是:若无法从仓库中引用权威文件、文档或 ADR,就先查阅记忆再行动。记忆模型见 [[mem.concept.doctrine.memory-model]]。

工具偏好:若运行环境支持 MCP 且 doctrine 的 MCP 服务器已连接(工具列表中有 memory_search、memory_retrieve、memory_show、memory_list),优先用这些 MCP 工具而非 CLI;它们返回可机器解析的 JSON 文本,且 memory_show 会补充解析后的反向链接。无 MCP 时回退到 doctrine memory CLI。

主要能力:memory_search 做受范围约束的发现,至少提供一个选择器(path、glob、tag、type 或自由文本),只返回元数据不含正文,行内含 held_back_on_retrieve 标志;自由文本有下限,仅返回有词法或精确键证据的记忆,选择器单独使用时按范围浏览并按严重度排序,默认每页 20 条,用 offset = next_offset(CLI 为 --page)翻页;空结果表示“无匹配”而非“语料为空”。memory_retrieve 对候选做安全上下文召回,强制信任扣留,低信任高严重度记忆会被自动抑制。memory_show 仅在需要完整信息时使用,可用 view: summary 节省 token,被扣留的记忆带警告,不可当作知识消费。memory_list 仅用于浏览/索引。

CLI 表面:doctrine memory retrieve(数据非指令框架、不可绕过的信任扣留)、doctrine memory search(保留风险可见的排序行,用于发现与分诊)、doctrine memory show <UID|KEY>(读单条记忆全文)。图遍历:doctrine memory backlinks <REF> 发现反向边;doctrine memory retrieve --expand N 沿 [[relation]] 边扩展 N 跳;--lifespan 过滤(identity 返回全部,semantic 过滤 episodic/working,procedural 排除 working)。若问题不是记忆形态(答案可能是 ADR、spec、slice、RFC 或待办项),改用 doctrine search <query>,它只查实体语料,默认 kind 集合不含 policies 与 standards,范围与放宽方式见 lib:reference/using-doctrine.md。

流程:先按预期读写的具体文件与即将运行的命令上下文做范围查询(glob 范围记忆同样匹配路径范围,无需额外标志;范围探测为 OR,type/status 为 AND 硬过滤,不要过度过滤);用 --limit 与 --min-trust 调整(min-trust 只升不降默认信任下限);检查风险,若搜索显示相关的高风险或被扣留记忆,先 show 再判断;检索后查看关键记忆的关系并沿边扩展;依赖旧记忆或高严重度记忆前运行 doctrine memory validate <REF> 检查悬空关系、过期验证与草稿失效。

信任与输出:排序已编码严重度、权重、范围具体性与新近度,优先取顶部行;记忆带验证状态,依赖时应定性说明(从未验证、自验证后多次提交则谨慎、近期验证则范围稳定);记忆冲突时不要取平均,应先升级(/consult 或更新/取代过时者)再做重大变更;依据记忆行动时引用其 uid/key 及其指向的来源,并在深读或编辑前先跑范围查询。

限制:资料未提供安装方式、收费、平台支持与具体效果数据。