Przejdź do treści
Biblioteka skilli
AI i agenci · Przegląd i audyt

memory-gc

/memory-gc

Audytuje stan plików pamięci agenta, w tym MEMORY.md i katalogu shared, i porządkuje je dopiero wtedy, gdy zgromadzi się nadmiar wpisów.

Repozytorium
closecrab ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/memory-audit.py

Co robi i kiedy

Audytuje stan plików pamięci agenta, w tym MEMORY.md i katalogu shared, i porządkuje je dopiero wtedy, gdy zgromadzi się nadmiar wpisów.

Oryginalny opis (EN)

记忆系统自动 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」时触发。

Jak działa

  1. 何时触发
  2. 默认模式: --action-only (cron 用这个)
  3. 3 类信号 (按风险分级)
  4. R5 教训 (不要瞎删)
  5. 执行清理时的工作流
  6. 参考
Sekcje z nagłówków SKILL.md, w oryginale · 62 linii, 339 słów
Podgląd SKILL.md
---
name: memory-gc
description: 记忆系统自动 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」时触发。
trigger: memory audit / 记忆 gc / 记忆清理 / sleep gc / 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 --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 多次)
- 死索引(文件已删)
- 命名违规的孤儿(日期文件名等)

## 执行清理时的工作流

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)
Pliki w paczce (2)
  • SKILL.md 4 KB
  • scripts/memory-audit.py 1 KB

Wersje

W bazie nie ma innych skilli o nazwie memory-gc.

Migawka bazy z 13.11.2026 · wersja paczki 8b3d461a9ab1 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100memory-init
    Inicjalizuje system pamięci w bieżącym katalogu: tworzy CLAUDE.md, opcjonalnie AGENT.md dla Cursora, MEMORY.md i katalog memory.
  • 100memory-lint
    Przeprowadza gruntowną przebudowę pamięci agenta: audyt kondycji, scalanie klastrów, obsługa osieroconych wpisów, naprawa martwych linków, test regresji i kopia zapasowa.
  • 95solo-memory-audit
    Audytuje pamięć i kontekst agenta: pliki CLAUDE.md, mapę pamięci, reguły i budżet kontekstu, żeby zoptymalizować to, co ładuje się w sesji.
  • 100memory-status
    Wyświetla stan systemu pamięci Engram: konfigurację, rozmiary plików, liczbę wpisów i kontrolę kondycji.
  • 100memory-manager
    Bada zdrowie pamięci agenta Hermes: koszt tokenów na turę, nieaktualne i zbędne wpisy, rozmiar bazy sesji oraz korekty użytkownika z historii czatu, które nie trafiły do pamięci.
  • 100agent-sleep
    Porządkuje pamięć agenta kodującego po sesji: konsolidacja, higiena pamięci i kontrola dryfu, zawsze poza trybem interaktywnym.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.