名称: slack-memory-cleanup 描述: AI员工的内存清理和组织技能。提供检测重复、修复错误分类文件以及从内存存储中移除陈旧信息的指南。

内存清理指南

概述

AI员工的记忆会随着时间积累重复、错误分类和过时信息。此技能提供系统化清理记忆的指南和工具。

核心原则:

无硬编码保留期限 - LLM基于上下文判断
配置文件(users/, channels/)遵循1个实体 = 1个文件的原则
不确定时优先保留而非删除

与slack-memory-store技能的集成:

此技能清理由slack-memory-store技能存储的记忆
文件夹结构、元数据模式、type字段一致
遵循配置文件与主题文件的区分原则

快速开始

# 1. 仅分析 (dry-run, 无更改)
python scripts/cleanup_memory.py {memories_path}

# 2. 确认结果后实际清理执行
python scripts/cleanup_memory.py {memories_path} --execute

# 3. 清理后更新索引
python scripts/update_index.py {memories_path}

脚本

此技能提供辅助清理工作的脚本。

cleanup_memory.py - 检测重复/错误分类

扫描记忆文件夹以检测问题。默认仅执行分析(dry-run)。

# 完整分析
python scripts/cleanup_memory.py {memories_path}

# 仅分析特定文件夹
python scripts/cleanup_memory.py {memories_path} --folder users
python scripts/cleanup_memory.py {memories_path} --folder channels

# 详细调试输出
python scripts/cleanup_memory.py {memories_path} --verbose

# 实际清理执行 (移动错误分类文件)
python scripts/cleanup_memory.py {memories_path} --execute

输出示例:

============================================================
📊 记忆清理分析结果
============================================================

## 🔴 重复文件

### users/ 文件夹 (同一人重复)
  email:batteryho@krafton.com:
    - 全智浩 (Jiho Jeon).md (✅ 配置文件)
    - 全智浩 (Jiho Jeon) - 邮件分析.md (📝 工作记录)
    - 全智浩_外部平台邀请_2025-12-08.md (📝 工作记录)

## 🟡 错误分类文件
  全智浩 (Jiho Jeon) - 邮件分析.md
    当前: users/ → 建议: tasks/
    原因: 文件名包含工作关键词
  Jira 票务查询成功.md
    当前: channels/ → 建议: tasks/
    原因: type字段为'task_completed'

## 📈 摘要
  - 重复组: 3个
  - 错误分类文件: 5个

主要检测功能:

配置文件与工作记录区分: 在users/重复中显示哪些文件是配置文件、哪些是工作记录
显示错误分类原因: 提供为何文件被判定为错误分类的原因
利用type字段: 检查元数据的type字段以检测文件夹不匹配

update_index.py - 更新索引

清理后更新index.md。

python scripts/update_index.py {memories_path}

清理工作流

步骤 1: 现状了解

# 查看完整记忆结构
ls -la {memories_path}/

# 统计各文件夹文件数
find {memories_path} -type f -name "*.md" | wc -l

# 文件夹详情
ls -la {memories_path}/users/
ls -la {memories_path}/channels/
ls -la {memories_path}/tasks/

步骤 2: 问题检测

通过脚本或手动检测以下问题:

重复文件 - 同一实体分散在多个文件中
错误分类 - 文件夹与内容不匹配
临时信息 - 过时且重要性低的文件

步骤 3: 清理执行

根据检测问题采取适当措施:

重复 → 合并 (参考deduplication-rules.md)
错误分类 → 移动 (参考misclassification-rules.md)
临时 → 删除 (参考cleanup-patterns.md)

步骤 4: 更新索引

清理后必须更新索引:

python scripts/update_index.py {memories_path}

核心清理目标

1. users/ 文件夹

正常状态: 每人1个文件 (配置文件)

users/
└── 全智浩 (Jiho Jeon).md    ← 仅配置文件

问题状态: 一人有多个文件

