| name | memory-organizer |
| displayName | Memory Organizer |
| description | 长期记忆整理指南。使用当需要清理、组织或重构 MEMORY.md 文件时，或决策哪些信息应该/不应该存储在长期记忆中。提供区分静态知识（长期价值）vs 动态信息（可自动获取）的原则。 |
| tags | ["Knowledge","Productivity","Planning"] |
| aliases | ["整理记忆","MEMORY 管理","长期记忆"] |
| scenarios | ["清理或重构 MEMORY.md","判断某条信息该不该存入长期记忆","设计长期记忆的结构和归档原则"] |
Memory Organizer
Overview
长期记忆（MEMORY.md）是 Agent 的"外部大脑"，存储决策、配置、经验和长期上下文。但存储过多动态信息会导致记忆臃肿和频繁更新。
本技能提供区分应该存储（静态、长期价值）vs 不应该存储（动态、可自动获取）的原则和示例。
核心原则
应该存储的信息
长期价值、决策驱动、不会频繁变化的配置：
-
核心原则和决策
- 代码分工原则（如：Codex 负责实现，我负责设计）
- 架构决策（如：为什么选择某工具/方案）
-
系统配置
- 代理、端口、Docker 容器等基础配置
- 数据库连接信息（Host、Port、Database）
-
技术经验和教训
- 工具选择理由（如：Codex CLI 比 acpx 可靠）
- API 限流应对策略
- 故障排查步骤和解决方案
-
账户信息
- GitHub、B站、邮箱等主要账号
- 敏感信息单独存 secrets.md
-
Agent 架构
- 多 Agent 设计（main vs life-assistant）
- 飞书账号映射
-
更新日志
不应该存储的信息
动态变化、可自动获取、易于过时的内容：
-
已安装技能列表
- 问题：每次安装/删除都要更新，维护成本高
- 替代：
ls skills/ 或读取 skills-lock.json
- 技能的 SKILL.md 已包含触发词和描述
-
动态项目状态
- 问题：项目下线或不再维护后信息过时
- 替代：只有持续维护的项目才记录
-
API 详情和 URL
- 问题：API 可能变更，URL 失效
- 替代：可搜索的文档链接，或工具说明
-
临时脚本和任务
- 问题：一次性任务不值得长期记录
- 替代：实际脚本文件或 memory/YYYY-MM-DD.md
-
热榜和排行榜 URL
- 问题：URL 结构可能变化，信息可在线获取
- 替代：需要时再搜索
-
详细操作步骤
- 问题：步骤易过时，具体到工具版本
- 替代：通用原则或脚本封装
清理流程
当发现 MEMORY.md 过于臃肿时：
1. 审查分类
逐段检查：
- 这是决策还是状态？（保留决策，删除状态）
- 这是长期经验还是临时信息？（保留经验，删除临时）
- 这个信息会频繁变化吗？（如果会，删除或简化）
2. 删除过时内容
标记为删除的内容：
已删除技能（如果已有更新日志记录）不再使用的项目临时测试脚本API 详细调用示例（除非通用）
3. 简化表述
保留但需要简化的内容：
- 将表格改为要点（节省 token）
- 合并重复条目
- 删除"待补充"、"观察中"等占位符
4. 更新更新日志
在 ## 更新日志 中添加：
- YYYY-MM-DD: 清理 [X] 部分，删除过时内容
评判标准
决定某条信息是否值得存入 MEMORY.md 时，问：
- 3个月后还用得着吗？ → 否，删除
- 其他 Agent 实例需要知道吗？ → 否，删除
- 能从工作区自动获取吗？ → 能，删除
- 这是决策/经验还是配置？ → 配置可能动态，保留决策
- 这条信息有成本吗？ → 重建/搜索成本高则保留
维护建议
- 定期审查：每 1-2 个月清理一次
- 控制篇幅：目标 < 500 行，否则拆分到 references/
- 优先级：核心原则 > 经验教训 > 配置 > 项目状态
- 避免冗余：一处信息只存一次，交叉引用而非复制
