# Memory Organizer

智能对话分析与记忆整理助手。获取并压缩指定 Agent 的对话记录，用于在用户授权/触发条件满足时，将信息分类写入 USER.md / AGENT.md /...

- Repository: https://github.com/ZHangZHengEric/Sage (1219 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add ZHangZHengEric/Sage --skill memory-organizer -g -a claude-code -y`
Codex: `npx skills add ZHangZHengEric/Sage --skill memory-organizer -g -a codex -y`
Cursor: `npx skills add ZHangZHengEric/Sage --skill memory-organizer -g -a cursor -y`
Gemini CLI: `npx skills add ZHangZHengEric/Sage --skill memory-organizer -g -a gemini-cli -y`

## Description

智能对话分析与记忆整理助手。获取并压缩指定 Agent 的对话记录，用于在用户授权/触发条件满足时，将信息分类写入 USER.md / AGENT.md / MEMORY.md（含索引与 memory/ 日志）/ IDENTITY.md / SOUL.md。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Memory Organizer - 智能对话分析与记忆整理助手

## 目标
本技能用于两件事：
1) **对话压缩**：抓取指定时间范围内的对话，输出“可读且可追溯”的精简版，方便后续判断与提取。
2) **记忆整理（在触发条件满足时）**：将对话中可长期复用的信息，按类型写入正确的记忆文件，形成稳定的个人化与项目化知识库。

> 重要：**默认只做对话压缩，不自动更新任何记忆文件**。只有在用户明确要求/触发条件满足时才进入“记忆整理”。

## 核心原则
- 🎯 **非强制整理**：未触发时只输出压缩对话，不写文件
- 🧭 **按类型入库**：不同信息写入不同文件，避免 MEMORY.md 变成大杂烩
- 🧾 **可追溯**：新增记忆必须标注来源（日期/对话），并尽可能附“证据链接”（文件路径/产物链接/关键引用）
- 🧹 **去重与最小增量**：只新增“稳定、可复用、非一次性”的信息
- 🔒 **隐私优先**：涉及隐私/敏感信息需谨慎；不向外部发送；不将高度敏感信息写入长期索引（例如手机号/家庭住址等）

## 记忆整理范围与写入目标（你提出的 4 类）

### A. 用户习惯/偏好/个人信息 → `USER.md`
**写入内容示例**：
- 沟通偏好（语言、长度、格式、是否要先结论后细节）
- 工作流偏好（macOS、常用 repo、默认目录、命名规则）
- 长期有效的个人信息（称呼、身份、公开可存档信息）

**不写入**：临时状态、一次性偏好、明显会变化的短期安排。

**写入模板（建议）**：
```md
## 新增（来源：YYYY-MM-DD 对话）
- 偏好：...
- 习惯：...
- 个人信息：...
```

### B. 用户对助手的指导/行为约束 → `AGENT.md`
**写入内容示例**：
- 工具使用偏好（优先 CLI、本地优先、并行执行规则）
- 安全边界（破坏性操作前确认、.env/credentials 二次确认等）
- 工作空间规范（目录结构、输出要求、日志规范）

**写入模板（建议）**：
```md
## 会话新增规则（来源：YYYY-MM-DD 对话）
- ...
```

### C. 项目记忆 → `MEMORY.md`（索引） + `memory/`（详情）

#### C1. 写入策略（重要修订）
- `MEMORY.md`：只放“索引级”信息（项目结论、入口链接、关键里程碑），保持精简。
- `memory/YYYY-MM-DD.md`：写“**YYYY-MM-DD 当天实际发生的会话与产出**”的详细结论记录。
  - ✅ **日期含义**：文件名日期 = **当天发生的对话/工作**（而不是“哪天整理的”）。
  - ✅ **覆盖范围**：以当天会话为准；可以跨会话汇总，但不要把“今天做的整理工作”写成“今天发生的事情”。
  - ✅ **写法要求**：必须更详细，包含**结论 + 上下文 + 证据链接 + 影响**，以便复盘与追溯。

#### C2. memory/YYYY-MM-DD.md 的详细模板（必须遵守）
```md
### [PROJECT:项目名] 当天事项标题（YYYY-MM-DD）
- **结论**: 用 1-3 句给出最终结果/决策（可复用口径）
- **上下文**: 为什么做这件事？触发点/需求是什么？关键约束是什么？
- **关键动作**: 只写“对结果有贡献的动作”（不要流水账），可列 3-7 条
- **证据/产物**:
  - 输出文件：[...] (file://...)
  - 关键脚本/代码：[...] (file://...)
  - 关键对话摘录：引用 1-3 条带时间戳的用户原话（可选）
- **影响**:
  - 对用户/项目的价值、后续工作如何衔接
  - 风险/注意事项（如任务 id 漂移、依赖版本等）
- **后续 TODO**（可选）: ...
- **标签**: #tag1 #tag2
```

#### C3. MEMORY.md 索引模板（建议）
```md
## 重要项目
- [PROJECT:项目名] 一句话结论（来源：YYYY-MM-DD）
  - 入口：...（文件链接）
  - 关键变更：...
```

### D. 用户对 Agent 身份/语气/人格的要求 → `IDENTITY.md` 或 `SOUL.md`
**如何区分**：
- `IDENTITY.md`：角色、身份切换规则、对外代表口径、边界定义（“我是谁/如何扮演”）
- `SOUL.md`：表达风格、语气、价值观、长期行为准则（“我怎么说/怎么做”）

The rest: https://github.com/ZHangZHengEric/Sage/blob/HEAD/app/skills/memory-organizer/SKILL.md