Memory Curation
当需要治理 butler_main/products/chat/data/ 下的记忆资产时,使用本 skill。
它的目标不是“生成更多记忆”,而是先把现有记忆资产盘清楚,再决定哪些应该保留、归档、去重、清洗或重写。
核心能力
- 盘点
hot/与cold/下的文件数量、体积和最大文件 - 扫描历史遗留路径文本,确认是否还残留
butler_bot_agent/agents/*或旧skills/路径 - 识别明显可疑的编码污染或乱码文件
- 检查
hot/与hot/recent_memory/之间的镜像冗余 - 生成可审阅的 JSON + Markdown 报告
- 在显式允许时,调用已有清洗脚本做 legacy 路径批量重写
入口脚本
./butler_main/platform/skills/pool/ops/memory-curation/scripts/curate_memory.py
标准用法
只做巡检和报告:
& '.venv\Scripts\python.exe' `
'butler_main/platform/skills/pool/ops/memory-curation/scripts/curate_memory.py' `
--workspace '.' `
--output-dir '工作区/memory-curation'
巡检后顺带执行 legacy 路径重写:
& '.venv\Scripts\python.exe' `
'butler_main/platform/skills/pool/ops/memory-curation/scripts/curate_memory.py' `
--workspace '.' `
--output-dir '工作区/memory-curation' `
--rewrite-legacy-paths
产出
工作区/memory-curation/memory_curation_report.json工作区/memory-curation/memory_curation_report.md
工作原则
- 默认只读,先产出报告,再决定是否改写
- 不把
hot和cold混成一锅;要显式区分“热上下文”和“冷沉淀” - 报告中把“事实”与“建议动作”分开
- 发现可疑乱码时,先标注文件与症状,不自动猜测性修复
- 批量清洗路径时,优先复用已有脚本
tools/cleanup_chat_data_legacy_paths.ps1
重点检查项
hot/recent_memory是否仍承担主要热数据真源hot/下是否还存在过时 recent 镜像目录或重复副本cold/local_memory下是否有过大的日志、未归档材料或结构漂移- 历史数据文本中是否仍引用
butler_bot_agent/agents/、legacy skills 路径或已废弃说明 - 是否存在明显 UTF-8/ANSI 错解后的污染文本
注意事项
- 本 skill 的
--rewrite-legacy-paths只做路径文本替换,不负责语义重写。 - 如果要进一步做“记忆归档/合并/去重/重写摘要”,应基于本 skill 报告再执行定向改动,而不是盲目批处理。