360 Secure SkillHub
360 安全技能中心

Memory Defragmenter

提供分析记忆状态、生成清理计划、执行去重合并与分层归档、校验完整性的流程，处理 Markdown 记忆文件；要求执行前备份和复核，但 lint 标记存在指令冲突与破坏性操作风险。

klemenska
klemenska
热度 49.13
最近更新 2026-05-11 17:36:35
分类：知识依赖：代码执行 / 读写文件应用场景：笔记整理 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add memory-defragmenter
Metadata
name
memory-defragmenter
description
Defragment and optimize agent memory files by cleaning duplicates, merging similar entries, archiving stale content, and ensuring proper tiering. Use when: (1) memory files feel cluttered or bloated; (2) before or after context optimization; (3) weekly memory maintenance; (4) when explicitly asked to clean, defragment, or optimize memory.

Memory Defragmenter

Clean, merge, and optimize memory files to keep them lean and effective.

Purpose

Memory files grow over time and become:

  • Bloated with duplicates
  • Stale with outdated info
  • Scattered across tiers
  • Inconsistent in format

This skill defragments them.

When to Run

Trigger Action
Weekly maintenance Full defragment
Before context optimization Clean first
After many sessions Remove stale entries
Explicit request Clean specified files

Defragmentation Workflow

Step 1: Analyze Memory State

python3 scripts/analyze_memory.py

Reports:

  • Files analyzed and sizes
  • Duplicate detection
  • Stale entry detection (30+ days old)
  • Tier distribution
  • Formatting consistency

Step 2: Generate Defragmentation Plan

python3 scripts/defragment.py --plan

Creates defragment-plan.md with:

  • Entries to merge
  • Entries to archive
  • Entries to delete
  • Entries to promote/demote

Step 3: Review Plan

Read the plan and approve/modify before execution.

Step 4: Execute Defragmentation

python3 scripts/defragment.py --execute

Backs up original files first, then:

  • Merges duplicate entries
  • Archives stale content to archive/
  • Promotes hot entries to HOT tier
  • Demotes cold entries to archive
  • Normalizes formatting

Step 5: Verify

python3 scripts/verify_memory.py

Checks:

  • All files readable
  • No broken links
  • Consistent formatting
  • Tier limits respected

Memory Tiers Reference

Tier Location Max Size Age Policy
HOT memory.md, ~/self-improving/memory.md ≤100 lines each Review monthly
WARM memory/*.md, ~/self-improving/domains/ ≤200 lines each Review quarterly
COLD archive/ Unlimited Archive at 90 days

Safety Rules

  1. Always backup before executing
  2. Review plan before applying
  3. Never delete - only archive
  4. Keep originals for 24h after
  5. Verify after every defragment

Files

  • scripts/analyze_memory.py — Analyze memory state
  • scripts/defragment.py — Plan and execute cleanup
  • scripts/verify_memory.py — Verify integrity
  • references/rules.md — Defragmentation rules and patterns