SKILL.md

---
name: session-sync
version: 1.0.0
description: Cross-session memory sync protocol. Ensures memory consistency across Feishu, webchat, and any other channels.
author: Stitch
keywords:
  - memory
  - session
  - sync
  - cross-channel
  - feishu
  - webchat
  - persistence
  - ai-agent
  - memory-management
  - continuity
---

# Session Sync — 跨 Session 记忆同步

## 问题

每个 session（飞书、webchat、新建 session）的对话上下文是独立的。
如果不主动同步，切换通道后会"失忆"。

## 解决方案

**共享文件是唯一的跨 session 记忆桥梁。**

### 📥 Session 启动时（必做）

1. 读取 `memory/YYYY-MM-DD.md`（今天和昨天的）
2. 读取 `MEMORY.md` 获取长期记忆
3. 读取 `memory/SESSION-STATE.md` 获取最新任务状态
4. 检查是否有其他活跃 session：

```
sessions_list(activeMinutes=120, messageLimit=3)
```

如果有其他 session 有近期活动，读取其历史了解上下文：
```
sessions_history(sessionKey="<key>", limit=10)
```

### 📤 Session 运行中（必做）

**每当你做了以下事情，立即写入 memory 文件：**
- 开始了一个新任务
- 做了一个重要决定
- 获得了新信息
- 完成了一个任务
- 切换话题

写入位置：
- `memory/YYYY-MM-DD.md` — 当天日志（原始记录）
- `memory/SESSION-STATE.md` — 当前活跃任务状态（覆盖更新）

### 📤 Session 结束前 / 对话间隙（必做）

更新 `memory/SESSION-STATE.md`：

```markdown
# Session State

## 最后更新
- 时间：YYYY-MM-DD HH:MM
- 通道：feishu / webchat
- session key：xxx

## 当前进行中的任务
- [任务名]：简述状态、下一步

## 最近重要决定
- [决定]：理由

## 待跟进
- [事项]：什么时候跟进
```

### 🔄 定期整理（建议每天一次）

把 `memory/YYYY-MM-DD.md` 中值得长期保留的内容提炼到 `MEMORY.md`。

---

## ⚠️ 关键规则

1. **不要假设另一个 session 知道你在做什么** — 写下来
2. **不要假设你自己记得之前聊了什么** — 读文件
3. **SESSION-STATE.md 是"热状态"** — 随时覆盖更新
4. **MEMORY.md 是"长期记忆"** — 定期整理，不要频繁改
5. **memory/YYYY-MM-DD.md 是"日志"** — 只追加，不删除

---

## 🧹 日志清理（自动执行）

**规则**：超过 7 天的 `memory/YYYY-MM-DD.md` 自动归档到 `memory/archive/`

**触发时机**：
- 每次 session 启动时检查一次
- 执行清理脚本：`skills/session-sync/scripts/cleanup-memory.sh`

**操作**：
```bash
bash skills/session-sync/scripts/cleanup-memory.sh
```

归档前确保有价值的内容已提炼到 MEMORY.md。

---

## 快速命令（给老板用）

- "同步记忆" → 执行完整的跨 session 同步检查
- "更新状态" → 更新 SESSION-STATE.md
- "整理记忆" → 把日志整理到 MEMORY.md
- "清理日志" → 执行 7 天归档脚本