From da10ba404ba76035b74de830aff198be08eb16f1 Mon Sep 17 00:00:00 2001
From: Liang Jiaqing <l.j.q.light@gmail.com>
Date: Sun, 1 Feb 2026 16:09:05 +0800
Subject: [PATCH] Refine memory management SOP for L3 SOP/util rules

---
 memory/memory_management_sop.md | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

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