金字塔记忆架构 -> 記憶金字塔架構

金字塔记忆架构（Pyramid Memory Architecture） 本 Skill 提供一套标准化的 Agent 记忆分层架构，适用于任何新建子 Agent 工作区。 核心理念：规则按触发优先级分层存放，引导只能从上往下，下层不引导回上层。 版本：v2.0 (Market Ready) - 包含一键初始化脚本 + 教学版模板 架构总览 ▲ / \ / \ / AGENTS.md \ ← 顶层：系统注入，铁律级行为规则（每次必加载） /-----------\ / MEMORY.md \ ← 中层：主会话加载，业务规则、触发器、长期记忆 /---------------\ / SOUL.md 等 \ ← 中层：人格配置、心跳清单、身份信息 /---------------------\ / self-improving/ \ ← 按需读取：执行经验、错误纠正、领域教训 /-----------------------\ \ SKILL.md/TOOLS.md / ← 底层：按需读取，技术实现细节、操作流程

各层定位 层级 文件 加载方式 内容定位 顶层 AGENTS.md 系统级注入，每次必加载 铁律级行为规则、安全红线、引导表 中层 MEMORY.md 主会话系统注入 业务触发规则、长期记忆、项目规则 中层 SOUL.md 系统级注入 人格、身份、使命、行为准则 中层 HEARTBEAT.md 心跳触发时加载 待办提醒、报告队列、周期性检查清单 中层 IDENTITY.md 系统级注入 Agent 身份卡片（名字、形象、表情） 中层 USER.md 系统级注入 主人信息、作息、偏好 中层 TOOLS.md 系统级注入 本地配置笔记（设备、端口、Cookie） 按需读取 self-improving/ 任务前主动读取 执行经验、错误纠正、领域教训（memory.md / domains/ / projects/ / corrections.md） 底层 SKILL.md 匹配场景时读取 技术实现、操作流程、选择器、正则 底层 docs/*.md 按需读取 详细操作文档、临时任务规则等

规则录入铁律 录入原则 按触发优先级引导： 系统注入文件（AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER）> 按需读取文件（HEARTBEAT/memory日志/self-improving）> 外部 SKILL.md 引导方向主要从上往下： AGENTS.md → 引导去 MEMORY.md / SKILL.md MEMORY.md → 引导去 SKILL.md 底层文件不要引导回上层（如 MEMORY.md 不要写"详见 AGENTS.md"） 安全锚：底层文件如果有一条规则和顶层铁律直接相关，可以加备注：此规则与 AGENTS.md 铁律相关，如有冲突以 AGENTS.md 为准

检查冗余时以高层级文件为准： 删除低层级已覆盖的重复内容 低层级只保留自己独有的规则 能引导就引导，实在引导不了再向主人推荐其他写入方式

录入流程 主人要求写入新规则 ↓

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

各层"独有规则"示例 层级 应该放什么 不应该放什么 AGENTS.md 先回答再操作、禁止未确认执行、规则录入引导、3天检查冗余 详细 Heartbeat 说明、群聊详细规则、Memory 详细说明 MEMORY.md 推送渠道规则、业务触发器、项目专属规则、同步规则 Cookie 保护铁律（应放 AGENTS.md）、技术选择器 SOUL.md 人格描述、使命、能力设定、行为准则、底线 通用行为铁律（应放 AGENTS.md） HEARTBEAT.md 待办提醒、报告队列、检查项 推送规则详情（应引到 MEMORY.md） SKILL.md 技术选择器、正则、API 流程、版本历史 行为规则、人格描述

标准引导语格式 统一格式：详见 [文件/章节名] 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 文件有无冗余/重复或者可合并内容 检查步骤 读取所有 md 文件内容 对比各层文件，查找： 重复内容：两个文件写了同样的规则 可合并内容：可以精简的相似规则 违规引导：底层文件引导回顶层（如"详见 AGENTS.md"） 以高层级文件为准，删除低层级重复 向主人汇报检查结果，确认后执行清理

检查清单 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 教学版）： 模板 路径 说明 AGENTS.md templates/AGENTS.md 顶层铁律模板（带使用说明注释） MEMORY.md templates/MEMORY.md 中层业务规则模板（带示例） SOUL.md templates/SOUL.md 中层人格配置模板（带安全锚示例） IDENTITY.md templates/IDENTITY.md 身份卡片模板 USER.md templates/USER.md 主人信息模板 TOOLS.md templates/TOOLS.md 本地配置模板 HEARTBEAT.md templates/HEARTBEAT.md 心跳清单模板

版本历史 版本 日期 变更 v2.0 2026-05-21 Market Ready 发布：①新增 scripts/init.sh 一键初始化脚本；②升级 templates 为“教学版”，内含详细使用说明；③补全 self-improving 目录结构 v1.3 2026-05-21 消除重复铁律+补充执行机制：