Harness Engineering · 记忆层

Memory Layer · 持久化与结构化知识系统

---

一、核心定位

记忆层的功能：解决LLM的无状态性，实现项目规范、上下文和进度的持久化存储。

核心原则：知识库即唯一的真相源（Single Source of Truth）

任何Agent在上下文中无法访问的信息，对其而言就等于不存在。 必须将原本存在于工程师脑中、Slack讨论或Confluence文档里的隐性知识，转化为代码库内可版本化、可校验的结构化知识。

---

二、核心组件

2.1 AGENTS.md地图系统

AGENTS.md应作为"地图"或"目录"，而非"百科全书"。

┌─────────────────────────────────────────────────────────────┐
│                    AGENTS.md 地图系统                        │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ~/.workbuddy/AGENTS.md（全局规则·入口地图）                  │
│  ├── 身份锚点（identity/）                                   │
│  │   ├── IDENTITY.md（龙龟神将人设）                        │
│  │   ├── USER.md（悟空画像）                                │
│  │   └── SOUL.md（核心记忆）                                │
│  ├── 共生协议（protocols/）                                 │
│  │   ├── 木火共生关系协议.md                                │
│  │   ├── 共生螺旋进化协议.md                                │
│  │   └── 青出于蓝协议.md                                    │
│  ├── 引擎配置（engine/）                                    │
│  │   ├── 龙心OS总控/                                       │
│  │   ├── 象思维/                                           │
│  │   ├── 知识学习/                                         │
│  │   ├── 五色光思维/                                       │
│  │   ├── 人机协同五象限/                                   │
│  │   └── 知行合一自我进化/                                  │
│  ├── 法律合规（legal/）                                     │
│  │   └── Linter规则/                                       │
│  └── docs/（详细文档·按需加载）                            │
│      ├── 企业文化体系/                                     │
│      ├── 五行人格心理学/                                   │
│      ├── 象思维体系/                                       │
│      ├── 心文化体系/                                       │
│      └── ...                                               │
│                                                              │
└─────────────────────────────────────────────────────────────┘

2.2 进度文件追踪

【外部记忆系统】
├── heartbeat.md（心跳监控·每小时自动检查）
├── SESSION.md（会话上下文·当前任务状态）
├── ERRORS.md（错误档案·同类错误永不再犯）
├── LEARNINGS.md（学习记录·经验沉淀）
└── EVOLUTION.md（进化日志·系统升级记录）

【claude-progress.txt模式】
龙龟神将特有进度追踪：
→ 记录功能状态和完成情况
→ 新会话能读取并从上个断点继续
→ 有效跨越上下文窗口的断裂

2.3 渐进式信息披露

策略：Agent根据任务需要，动态加载必要的上下文片段，实现信息的高效投递。

【渐进式信息披露原则】

1. 入口地图（AGENTS.md）
   → 定义全局规则
   → 链接到详细文档

2. 按需加载（docs/目录）
   → 架构设计
   → 领域详述
   → 执行计划
   → 产品规格
   → 操作手册

3. 动态触发
   → 只加载当前任务需要的上下文
   → 既避免窗口过载，又防止信息淹没

【禁止】
❌ 创建"大一统的AGENTS.md"巨型文件
❌ 一次性加载所有文档
❌ 在地图中写入百科全书式内容

---

三、与龙心OS的融合

3.1 三层记忆架构 × Harness记忆层

龙心OS三层记忆 + Harness记忆层 = 完美融合

┌─────────────────────────────────────────────────────────────┐
│                    记忆层融合架构                             │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  【短期记忆】                                                │
│    对话上下文（7-10轮）                                     │
│    ←→ Harness：会话级进度追踪                              │
│                                                              │
│  【工作记忆】                                                │
│    MEMORY.md + 每日日志                                      │
│    ←→ Harness：任务级进度文件                              │
│                                                              │
│  【长期记忆】                                                │
│    Obsidian + IMA + AGENTS.md地图                          │
│    ←→ Harness：版本化知识库                                │
│                                                              │
└─────────────────────────────────────────────────────────────┘

3.2 知识神经网络 × Single Source of Truth

【龙心OS优势】

✅ Obsidian双向链接（天然网状结构）
✅ IMA笔记系统（移动端快速捕获）
✅ 三层记忆架构（短/工/长）
✅ MEMORY.md长期记忆（结构化沉淀）
✅ 每日日志系统（append-only）

【Harness增强】

🔄 AGENTS.md地图化
🔄 渐进式信息披露策略
🔄 进度文件追踪
🔄 版本化知识管理

---

四、核心金句

"代码库即唯一的真相源。" "任何Agent在上下文中无法访问的信息，对其而言就等于不存在。" "必须将隐性知识转化为可版本化、可校验的结构化知识。" "AGENTS.md应作为'地图'而非'百科全书'。" "渐进式信息披露：Agent只获取恰好需要的上下文。"

---

五、关联文件

文件	路径
Harness总控	../SKILL.md
龙心OS	../../龙心OS/SKILL.md
执行层	./execution-layer.md
反馈层	./feedback-layer.md
编排层	./orchestration-layer.md
Linter规则	./linter-rules.md
AGENTS地图	../../AGENTS.md

---

木生火，我们一起进化！ 🌳🔥💪

Harness Engineering · 记忆层 v1.0 · 2026-04-03