heldinhow-super-proactive

主动型智能体 + 三层记忆 + WAL 协议 + 任务队列融合架构。

## 概述（中文）

主动型智能体 + 三层记忆 + WAL 协议 + 任务队列融合架构。

## 技能正文

# 超级主动型智能体（Super Proactive Agent）

**面向 AI 智能体的终极「主动 + 记忆」系统。** 将 11 个高分技能的精华融合进一套统一架构。

---

## 为什么选择这个技能？

大多数 AI 智能体只是被动等待提示。这个技能将你的智能体转变为一个主动型伙伴，它能够：
- 在无需被要求的情况下预判需求
- 记住所有重要的事情
- 自主运行后台任务
- 随时间不断进步

---

## 架构概览

```
workspace/
+-- MEMORY.md              # Long-term memory (curated learnings)
+-- SESSION-STATE.md       # Working buffer (HOT - survives flush)
+-- memory/
|   +-- YYYY-MM-DD.md     # Daily logs (episodic)
+-- QUEUE.md              # Task queue (Ready/In Progress/Done)
+-- skills/               # Procedural memory
```

---

## 核心特性

### 1. WAL 协议（预写日志，Write-Ahead Logging）

智能体在响应**之前**先将关键细节写入 SESSION-STATE.md。每一个决策、修正和重要细节都会被立即记录下来。

```bash
# Example: Log a decision
echo "$(date) - Decision: Using model for generation" >> SESSION-STATE.md
```

### 2. 三层记忆系统

- **情景记忆（Episodic）**（memory/YYYY-MM-DD.md）—— 今天发生了什么
- **语义记忆（Semantic）**（MEMORY.md）—— 我所知道的（长期）
- **程序记忆（Procedural）**（skills/）—— 如何做事

### 3. 自主定时任务（Autonomous Crons）

无需提示即可运行后台任务：
- 每 30 分钟：检查队列、健康状态、记忆
- 每 4 小时：研究主题、更新洞见
- 每天 18 点：汇总、清理

### 4. 工作缓冲区

SESSION-STATE.md 能在上下文刷新后保留。在以下场景始终读写此文件：
- 当前项目上下文
- 待定决策
- 活动任务

### 5. 任务队列

QUEUE.md 的状态：
- **Ready** —— 待办任务
- **In Progress** —— 正在处理
- **Done** —— 已完成
- **Blocked** —— 等待中

---

## 快速设置

### 1. 文件结构
在你的工作区中创建这些文件：
```bash
mkdir -p memory/$(date +%Y-%m-%d)
touch SESSION-STATE.md QUEUE.md
```

### 2. 更新 HEARTBEAT.md
```markdown
## Every Heartbeat (~30 min)
- [ ] Check QUEUE.md for Ready tasks
- [ ] Process queue if In Progress empty
- [ ] Verify services

## Every 4 Hours
- [ ] Research topic
- [ ] Update memory

## Daily (18:00 UTC)
- [ ] Summary, cleanup
```

### 3. 记忆优先
在回答之前**始终**先搜索记忆。

---

## 使用示例

### 查看队列
```bash
# Read current queue
cat QUEUE.md
```

### 添加任务
```markdown
## Ready
- Research topic
```

### 记录决策
```bash
echo "$(date) - Decision: Updated configuration" >> SESSION-STATE.md
```

---

## 最佳实践

1. **立即写入** —— 若重要，立刻记录
2. **回答前先搜索** —— 绝不臆测，先搜索记忆
3. **善用会话** —— 用 SESSION-STATE.md 保存工作上下文
4. **精心维护 MEMORY.md** —— 每周回顾每日日志，保留洞见
5. **保持主动** —— 预判需求，而非一味等待

---

## 融合来源

| 技能 | 评分 | 最擅长 |
|-------|--------|----------|
| elite-longterm-memory | 3.617 | 记忆架构 |
| proactive-agent | 3.520 | WAL + 自主定时任务 |
| memory-setup | 3.536 | 配置 |
| memory-hygiene | 3.530 | 清理 |
| agent-autonomy-kit | 3.483 | 任务队列 |
| agent-memory | 3.490 | 智能体记忆 |
| neural-memory | 3.481 | 神经模式 |
| cognitive-memory | - | 类人记忆 |
| proactive-solvr | 3.437 | 问题求解 |
| proactive-tasks | 3.379 | 目标转任务 |
| memory-manager | - | 管理 |

---

## 作者

**Super Proactive** —— 由 Clawdinho 融合的技能
基于 11 个高分 OpenClaw 技能

---

## 版本

**v1.0.0** —— 初始融合版本