Harness Engineering · 记忆层

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

---

一、核心定位

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

---

二、核心组件

2.1 AGENTS.md地图系统

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

2.2 进度文件追踪

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

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

2.3 渐进式信息披露

```markdown 【渐进式信息披露原则】

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

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

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

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

---

三、与龙心OS的融合

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

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

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

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

```markdown 【龙心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*