bagua-memory

SKILL.md

---
name: bagua-memory
description: >
  八卦记忆系统 (Bagua Memory) - AI Agent 记忆管理框架。
  将记忆按八个维度（规则/知识/热记忆/决策/事件/关联/归档/偏好）分类存储，
  通过生命周期自动衰减和卦变关联联想检索。
  
  使用场景：
  (1) 为 AI Agent 建立结构化的长期记忆系统
  (2) 管理 workspace 中的记忆文件（memory/ 目录）
  (3) 记忆的写入、归档、压缩、检索
  (4) 用户提到"记忆系统"、"bagua"、"八卦"、"长期记忆"、"归档记忆"
  (5) 需要从对话中提取关键信息并持久化存储
  (6) 定期维护和整理记忆文件
---

# 八卦记忆系统

基于文件的记忆管理框架，零依赖，适用于任何能读写本地文件的 AI Agent。

详细架构见 [references/architecture.md](references/architecture.md)（权威来源：`memory/bagua/README.md`）。

## ⚡ 自激活（首次触发必做）

**检测条件**：如果 `AGENTS.md` 或 `SOUL.md` 中不存在 `## 记忆规则` 章节，说明尚未激活。

**激活步骤**：
1. 运行 `bash scripts/init_bagua.sh .`（在 workspace 根目录，自动创建 memory/ 和 MEMORY.md）
2. 读取 `references/soul-inject.md`，将其内容追加到 `AGENTS.md`（或 `SOUL.md`）末尾
3. 如果 `HEARTBEAT.md` 存在，将 `references/heartbeat-inject.md` 追加进去
4. 告知用户："八卦记忆系统已激活 ✅"

## 核心流程

### 写入记忆

1. 新信息按归类指南判断所属卦位
2. 写入对应 `memory/bagua/<卦位>/` 下的 Markdown 文件
3. 文件命名：`YYYY-MM-DD.md`（时间线类）或按主题命名

### 检索记忆（渐进式）

1. **L0**：读 `MEMORY.md`（索引+归类指南）
2. **L1**：根据话题读 1-2 个相关卦位
3. **L2**：复杂检索时读 `memory/bagua/README.md`（卦变关联表）

### 记忆维护

1. **归档**：离卦超过 7 天 → 移入艮卦
2. **压缩**：艮卦超过 30 天 → 摘要化
3. **恢复**：归档记忆再次被引用 → 升回原卦位

## 八卦速查

| 卦 | 目录 | 存什么 | 边界 |
|---|------|--------|------|
| ☰ 乾 | `qian/` | 系统规则、行为准则 | - |
| ☷ 坤 | `kun/` | 知识库、事实 | 相对稳定的信息 |
| ☲ 离 | `li/` | 近期新发现 | 只放"新东西"，不放对话总结 |
| ☵ 坎 | `kan/` | 决策推理 | 只记"为什么"（reason） |
| ☳ 震 | `zhen/` | 事件时间线 | 只记"发生了什么"（fact） |
| ☴ 巽 | `xun/` | 关联网络 | 人/项目/概念关系 |
| ☶ 艮 | `gen/` | 归档记忆 | 冷却中的旧记忆 |
| ☱ 兑 | `dui/` | 用户偏好 | 风格、习惯、情感 |

## 与 MEMORY.md 的关系

`MEMORY.md` 是入口（L0），记忆本体在 `memory/bagua/` 各卦位下。