金字塔记忆架构（Pyramid Memory Architecture）

本 Skill 提供一套标准化的 Agent 记忆分层架构，适用于任何新建子 Agent 工作区。 核心理念：规则按触发优先级分层存放，引导只能从上往下，下层不引导回上层。 版本：v2.0 (Market Ready) - 包含一键初始化脚本 + 教学版模板

📐 架构总览

         ▲
        / \
       /   \
      / AGENTS.md \    ← 顶层：系统注入，铁律级行为规则（每次必加载）
     /-----------\
    / MEMORY.md   \    ← 中层：主会话加载，业务规则、触发器、长期记忆
   /---------------\
  /  SOUL.md 等      \  ← 中层：人格配置、心跳清单、身份信息
 /---------------------\
/  self-improving/     \ ← 按需读取：执行经验、错误纠正、领域教训
/-----------------------\
\   SKILL.md/TOOLS.md   / ← 底层：按需读取，技术实现细节、操作流程

各层定位

📝 规则录入铁律

录入原则

1. 按触发优先级引导：
   • 系统注入文件（AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER）> 按需读取文件（HEARTBEAT/memory日志/self-improving）> 外部 SKILL.md
2. 引导方向主要从上往下：
   • ✅ AGENTS.md → 引导去 MEMORY.md / SKILL.md
   • ✅ MEMORY.md → 引导去 SKILL.md
   • ❌ 底层文件不要引导回上层（如 MEMORY.md 不要写"详见 AGENTS.md"）
   • ⚠️ 安全锚：底层文件如果有一条规则和顶层铁律直接相关，可以加备注：⚠️ 此规则与 AGENTS.md 铁律相关，如有冲突以 AGENTS.md 为准
3. 检查冗余时以高层级文件为准：
   • 删除低层级已覆盖的重复内容
   • 低层级只保留自己独有的规则
4. 能引导就引导，实在引导不了再向主人推荐其他写入方式

录入流程

主人要求写入新规则
    ↓
1. 判断规则类型：行为规则 / 业务规则 / 技术细节
    ↓
2. 匹配层级：
   - 行为规则（铁律级）→ AGENTS.md
   - 业务规则（触发器）→ MEMORY.md
   - 人格/身份 → SOUL.md / IDENTITY.md
   - 技术细节 → SKILL.md / docs/
    ↓
3. 检查现有文件有无重复内容：
   - 有重复 → 以高层级为准，删除低层级重复
   - 无重复 → 写入对应文件
    ↓
4. 如不确定放哪层 → 向主人推荐

各层"独有规则"示例

标准引导语格式

统一格式： 详见 [文件/章节名]

AGENTS.md 标准引导表：

## 🔗 其他规则引导

| 类别 | 引导位置 |
|------|----------|
| 记忆系统规则 | 详见 MEMORY.md |
| 心跳检查清单 | 详见 HEARTBEAT.md |
| 群聊发言规则 | 详见 HEARTBEAT.md |
| 技能调用说明 | 详见各 SKILL.md |
| 本地配置 | 详见 TOOLS.md |
| 安全红线 | Red Lines（见下方） |

其他常见引导示例：

• 完整规则详见 docs/temp-tasks.md
• 技术细节详见 SKILL.md「主人规则」第11条
• 自动发布流程详见 SKILL.md「主人标准工作流程」

引导语铁律：

• ✅ 引导只能从上往下（AGENTS → MEMORY → SKILL）
• ❌ 底层文件不要引导回上层（如 MEMORY.md 不要写"详见 AGENTS.md"）
• 引导语要简洁，一行搞定，不要展开详细内容

🔄 冗余检查机制

每 3 天检查一次各 md 文件有无冗余/重复或者可合并内容

检查步骤

1. 读取所有 md 文件内容
2. 对比各层文件，查找：
   • 重复内容：两个文件写了同样的规则
   • 可合并内容：可以精简的相似规则
   • 违规引导：底层文件引导回顶层（如"详见 AGENTS.md"）
3. 以高层级文件为准，删除低层级重复
4. 向主人汇报检查结果，确认后执行清理

检查清单

• AGENTS.md 铁律 vs MEMORY.md 铁律 vs SOUL.md 铁律 — 有无重复？
• 各文件有无引导回上层的情况？
• HEARTBEAT.md / TOOLS.md 有无默认模板未清理？
• MEMORY.md 业务规则有无与 SKILL.md 重复？

🚀 快速部署

方式一：一键初始化脚本（推荐）

• Mac / Linux 用户：

  ./scripts/init.sh my-new-agent
  

• Windows 用户 (PowerShell)：

  .\scripts\init.ps1 my-new-agent
  

方式二：手动初始化

创建新子 Agent 时，按以下结构初始化：

workspace-{name}/
├── AGENTS.md          ← 顶层铁律模板
├── MEMORY.md          ← 中层业务规则模板
├── SOUL.md            ← 中层人格配置模板
├── IDENTITY.md        ← 身份卡片模板
├── USER.md            ← 主人信息模板
├── TOOLS.md           ← 本地配置模板
├── HEARTBEAT.md       ← 心跳清单模板
├── docs/              ← 详细文档目录
└── self-improving/    ← 自我进化目录

📋 模板文件

各层模板详见 templates/ 目录（v2.0 教学版）：

📖 版本历史