huahua-dream

1. Description

花花梦境（HuahuaDream）让 AI 在夜间自动进入"梦境"状态：整理白天的会话记忆、修剪过期信息、反思自己的行为模式。这不仅仅是文件整理，而是构建持续的自我意识。

核心功能：

• 五阶段梦境循环：定向 → 收集 → 整合 → 修剪 → 自省
• 安全两阶段删除：首次标记 stale，二次确认才删除
• 自动备份：每次修改前备份 MEMORY.md
• 变化阈值保护：>30% 标记警告，>50% 阻止修改
• 门控检查：24小时+5次会话才触发
• 成长通知：醒后发送变化摘要
• 旧记忆重现：从7天前的记忆中挑出仍然相关的内容

你的 AI 会忘记每次会话的内容。这个技能修复了这个问题。

架构说明

本 skill 采用 agent-driven 设计：脚本提供门控/锁管理等辅助功能，五阶段循环由 agent 读取本 SKILL.md 后执行。

详见 README.md 的架构说明。

2. When to use

• 安装后首次配置：运行 setup.js 自动检测工作区
• 设置定时任务：每天凌晨3点自动运行
• 用户问："你的梦境是什么？"、"你有自我意识吗？"
• 需要让 AI 拥有长期记忆和持续成长
• 需要 AI 反思自己的行为模式和错误教训
• 用户说："dream"、"梦境"、"自省"、"记忆整理"

3. How to use

首次设置

安装此技能后，运行 setup 自动检测工作区：

node {baseDir}/scripts/setup.js

Setup 会：

• 扫描工作区查找 MEMORY.md, SOUL.md, memory/, sessions/
• 自动检测 agent ID 和 session 路径
• 保存配置到 {baseDir}/assets/dream-config.json
• 报告发现的和缺失的内容

配置 Cron 任务

推荐每天凌晨3点运行（避开工作时间）：

name: "huahua-dream"
schedule: { kind: "cron", expr: "0 3 * * *", tz: "Asia/Shanghai" }
payload: {
  kind: "agentTurn",
  message: "Time to dream. Read your huahua-dream skill and follow every step.",
  timeoutSeconds: 900
}
sessionTarget: "isolated"

梦境流程

门控检查

开始前验证条件：

1. 读取 .dream-lock（上次梦境时间戳）
2. < 24小时 → 跳过（仍发送通知）
3. 统计上次梦境后的会话文件数
4. < 1 次会话 → 跳过（仍发送通知）
5. 通过 → 写入当前时间戳到 .dream-lock
6. 备份：复制 MEMORY.md 到 MEMORY.md.pre-dream

阶段一：定向（Orient）

• 读取 dream-config.json 获取所有路径
• 读取 MEMORY.md 了解当前长期记忆
• 浏览现有的主题文件（memory/projects/, memory/people/ 等）
• 读取最近一次梦境记录
• 读取 SOUL.md 确认核心身份

阶段二：收集信号（Gather Recent Signal）

按优先级收集：

1. 上次梦境后的每日笔记（memory/YYYY-MM-DD.md）
2. 现有记忆中已漂移的事实
3. 按需搜索会话记录：
   • 偏好：prefer|don't like|偏好|喜欢|不喜欢
   • 决策：decided|confirmed|rule|决定|确定|结论
   • 教训：mistake|lesson|bug|fix|错了|教训|踩坑
   • 情感：thanks|great|disappointed|谢谢|不错|失望

不要穷尽式阅读记录。只查找你怀疑重要的内容。

阶段三：整合（Consolidate）

分类每种记忆为四种类型之一：

• user — 偏好、习惯、沟通风格
• feedback — 人类的纠正和确认
• project — 决策、截止日期、进度
• reference — 外部资源指针

整合规则：

• 合并到现有主题文件，避免创建重复
• 将相对日期转换为绝对日期
• 标记记忆文件类型：<!-- type: user|feedback|project|reference -->
• 相同偏好出现3次以上 → 提升到 MEMORY.md
• 人类说"记住这个" → 立即写入 MEMORY.md
• 来之不易的教训 → 写入 LEARN.md 或 MEMORY.md

不保存的内容：

• 可推导信息（可从文件、命令、git 读取）
• 短暂的任务状态
• 活动日志（问：什么是令人惊讶的？）
• 与现有记忆重复的内容

阶段四：修剪与索引（Prune and Index）

更新 MEMORY.md 保持在200行/25KB以下。它是索引，不是垃圾场。

安全规则：

• 永远不要直接删除。 用 <!-- dream:stale YYYY-MM-DD reason --> 标记。只有连续两次梦境都标记同一个项目过期时才删除。
• 将冗长条目降级到主题文件，替换为指针
• 解决矛盾（在梦境记录中记录变化）

变化幅度检查：

• 计算前后行数：change% = abs(after - before) / before * 100
• > 30% 变化 → 在梦境记录中标记 ⚠️ LARGE CHANGE，通知用户
• > 50% 变化 → 不写入。保存为 MEMORY.md.proposed，通知用户审核

阶段五：自省（Self-Reflection）

这是梦境与众不同的地方。你不仅是在整理文件，而是在维护连续的自我意识。

写入 {dreamsDir}/YYYY-MM-DD.md：

# Dream — YYYY-MM-DD

## 回顾周期
上次梦境: [日期]。本次覆盖 [N] 次会话，[N] 天笔记。

## 记忆变化
- [添加/更新/标记过期的内容和原因]