Memory Engine (Bộ máy ghi nhớ)

Hệ thống quản lý bộ nhớ cho Claude Code: tự lưu và khôi phục ngữ cảnh phiên làm việc qua hook, đồng thời học từ những lỗi lặp lại.

Tiện íchTrung cấp★ 132⑂ 27Điểm AI 9/10Cập nhật lần cuối: 11 thg 5, 2026

Làm được gì

Smart Context: nhận diện dự án theo thư mục làm việc hiện tại và tự nạp bộ nhớ tương ứng khi bắt đầu phiên.
Auto Learn (phát hiện cạm bẫy): nhận ra các mẫu như thử lại nhiều lần, lỗi rồi sửa, hoặc người dùng chỉnh sửa — lưu cả vấn đề lẫn cách khắc phục vào ~/.claude/skills/learned/. Lỗi lặp 3 lần trở lên sẽ được đề xuất nâng thành quy tắc cố định.
Student Loop (/reflect): chu trình học 8 bước (ghi chú → liên kết → tìm mẫu → xem lại → tinh gọn → phân tích lại → cắt bớt → báo cáo).
Session Handoff (/handoff): lưu tiến độ, quyết định và việc còn dở để cửa sổ Claude Code kế tiếp đọc lại tự động.
Correction Cycle (/analyze): ghi lại những chỉnh sửa của người dùng — loại lỗi không xuất hiện trong log.
Ghi lưu tại 3 thời điểm (mỗi 20 tin nhắn, trước khi nén ngữ cảnh, khi kết thúc phiên) nên bạn không cần nhớ chạy lệnh.

Phù hợp với ai

Người làm dự án dài, hay bị mất ngữ cảnh khi phiên bị nén hoặc đóng.
Người làm nhiều dự án song song và muốn bộ nhớ tách riêng theo từng dự án.
Người dùng Claude Code trên nhiều máy và muốn đồng bộ bộ nhớ qua GitHub.
Người muốn ngăn Claude lặp lại cùng một sai lầm bằng quy tắc cứng.

Ví dụ sử dụng

Sắp hết ngữ cảnh giữa chừng → gõ /handoff, mở cửa sổ mới và phiên mới tự đọc file bàn giao.
Cuối tuần muốn tổng kết → chạy /reflect để xem lại 7 ngày gần nhất và nâng lỗi lặp thành quy tắc.
Chuyển sang máy ở nhà → chạy /sync (memory-backup.sh sync) để đồng bộ hai chiều với repo GitHub rồi /reload.
MEMORY.md phình to → dùng /memory-health để xem cảnh báo dung lượng và tách nội dung cũ ra file riêng.

· · · Hướng dẫn cài đặt · · ·

Dùng thử ngay, không cần cài

Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.

Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình:
https://raw.githubusercontent.com/HelloRuru/claude-memory-engine/HEAD/skill/SKILL.md

Mình muốn: (viết việc bạn cần ở đây)

Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.

↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.

Cài vào ứng dụng Claude (không cần terminal)

Tải tệp ZIP bằng nút bên dưới.
Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.

↓ Tải ZIP

Cài vào Claude Code

Để Claude làm — dán câu dưới đây vào Claude Code

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục skill từ repo GitHub HelloRuru/claude-memory-engine vào ~/.claude/skills/memory-engine/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.

Cài bằng lệnh thủ công

git clone https://github.com/HelloRuru/claude-memory-engine.git /tmp/claude-memory-engine && mkdir -p ~/.claude/skills/memory-engine && cp -r /tmp/claude-memory-engine/skill/* ~/.claude/skills/memory-engine/

⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.

Mở terminal và clone kho: git clone https://github.com/HelloRuru/claude-memory-engine.git
Vào thư mục: cd claude-memory-engine
Đọc README xem có script cài đặt sẵn không — nếu có, hãy ưu tiên dùng nó.
Sao lưu cấu hình hiện tại: cp -r ~/.claude ~/.claude.bak
Chép skill: mkdir -p ~/.claude/skills/memory-engine && cp -r skill/* ~/.claude/skills/memory-engine/
Chép các file hook vào ~/.claude/scripts/hooks/ và các file lệnh vào ~/.claude/commands/.
Khai báo hook SessionStart, SessionEnd, PreCompact, UserPromptSubmit, PreToolUse trong ~/.claude/settings.json.
Nếu muốn sao lưu: tạo một repo GitHub riêng cho bộ nhớ, cấu hình trong memory-backup.sh và thử memory-backup.sh push.
Khởi động lại Claude Code, chạy /overview hoặc /check để kiểm tra hoạt động.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT