How do I install the Memory Gc skill?

Run npx skillmds@latest add yangwhale/memory-gc in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Memory Gc safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Memory Gc?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Memory Gc free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Memory Gc?

yangwhale (@yangwhale) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Memory Gc by yangwhale — Agent Skill

Name: Memory Gc
Author: yangwhale

Memory Gc

记忆系统自动 GC — audit 当前 MEMORY.md / shared/ / disk memory 文件健康度。**Pressure-driven 不是 time-driven** — 没积累就不该清, cold ≠ garbage, 没新东西不要找事清。当用户说「memory audit」「记忆 GC」「记忆清理」「sleep gc」「/memory gc」「/memory audit」「check memory health」时触发。

yangwhale b58a96f 2 files · 3.5 KB Updated Sep 17, 2026

File contents

Memory GC — 记忆系统自动体检

核心哲学: GC 按 pressure 触发, 不是按 time 触发. 类比 Chrome 的 mark-and-sweep — 不是 timer 触发, 是 heap 压力到阈值才触发. 没积累就不该清, cold ≠ garbage.

何时触发

用户说「memory audit」「记忆体检」「记忆清理」「sleep gc」
weekly cron 7 0 * * 1 UTC (= 周一 8:07 HKT) — 一周一次, 给积累有时间发酵
任何 session 觉得「MEMORY.md 长了/重了」想做一次清理时

默认模式: --action-only (cron 用这个)

只显示 🚨 ACTIONABLE 段 (dead/dup/stale). 如果 actionable=0 → 直接 silent 输出 "🟢 健康无需 cleanup", 不展开 cold links 列表防止形成清理冲动.

# cron / 每日 check 用这个 (默认 silent if healthy)
python3 ~/CloseCrab/scripts/memory-audit.py --action-only

# 完整 3 段报告 (按需展开看 cold/orphan, 比如周末手工审)
python3 ~/CloseCrab/scripts/memory-audit.py

# JSON / 调窗口
python3 ~/CloseCrab/scripts/memory-audit.py --json
python3 ~/CloseCrab/scripts/memory-audit.py --cold-days 30
python3 ~/CloseCrab/scripts/memory-audit.py --stale-days 14

3 类信号 (按风险分级)

类别	信号	处理
🚨 ACTIONABLE (必清, 无风险)	stale_timestamp / duplicates / dead_index	看到立刻清, 任何 session 都可干
👀 NEEDS REVIEW (case-by-case)	orphans (disk 有 MEMORY 没)	看 head + mtime, active 补索引 / 废弃 rm disk
ℹ️ INFO ONLY (绝不强清)	cold_links (近 N 天 0 Read)	cold ≠ garbage. 只 user 主动 ask 才看. 平时 cron 报告默认不展开. R5 实证 cold shared/ 改触发关键词后命中率 17%→83%, 不是该删.

R5 教训 (不要瞎删)

cold ≠ stale。R5 验证 cold shared/ 文件改触发关键词后命中率从 17%→83%。100 个冷 feedback link 里大部分是「平时不 trigger 但一旦 trigger 就救命」的深度知识。只删有明确证据过期的：

闭环项目接续指针（已 supersede）
重复索引（同 slug 多次）
死索引（文件已删）
命名违规的孤儿（日期文件名等）

执行清理时的工作流

跑 audit → 拿 markdown 报告
按信号优先级处理：
- stale_timestamp → 直接 demote/删 (Edit MEMORY.md)
- duplicates → 合并到 1 个 + 删另一个 (Edit)
- dead_index → 删 link (Edit) 或恢复 disk file
- orphans → 看 mtime + head 文件判断 active/废弃, active 补索引, 废弃 rm disk file
- cold_links → 不要批量清，逐个看是否真过期
改完再跑一次 audit 看是否归零
sponge memory 记录这次清掉了什么 + 为什么

参考

完整 GC 设计哲学: [[feedback-memory-system-overfit-r1-r5]]
重要纠错: [[feedback-memory-gc-pressure-not-time]] — Chris 2026-05-21 反思: daily cron 会形成"每天必清"冲动, 没新东西时清的就是稳定记忆. 改 weekly + action-only + cold ≠ garbage
weekly cron: job_id e642aac85244, target=jarvis, cron="7 0 * * 1 UTC" (= 周一 8:07 HKT)

