Refine memory management SOP for L3 SOP/util rules

This commit is contained in:
Liang Jiaqing
2026-02-01 16:09:05 +08:00
parent f0ccb7dfb9
commit da10ba404b

View File

@@ -3,7 +3,6 @@ L1: global_mem_insight.txt (极简索引层 - 严格控制 ≤50 行)
L2: global_mem.txt (事实库层 - 现短但会膨胀) L2: global_mem.txt (事实库层 - 现短但会膨胀)
↓ 详细引用 ↓ 详细引用
L3: ../memory/ (记录库层 - 包含 .md/.py 等各类文件) L3: ../memory/ (记录库层 - 包含 .md/.py 等各类文件)
```
--- ---
@@ -27,7 +26,6 @@ L3: ../memory/ (记录库层 - 包含 .md/.py 等各类文件)
**职责**:存储全局环保性事实(路径、凭证、配置等)。 **职责**:存储全局环保性事实(路径、凭证、配置等)。
**特征** **特征**
- 现状:约 20 行(精简)
- 趋势:随环境扩展而膨胀(可接受) - 趋势:随环境扩展而膨胀(可接受)
- 内容:按 `## [SECTION]` 组织的事实条目 - 内容:按 `## [SECTION]` 组织的事实条目
- 同步:变化时更新 L1 的相应 TOPIC 导航行 - 同步:变化时更新 L1 的相应 TOPIC 导航行
@@ -49,6 +47,19 @@ L3: ../memory/ (记录库层 - 包含 .md/.py 等各类文件)
- 维护日志、过程记录 → L3 maintenance_log.md - 维护日志、过程记录 → L3 maintenance_log.md
- 单次修复、实验 → L3 存放或删除,不入 L1 LESSONS - 单次修复、实验 → L3 存放或删除,不入 L1 LESSONS
**L3 中 SOP 与工具脚本的分工**
- SOP*_sop.md
- 主要用途:记录**坑**。
- 重点写:以后再做同类任务时最容易出问题的环节、前置条件、环境/配置坑,以及当前已验证有效的解决办法和排查思路。
- 何时记录步骤:
- 只有在任务是**复杂、多步、长链路**时,才顺带把关键步骤流程写清楚,方便整体复现;
- 对于简单、直观、模型按常识就能完成的任务,**不需要在 SOP 里记完整步骤**。
- 工具脚本 / util*.py 等)
- 前提:只有当某块逻辑具备**清晰边界和函数独立性**,且**有明显复用价值**时,才封装成工具脚本。
- 典型用途:
- 像自定义 Python 包那样,把稳定功能做成可多次调用的函数 / 模块;
- 当某任务“坑太多、文字 SOP 难以说清”时,把稳定的处理逻辑直接写成代码函数,让上层只需调用,不必每次重新踩坑。
--- ---
## L1 ↔ L2 同步规则 ## L1 ↔ L2 同步规则
@@ -79,5 +90,6 @@ L3: ../memory/ (记录库层 - 包含 .md/.py 等各类文件)
└─ NO → L3 (../memory/) └─ NO → L3 (../memory/)
- 过程/日志 → maintenance_log.md - 过程/日志 → maintenance_log.md
- 工具文档 → *_sop.md - 工具文档 → *_sop.md
- 代码 → .py 文件 - 可复用代码函数 → .py 文件
- 临时实验 → L3 或删除 - 临时实验 → 删除
```