memory-optimize by kochetkov-ma/claude-brewcode
npx skills add https://github.com/kochetkov-ma/claude-brewcode --skill memory-optimize通过 4 个交互步骤 优化 Claude Code 的 自动记忆 文件:移除重复项、将规则迁移到适当的配置文件、压缩剩余条目、验证结果。典型效果:内存文件的令牌数量减少 30–50%。
自动记忆功能在 ~/.claude/projects/**/memory/MEMORY.md 中存储跨会话的上下文。启用:CLAUDE_CODE_DISABLE_AUTO_MEMORY=0 · 禁用:CLAUDE_CODE_DISABLE_AUTO_MEMORY=1
优势: 更快的上下文加载速度 · 无重复规则 · 更清晰的指令 · 更低的 API 成本
用法:
/memory-optimize # 无参数 — 启动 4 步交互式工作流
技能文本专为 LLM 理解编写,并针对令牌效率进行了优化。
通过 4 个交互步骤优化 Claude Code 的内存文件。
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
无context: fork — 必须在主对话中运行以生成代理。
~/.claude/projects/**/memory/*.md~/.claude/CLAUDE.md 和项目 CLAUDE.md(如果存在).claude/rules/*.md — 读取所有项目规则~/.claude/rules/*.md — 读取所有全局规则构建上下文映射:
memory_files: [paths]
claude_md_sections: [sections]
rules_files: [paths with content]
目标: 查找与 CLAUDE.md 或规则中已有内容重复的内存条目。
生成 Explore 代理以交叉引用所有已加载的文件
识别以下情况的条目:
显示分析结果:
发现 X 个重复/冗余条目(占内存的 Y%): | 条目 | 内存文件 | 已存在于 | 操作 | |-------|-------------|------------|--------| | "首先使用 grepai" | MEMORY.md:5 | rules/grepai-first.md | 删除 | ...
AskUserQuestion:"删除 X 个重复条目(占内存的 Y%)?这是安全的 — 内容已存在于其他地方。"
如果获得批准,使用 Edit 工具应用删除操作
目标: 识别更适合持久化配置文件的剩余内存条目。
决策树(针对每个条目):
~/.claude/rules/.claude/rules/CLAUDE.md显示分类结果:
X 个条目适合迁移: | 条目 | 当前位置 | 目标 | 减少量 | |-------|-----------------|--------|-----------| | "始终使用 BD_PLUGIN_ROOT" | MEMORY.md:12 | .claude/rules/brewdoc.md | 15 个令牌 | ... 总计:X 个条目 → 约节省 Y 个令牌
AskUserQuestion:"将 X 个条目迁移到 rules/CLAUDE.md?"
如果获得批准:
Edit 创建/追加到目标规则文件Edit 从内存中移除已迁移的条目目标: 使用 LLM 高效格式压缩剩余条目。
压缩技术:
显示压缩预览:
发现压缩机会: | 压缩前 | 压缩后 | 节省量 | |--------|-------|---------| | "当你需要...时,总是使用..." | "对 Y 使用 X" | 8 个令牌 | ... 总计:约减少 Y% 的令牌(约 Z 个令牌)
显示 2-3 个具体的压缩前/后示例。
2. AskUserQuestion:"压缩剩余内存?(约减少 Y%)"
* 选项:"是,全部压缩" / "跳过压缩"
3. 通过 Edit 应用压缩(自底向上顺序以保留行号)
目标: 验证最终状态并清理孤立的引用。
reviewer 代理以验证:
~/.claude/projects/**/memory/ 中没有被 MEMORY.md 引用的文件)最终报告:
## 内存优化完成
### 摘要
| 指标 | 优化前 | 优化后 | 节省 |
|--------|--------|-------|-------|
| 总条目数 | X | Y | Z |
| 重复条目数 | X | 0 | — |
| 迁移条目数 | — | — | X |
| 令牌估计值 | ~X | ~Y | ~Z (~P%) |
### 所做更改
- 步骤 1:删除了 X 个重复条目
- 步骤 2:将 X 个条目迁移到 rules/CLAUDE.md
- 步骤 3:压缩了 X 个条目(减少 Y%)
- 步骤 4:修复了 X 个损坏的引用,移除了 X 个孤立的文件
### 最终内存结构
{~/.claude/projects/.../memory/ 的目录列表}
---
**brewdoc 的一部分:** [brewcode](https://github.com/kochetkov-ma/claude-brewcode) — 文档工具:内存优化、自动同步、Claude 安装文档、Markdown 转 PDF。
安装:`claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode && claude plugin install brewdoc@claude-brewcode`
每周安装量
1.1K
仓库
GitHub 星标数
16
首次出现
2026年3月1日
安全审计
安装于
opencode1.0K
codex999
cursor998
amp973
github-copilot972
kimi-cli970
Plugin: kochetkov-ma/claude-brewcode
Optimizes Claude Code auto-memory files in 4 interactive steps : removes duplicates, migrates rules to proper config files, compresses remaining entries, validates the result. Typical reduction: 30–50% token count in memory files.
Auto-memory stores context across sessions in ~/.claude/projects/**/memory/MEMORY.md. Enable: CLAUDE_CODE_DISABLE_AUTO_MEMORY=0 · Disable: CLAUDE_CODE_DISABLE_AUTO_MEMORY=1
Benefits: faster context loading · no duplicate rules · cleaner instructions · lower API cost
Usage:
/memory-optimize # no args — starts 4-step interactive workflow
Skill text is written for LLM consumption and optimized for token efficiency.
Optimizes Claude Code memory files through 4 interactive steps.
No
context: fork— must run in main conversation to spawn agents.
~/.claude/projects/**/memory/*.md~/.claude/CLAUDE.md and project CLAUDE.md (if exists).claude/rules/*.md — read all project rules~/.claude/rules/*.md — read all global rulesBuild context map:
memory_files: [paths]
claude_md_sections: [sections]
rules_files: [paths with content]
Goal: Find memory entries that duplicate content already in CLAUDE.md or rules.
Spawn Explore agent to cross-reference all loaded files
Identify entries where:
Show analysis:
Found X duplicate/redundant entries (Y% of memory): | Entry | Memory File | Already In | Action | |-------|-------------|------------|--------| | "Use grepai first" | MEMORY.md:5 | rules/grepai-first.md | DELETE | ...
AskUserQuestion: "Delete X duplicate entries (Y% of memory)? This is safe — content exists elsewhere."
Apply deletion using Edit tool if approved
Goal: Identify remaining memory entries better suited to persistent config files.
Decision tree (per entry):
~/.claude/rules/.claude/rules/CLAUDE.mdShow categorization:
X entries suitable for migration: | Entry | Current Location | Target | Reduction | |-------|-----------------|--------|-----------| | "Always use BD_PLUGIN_ROOT" | MEMORY.md:12 | .claude/rules/brewdoc.md | 15 tokens | ... Total: X entries → ~Y tokens saved
AskUserQuestion: "Migrate X entries to rules/CLAUDE.md?"
If approved:
EditEditGoal: Compress remaining entries using LLM-efficient formatting.
Compression techniques:
Show compression preview:
Compression opportunities found: | Before | After | Savings | |--------|-------|---------| | "When you need to... always use..." | "Use X for Y" | 8 tokens | ... Total: ~Y% token reduction (~Z tokens)
Show 2-3 specific before/after samples.
2. AskUserQuestion: "Compress remaining memory? (~Y% reduction)"
* Options: "Yes, compress all" / "Skip compression"
3. Apply compression via Edit (bottom-up order to preserve line numbers)
Goal: Verify final state and clean orphaned references.
reviewer agent to verify:
~/.claude/projects/**/memory/ with no MEMORY.md reference)Final Report:
## Memory Optimization Complete
### Summary
| Metric | Before | After | Saved |
|--------|--------|-------|-------|
| Total entries | X | Y | Z |
| Duplicate entries | X | 0 | — |
| Migrated entries | — | — | X |
| Token estimate | ~X | ~Y | ~Z (~P%) |
### Changes Made
- Step 1: Deleted X duplicate entries
- Step 2: Migrated X entries to rules/CLAUDE.md
- Step 3: Compressed X entries (Y% reduction)
- Step 4: Fixed X broken references, removed X orphaned files
### Final Memory Structure
{directory listing of ~/.claude/projects/.../memory/}
---
**Part of brewdoc:** [brewcode](https://github.com/kochetkov-ma/claude-brewcode) — docs tools: memory optimization, auto-sync, Claude installation docs, Markdown to PDF.
Install: `claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode && claude plugin install brewdoc@claude-brewcode`
Weekly Installs
1.1K
Repository
GitHub Stars
16
First Seen
Mar 1, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykFail
Installed on
opencode1.0K
codex999
cursor998
amp973
github-copilot972
kimi-cli970
99,500 周安装