---name: memory-gcdescription: 记忆系统自动 GC — audit 当前 MEMORY.md / shared/ / disk memory 文件健康度。**Pressure-driven 不是 time-driven** — 没积累就不该清, cold ≠ garbage, 没新东西不要找事清。当用户说「memory audit」「记忆 GC」「记忆清理」「sleep gc」「/memory gc」「/memory audit」「check memory health」时触发。---# Memory GC — 记忆系统自动体检**核心哲学**: GC 按 pressure 触发, 不是按 time 触发. 类比 Chrome 的 mark-and-sweep — 不是 timer 触发, 是 heap 压力到阈值才触发. 没积累就不该清, cold ≠ garbage.## 何时触发- 用户说「memory audit」「记忆体检」「记忆清理」「sleep gc」- weekly cron `7 0 * * 1` UTC (= 周一 8:07 HKT) — **一周一次**, 给积累有时间发酵- 任何 session 觉得「MEMORY.md 长了/重了」想做一次清理时## 默认模式: --action-only (cron 用这个)只显示 🚨 ACTIONABLE 段 (dead/dup/stale). 如果 actionable=0 → 直接 silent 输出 "🟢 健康无需 cleanup", **不展开 cold links 列表防止形成清理冲动**.```bash# cron / 每日 check 用这个 (默认 silent if healthy)python3 ~/CloseCrab/scripts/memory-audit.py --action-only# 完整 3 段报告 (按需展开看 cold/orphan, 比如周末手工审)python3 ~/CloseCrab/scripts/memory-audit.py# JSON / 调窗口python3 ~/CloseCrab/scripts/memory-audit.py --jsonpython3 ~/CloseCrab/scripts/memory-audit.py --cold-days 30python3 ~/CloseCrab/scripts/memory-audit.py --stale-days 14```## 3 类信号 (按风险分级)| 类别 | 信号 | 处理 ||---|---|---|| **🚨 ACTIONABLE** (必清, 无风险) | stale_timestamp / duplicates / dead_index | 看到立刻清, 任何 session 都可干 || **👀 NEEDS REVIEW** (case-by-case) | orphans (disk 有 MEMORY 没) | 看 head + mtime, active 补索引 / 废弃 rm disk || **ℹ️ INFO ONLY** (绝不强清) | cold_links (近 N 天 0 Read) | **cold ≠ garbage**. 只 user 主动 ask 才看. 平时 cron 报告默认不展开. R5 实证 cold shared/ 改触发关键词后命中率 17%→83%, **不是该删**. |## R5 教训 (不要瞎删)**cold ≠ stale**。R5 验证 cold shared/ 文件改触发关键词后命中率从 17%→83%。100 个冷 feedback link 里大部分是「平时不 trigger 但一旦 trigger 就救命」的深度知识。**只删有明确证据过期的**：- 闭环项目接续指针（已 supersede）- 重复索引（同 slug 多次）- 死索引（文件已删）- 命名违规的孤儿（日期文件名等）## 执行清理时的工作流1. 跑 audit → 拿 markdown 报告2. 按信号优先级处理： - **stale_timestamp** → 直接 demote/删 (Edit MEMORY.md) - **duplicates** → 合并到 1 个 + 删另一个 (Edit) - **dead_index** → 删 link (Edit) 或恢复 disk file - **orphans** → 看 mtime + head 文件判断 active/废弃, active 补索引, 废弃 `rm` disk file - **cold_links** → 不要批量清，逐个看是否真过期3. 改完再跑一次 audit 看是否归零4. sponge memory 记录这次清掉了什么 + 为什么## 参考- 完整 GC 设计哲学: [[feedback-memory-system-overfit-r1-r5]]- **重要纠错**: [[feedback-memory-gc-pressure-not-time]] — Chris 2026-05-21 反思: daily cron 会形成"每天必清"冲动, 没新东西时清的就是稳定记忆. 改 weekly + action-only + cold ≠ garbage- weekly cron: `job_id e642aac85244`, target=jarvis, cron="7 0 * * 1 UTC" (= 周一 8:07 HKT)

Frequently asked questions