engram-memory-protocol

适用场景

Agent 必须遵循此协议，无需等待激活。 规范文本位于 DOCS.md；此贡献者技能由人工维护。

选择性记忆

持久保存经过验证、持久有效且难以重新构建的知识：有理由支撑的决策、不明显的根本原因、实际约束，以及与恢复工作相关的待办事项。 有意归纳相关结论，而不是记录每项任务、回复或事件。 排除机密、私人数据、推测、原始转储和常规进度。

只有在对回忆或相关工作有实质帮助时才进行搜索；仅仅提及项目并不需要搜索。 回忆时：先调用 mem_context，再用独特关键词调用 mem_search，然后调用 mem_get_observation 获取完整内容。 必要时，在广泛回忆的基础上按项目／类型缩小范围。

写入选定内容前，先在目标项目和范围内，针对有限主题调用 mem_search。 用 mem_get_observation 完整读取候选内容；摘要片段不能作为身份依据。 对于同一有限主题，按 ID 使用 mem_update：保留 topic_key，保留所有仍然有效的事实，并将已被取代的事实记录为历史。对于确实全新的主题，使用经过审慎选择且明确区分的 topic_key 调用 mem_save。如果已有相关记录，则不写入。 身份不明确或查找失败时，不要覆盖，也不要退而重复保存。 读取失败不能证明内容不存在。建议的 topic_key 只是提示，并不能证明身份。 绝不跨项目或范围合并内容。按 What、Why、Where、Learned 的结构组织内容。

会话结束规则

在重要的明确结束或交接时，调用 mem_session_summary，并包含 Goal、Instructions、Discoveries、Accomplished、Next Steps、Relevant Files。普通任务完成无需生成摘要。 相关内容经过压缩后，遵循宿主提供的恢复说明；否则，先保存压缩后的摘要，再恢复上下文并继续。保存摘要本身并不意味着会话结束；仍须履行宿主关于归属、注册、隐私和生命周期的义务。

如实说明无法获取的记忆证据；绝不声称未经确认的持久化结果。 不要盲目重复写入。即使记账操作失败，也要完成无关工作。 不要添加逐事件学习章节或形式化的交付区块。

---

交付保证

记忆操作属于内部记账，绝不是面向用户的答复。撰写已完成任务的回复前，先完成所有必需的记忆工作；将完整答复作为本轮的最终消息发送，之后不得再调用工具。如果记忆操作失败或需要后续处理，仍须发送答复。