users/
├── 全智浩 (Jiho Jeon).md              ← 配置文件 (保留)
├── 全智浩 (Jiho Jeon) - 邮件分析.md  ← 移动到 tasks/
├── 全智浩 - AI报告.md               ← 移动到 tasks/ 或 misc/
└── Serin_Kim_金世琳.md                 ← 与现有金世琳文件合并

判断标准:

email或user_id相同则为同一人
仅保留1个配置文件在 users/
其余根据内容移动到适当文件夹

2. channels/ 文件夹

正常状态: 每频道1个文件 (以频道ID开头)

channels/
└── C08G76BB8JK_my-daily-scrum.md    ← 频道配置文件

问题状态: 非频道信息文件

channels/
├── C08G76BB8JK_my-daily-scrum.md      ← 保留
├── Jira 票务查询成功.md              ← 移动到 tasks/
└── 邮件查询工作成功.md              ← 移动到 tasks/

判断标准:

有channel_id且为频道指南/信息则保留
工作结果、成功案例等移动到 tasks/

3. tasks/ 文件夹

正常状态: 每工作1个文件

tasks/
├── KIRA 项目工作完成 - 2025-11-25.md
└── Tableau 数据查询 - 2025-12-09.md

问题状态: 相似内容重复

tasks/
├── 7个_邮件_分析_2025-12-08.md     ← 删除 (有更完整版本)
├── 8个_邮件_分析_2025-12-08.md     ← 删除
├── 9个_邮件_分析_2025-12-08.md     ← 删除
└── 10个_邮件_分析_2025-12-08.md    ← 保留 (最终版本)

判断标准:

同一工作的中间结果 → 仅保留最终版本
同日期相似标题 → 仅保留最完整的

4. 其他文件夹

文件夹	清理标准
`projects/`	完成项目 → 可移动到 archive/
`decisions/`	重要，长期保留
`meetings/`	过时 → 可摘要后删除
`misc/`	优先清理，过时删除
`external/news/`	时间久后价值下降，可删除
`announcements/`	过时公告可删除

重要性判断 (LLM标准)

无硬编码保留期限，LLM基于以下考虑判断。

应保留的

配置信息 (users/, channels/)
决策记录 (decisions/)
进行中项目 (projects/)
最近互动相关信息

可删除的

中间成果 (有最终版本时)
过时日常对话 (misc/)
已过时新闻/公告
重复信息

判断时考虑因素

最后修改日期 (updated 元数据)
相关项目状态 (进行中 vs 完成)
文件间连接关系 (related_to)
标签重要性 (urgent, important等)

清理执行示例

示例 1: users/ 重复清理

请求: "清理users文件夹"

1. 现状了解
   - 发现全智浩相关文件6个
   - 发现金世琳相关文件2个

2. 分析
   - 全智浩: 配置文件1个 + 工作记录5个
   - 金世琳: 同一人不同名称2个

3. 执行
   - 全智浩工作记录 → 移动到 tasks/
   - 金世琳文件 → 合并后仅保留1个

4. 结果报告
   "users/ 清理完成:
    - 全智浩: 5个文件移动到 tasks/
    - 金世琳: 2个文件合并为1个"

示例 2: 完整记忆清理

请求: "清理完整记忆"

1. 现状了解
   - 总文件数120个
   - users/: 47个 (怀疑重复)
   - tasks/: 40个 (怀疑重复)
   - channels/: 10个 (怀疑错误分类)

2. 各文件夹分析及清理

3. 结果报告
   "记忆清理完成:
    - 删除: 15个 (重复/中间结果)
    - 移动: 8个 (错误分类修正)
    - 合并: 5个 (同一人重复)
    - 当前总: 97个文件"

安全指南

删除前确认

重要文件删除前向用户确认
删除decisions/, projects/时尤其小心
不确定时优先移动而非删除

建议备份

大量清理前建议备份
cp -r {memories_path} {memories_path}_backup_{date}

回滚可能性

记录删除文件列表
记录移动文件原位置

参考文档

详细规则请参考以下文档:

cleanup-patterns.md - 清理模式及LLM判断标准
deduplication-rules.md - 重复检测及合并规则
misclassification-rules.md - 错误分类检测及移动规则