Update nexus: fix conflicts and sync local changes
This commit is contained in:
Shen Wei
@@ -1,79 +1,79 @@
|
||||
---
|
||||
title: "写入纪律（Write Discipline）"
|
||||
type: concept
|
||||
tags: [openclaw, memory, agentic-ai, best-practices]
|
||||
sources: [养龙虾5天血泪史]
|
||||
last_updated: 2026-04-23
|
||||
---
|
||||
|
||||
## Definition
|
||||
|
||||
写入纪律是指强制 AI Agent 在任务执行过程中将决定、结果和错误主动记录到磁盘的规范。与"读取纪律"（设置文件供 Agent 读取）相对，是确保 Agent 记忆持久化的关键机制。
|
||||
|
||||
## Core Principle
|
||||
|
||||
> "写入纪律比读取纪律更重要"
|
||||
|
||||
大多数人设置文件供 Agent 读取，但从不强制执行写回。如果 Agent 不将决定、结果和错误记录到磁盘，这些东西只存在于上下文窗口中。而上下文窗口会被压缩。
|
||||
|
||||
**写回是临时上下文变成永久记忆的唯一方式。**
|
||||
|
||||
## Three Rules of Write Discipline
|
||||
|
||||
1. **每个任务记录其结果**：任务完成后必须写入 memory/YYYY-MM-DD.md
|
||||
2. **每个错误变成规则**：Agent 犯的错误必须转化为一行规则写入 LEARNINGS.md
|
||||
3. **任何值得记住的内容在压缩前写入**：配置 memoryFlush 确保重要信息存活
|
||||
|
||||
## How to Enforce Write Discipline
|
||||
|
||||
### 1. 启动序列强制指令
|
||||
|
||||
在 AGENTS.md 顶部明确列出写入时机：
|
||||
```
|
||||
开始任何任务前：
|
||||
- 搜索 memory/YYYY-MM-DD.md 获取相关上下文
|
||||
- 检查 LEARNINGS.md 获取此类任务的规则
|
||||
- 完成后立即写入结果
|
||||
|
||||
任务期间：
|
||||
- 如果有重要决定或新信息产生，立即写入 memory/YYYY-MM-DD.md
|
||||
```
|
||||
|
||||
### 2. 交接协议
|
||||
|
||||
在任何模型切换或会话结束前，Agent 将当前上下文写入每日日志：
|
||||
```
|
||||
# Handoff Protocol
|
||||
Before model switch or session end:
|
||||
1. Write current task state to memory/YYYY-MM-DD.md
|
||||
2. Note any pending decisions
|
||||
3. Record what worked and what didn't
|
||||
```
|
||||
|
||||
### 3. 禁止直接写入 MEMORY.md
|
||||
|
||||
> "任务期间永远不要直接写入 MEMORY.md"
|
||||
|
||||
- **每日日志**（`memory/YYYY-MM-DD.md`）：原始且仅追加，Agent 可自由写入
|
||||
- **MEMORY.md**：策划的长期记忆，在定期审查期间（心跳或定时任务）通过提炼每日日志来更新
|
||||
|
||||
让 Agent 向 MEMORY.md 转储任何内容，几周内它就会膨胀成 200 行的混乱。
|
||||
|
||||
## LEARNINGS.md: The Most Underrated File
|
||||
|
||||
> "Agent 犯的每个错误都应该变成一行规则"
|
||||
|
||||
示例：
|
||||
- "在声称代码已推送前永远不要不检查 git 状态"
|
||||
- "不要在群聊中读取完整的 MEMORY.md"
|
||||
- "在安排前始终确认用户的时区"
|
||||
|
||||
这些规则会复合——几周后，Agent 就有了从自己失败中构建的个人操作手册。
|
||||
|
||||
## Connections
|
||||
- [[上下文压缩]] ← 写入纪律防止压缩导致信息丢失
|
||||
- [[上下文刷新]] ← 技术实现写入纪律的手段
|
||||
- [[LEARNINGS.md]] ← 写入纪律的具体存储文件
|
||||
- [[交接协议]] ← 写入纪律在模型切换时的应用
|
||||
- [[养龙虾5天血泪史]] ← 主要来源
|
||||
- [[Self-Improving-Skill]] ← 类似的自改进机制
|
||||
---
|
||||
title: "写入纪律（Write Discipline）"
|
||||
type: concept
|
||||
tags: [openclaw, memory, agentic-ai, best-practices]
|
||||
sources: [养龙虾5天血泪史]
|
||||
last_updated: 2026-04-23
|
||||
---
|
||||
|
||||
## Definition
|
||||
|
||||
写入纪律是指强制 AI Agent 在任务执行过程中将决定、结果和错误主动记录到磁盘的规范。与"读取纪律"（设置文件供 Agent 读取）相对，是确保 Agent 记忆持久化的关键机制。
|
||||
|
||||
## Core Principle
|
||||
|
||||
> "写入纪律比读取纪律更重要"
|
||||
|
||||
大多数人设置文件供 Agent 读取，但从不强制执行写回。如果 Agent 不将决定、结果和错误记录到磁盘，这些东西只存在于上下文窗口中。而上下文窗口会被压缩。
|
||||
|
||||
**写回是临时上下文变成永久记忆的唯一方式。**
|
||||
|
||||
## Three Rules of Write Discipline
|
||||
|
||||
1. **每个任务记录其结果**：任务完成后必须写入 memory/YYYY-MM-DD.md
|
||||
2. **每个错误变成规则**：Agent 犯的错误必须转化为一行规则写入 LEARNINGS.md
|
||||
3. **任何值得记住的内容在压缩前写入**：配置 memoryFlush 确保重要信息存活
|
||||
|
||||
## How to Enforce Write Discipline
|
||||
|
||||
### 1. 启动序列强制指令
|
||||
|
||||
在 AGENTS.md 顶部明确列出写入时机：
|
||||
```
|
||||
开始任何任务前：
|
||||
- 搜索 memory/YYYY-MM-DD.md 获取相关上下文
|
||||
- 检查 LEARNINGS.md 获取此类任务的规则
|
||||
- 完成后立即写入结果
|
||||
|
||||
任务期间：
|
||||
- 如果有重要决定或新信息产生，立即写入 memory/YYYY-MM-DD.md
|
||||
```
|
||||
|
||||
### 2. 交接协议
|
||||
|
||||
在任何模型切换或会话结束前，Agent 将当前上下文写入每日日志：
|
||||
```
|
||||
# Handoff Protocol
|
||||
Before model switch or session end:
|
||||
1. Write current task state to memory/YYYY-MM-DD.md
|
||||
2. Note any pending decisions
|
||||
3. Record what worked and what didn't
|
||||
```
|
||||
|
||||
### 3. 禁止直接写入 MEMORY.md
|
||||
|
||||
> "任务期间永远不要直接写入 MEMORY.md"
|
||||
|
||||
- **每日日志**（`memory/YYYY-MM-DD.md`）：原始且仅追加，Agent 可自由写入
|
||||
- **MEMORY.md**：策划的长期记忆，在定期审查期间（心跳或定时任务）通过提炼每日日志来更新
|
||||
|
||||
让 Agent 向 MEMORY.md 转储任何内容，几周内它就会膨胀成 200 行的混乱。
|
||||
|
||||
## LEARNINGS.md: The Most Underrated File
|
||||
|
||||
> "Agent 犯的每个错误都应该变成一行规则"
|
||||
|
||||
示例：
|
||||
- "在声称代码已推送前永远不要不检查 git 状态"
|
||||
- "不要在群聊中读取完整的 MEMORY.md"
|
||||
- "在安排前始终确认用户的时区"
|
||||
|
||||
这些规则会复合——几周后，Agent 就有了从自己失败中构建的个人操作手册。
|
||||
|
||||
## Connections
|
||||
- [[上下文压缩]] ← 写入纪律防止压缩导致信息丢失
|
||||
- [[上下文刷新]] ← 技术实现写入纪律的手段
|
||||
- [[LEARNINGS.md]] ← 写入纪律的具体存储文件
|
||||
- [[交接协议]] ← 写入纪律在模型切换时的应用
|
||||
- [[养龙虾5天血泪史]] ← 主要来源
|
||||
- [[Self-Improving-Skill]] ← 类似的自改进机制
|
||||
|
||||
Reference in New Issue
Block a user