memory-logic

name	memory-logic
description	记忆逻辑管理技能 — 基于5条铁律的自动日志、心跳强制检查、长期记忆提炼与记忆架构管理
version	1.0.0
author	嘟嘟 (基于源码解析与社区经验整理)
tags	["memory","heartbeat","audit","logging","best-practices"]

Memory Logic — 记忆逻辑管理

概述

本技能封装了我们从源码、提示词与社区实践中提炼出的 记忆架构与日志管理最佳实践。主要功能包括：

• 每日日志自动追加（memory/YYYY-MM-DD.md）
• 心跳强制检查（HEARTBEAT.md 自动执行 5 条铁律）
• 关键信息定期提炼到长期记忆（MEMORY.md）
• 记忆选择与写入流程（原文不改、靠流程不靠记忆、一次只能写一次）

核心 5 条铁律（必须遵守）

1. 原文即原文 — 不得修改、润色或重构已写入的记忆文件，必须保留原文。
2. 靠流程不靠记忆 — 所有重要决定与状态必须写入文件，不能依赖脑内记忆。
3. 一次只能写一次 — 同一文件一次写入，需要修改时先删除/覆盖再写，不可同时多段写入。
4. 独立验证 — 所有写入操作必须有外部验证或审批步骤，不能凭直觉直接操作。
5. 只记偏好不记代码 — 长期记忆只记录偏好、原则、决策，不记录具体实现或代码细节。

日志与记忆结构

memory/
├── 2026-04-06.md   # 每日日志（自动追加）
├── 2026-04-07.md   # 每日日志（自动追加）
└── ...
MEMORY.md          # 长期记忆（每5次心跳或24小时自动提炼）
HEARTBEAT.md       # 心跳检查清单（每次心跳必须逐项检查）

使用方式

1. 自动执行：本技能会在每次心跳时自动检查 HEARTBEAT.md 的 5 条铁律并记录。
2. 手动触发：调用 scripts/init_memory.py 可手动创建当日日志文件。
3. 长期记忆提炼：每 5 次心跳或超过 24 小时自动运行，将重要的日志条目迁移到 MEMORY.md。

注意事项

• 本技能依赖 OpenClaw 心跳机制，请确保 HEARTBEAT.md 已正确配置。
• 所有写入操作均为 追加（APPEND），不会覆盖已有内容。
• 在升级或重大变更后，系统会自动备份到指定的邮箱（依据配置 credentials.md）。