stash

# stash：项目记忆持久化 回顾本次对话，把跨会话有用的信息落进 memory，让未来的会话能召回。 > **记忆写法规范以同目录 [`MEMORY_SPEC.md`](MEMORY_SPEC.md) 为唯一真相源**，本文件只定流程，不复述 schema 细节（复述会随规范演化而漂移，这正是 stash 从 command 升级为 skill 的初衷）。执行前先读 `MEMORY_SPEC.md`。 ## 触发 显式触发：`/stash`、「stash / 保存记忆 / 记一下 / 沉淀一下 / 记住这个」。**不自动触发**，持久化是写文件的副作用动作，只在用户明确要求时跑。 ## 主流程（7 步） ### 1. 定位 memory 目录 ```bash # 锚到项目根（git toplevel），不用裸 pwd：从子目录触发时 pwd 会偏移、写进错 keyspace 致召回静默丢失 ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd) MEM="$HOME/.claude/projects/-$(printf '%s' "$ROOT" | sed 's:^/::; s:[^a-zA-Z0-9]:-:g')/memory" [ -d "$MEM" ] || mkdir -p "$MEM" # 新项目首次 stash 自动建 # MEMORY.md 不存在则建四段骨架（recall 总目录；按 type 分段） [ -f "$MEM/MEMORY.md" ] || printf '# Memory\n\n## User\n\n## Feedback\n\n## Project\n\n## Reference\n' > "$MEM/MEMORY.md" echo "$MEM" ``` **路径由项目根（git toplevel，回退 pwd）动态推导，绝不硬编码**（通用工具跨项目零修改；硬编码曾把记忆写错机器，裸 pwd 则在子目录触发时写偏）。若 harness 直接给了 memory 目录绝对路径，优先用它。**`MEM` 是 shell 变量、不跨 Bash 调用持久**，下面每个用到它的 bash 块都重新派生一次（别依赖上一块的 `MEM` 还在）。 ### 2. 盘点候选 读 `MEMORY_SPEC.md` 拿规范，再扫本次对话，列出值得持久化的候选：新知识、做出的决策、发现的坑、配置/基础设施变更、用户反馈与偏好。按 `MEMORY_SPEC` 判断标准先粗筛（只留跨会话有用的）。 **加法 + 减法双扫**：除了「值得记什么」（加法），同时扫「本次对话作废了什么」（减法）：删除 / 退役 / 下线 / 停用 / 离职 / 决策反转这类破坏性事件，拿去撞现有 memory 的主题：对每个被作废实体名跑全文撞库 `LC_ALL=C grep -ril -- '<实体名>' "$MEM"`（`$MEM` 重派生见 Step 1；撞全文、不止 name / description，旧值常只散落在他题 memory 的正文里）。命中的进 Step 3 走 supersession / 墓碑，别当没发生。减法事件天生不触发「记一下」，是过时记忆的高发源。 ### 3. 查重（先查后写，防碎片化） ```bash ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd); MEM="$HOM...