OpenSquilla Memory 是一个用于管理 OpenSquilla 持久化记忆的技能。它只使用当前工具列表中可见的工具,本身不会让隐藏工具变得可用,其作用是解释 OpenSquilla 的记忆来源文件。
用途 该技能适用于用户要求记住、回忆、遗忘、更新、搜索或查看持久化 OpenSquilla 记忆的场景,包括 USER.md 中的档案事实以及长期记忆内容。
来源文件 USER.md:保存稳定的用户档案字段,例如姓名、偏好称呼、代词、时区和持久档案备注。应使用可见的文件系统工具编辑,而不是 memory_save。 MEMORY.md:保存经过整理的长期非档案事实、偏好、决策和约束。 memory/YYYY-MM-DD.md 和 memory//*.md:保存每日、会话或命名记忆笔记。 turns//.md:私有自动捕获的回合状态,用于审计或未来处理,不会被普通 memory_search 索引或返回。 Markdown 文件是事实来源。记忆索引/数据库仅从经过整理的 MEMORY.md 和 memory/**/.md 文件派生。
回忆 对于当前用户身份或档案问题,优先使用注入的 USER.md。 对于尚未出现在注入上下文中的历史或非档案回忆,使用 memory_search。 在搜索后需要精确行或更多上下文时,使用 memory_get。
记住或更新 如果用户指定了记忆路径,且该路径是有效的记忆来源文件,则使用该确切路径。 对于档案事实,使用可见的文件系统工具编辑 USER.md。 对于每日或会话笔记,写入 memory/YYYY-MM-DD.md 或其他合适的 memory//*.md 来源。 对于 MEMORY.md 中经过整理的长期事实,先读取当前文件,再写入完整的更新内容。如果 memory_save 可用,对 MEMORY.md 使用 mode='replace',不要追加。 如果 memory_save 可用,仅将其用于 MEMORY.md 或 memory//*.md,绝不用于 USER.md。 如果 memory_save 不可用但文件系统工具可见,则直接编辑或创建相同的来源文件。
遗忘或更正 先搜索,再读取相关文件或行,然后才移除任何内容。 如果 memory_delete 可用,仅在用户想要删除整个记忆来源文件时使用。 要移除或更正单个事实,在文件系统工具可见时直接编辑来源文件。 如果没有可用的写入或删除工具,应报告应更改的确切路径和行,而不是声称记忆已更新。
边界 不要将普通交付物(如报告、JSON 输出或结果文件)存储在记忆来源文件中。 不要保存机密、令牌、私钥或完整凭据内容。 只有在写入或删除成功后,才确认记忆已更新。