用途:管理 Basic Memory 中实体的状态阶段流转,例如把已完成、已提交、已错过或已取消的条目移出活跃视图,同时保留在知识图谱中。核心原则是归档而非删除,因为删除会连同观察、关系和历史一起从知识图谱消失;只有明显误建(错别字、真正重复)的笔记才可删除。
主要能力:按信号判断状态并执行动作,如 finished/done/completed/shipped 视为完成并移入 archive 或 completed;“paused / on hold / deferred”只更新 frontmatter 状态、保留原位;“restarting / reopening / reviving”移回 active。目录约定可按领域自定义,常见形态为 entities/ 下的 active、archive、pipeline,或 tasks/ 下的 active、completed,关键是保持一致的阶段命名。
使用方式:先多次变换关键词用 search_notes 定位实体,出现多个匹配时列出并确认,找不到则询问而非猜测;再用 move_note 移到目标状态目录,例如 move_note(identifier="tasks/active/quarterly-report", destination_path="tasks/completed/quarterly-report.md");随后用 edit_note 以 metadata 参数合并新状态和完成日期,可配合空内容的 append 只改 frontmatter,必要时用 find_replace 更新 - [status] 观察;最后简要确认移动路径与状态。默认移动后 permalink 不变,链接仍可解析;若项目启用 update_permalinks_on_move,则按新路径重写。
适用场景:条目完成、提交或取消后的归档,恢复误归档条目,周期性清理过期活跃条目。部分完成时不要移动,改为更新观察或状态说明。已归档条目应提示用户。暂停、阻塞等非终态变更通常只更新 frontmatter,文件夹移动留给终态或重大状态转换。
限制与关联:确认信息应简洁;操作有歧义时先询问。可批量处理,但需先找到并确认列表再依次移动。该技能覆盖通用模式,任务专用字段由 memory-tasks 处理;定位实体前可参考 memory-notes 的“先搜索后创建”;memory-defrag 可用于发现应归档的陈旧活跃条目。