MemoryCustodian

1) Cài đặt MemoryCustodian (chọn đường dẫn phù hợp với tác nhân/quy trình làm việc của bạn): Chọn một phương pháp cài đặt: - Yêu cầu tác nhân mã hóa của bạn cài đặt kỹ năng từ kho lưu trữ: https://github.com/waittim/MemoryCustodian - Codex (thị trường cục bộ): chạy `codex plugin marketplace add .` từ một bản kiểm tra, sau đó `codex plugin add memory-custodian@memory-custodian-dev`. - Claude Code (plugin): để kiểm tra cục bộ chạy `claude --plugin-dir .`, hoặc cài đặt vào kỹ năng cá nhân với `./install.sh claude`. - Các tác nhân kiểu Gemini: cài đặt với `./install.sh gemini` hoặc `gemini skills link ./skills/memory-custodian`. - CLI/kiểm tra nguồn: chạy từ kho lưu trữ qua `scripts/memory-custodian ...` hoặc cài đặt có thể chỉnh sửa với `python3 -m pip install -e .` để có lệnh `memory-custodian`.

2) Khởi tạo MemoryCustodian trong một dự án (một lần cho mỗi kho lưu trữ): Chạy khởi tạo một lần cho mỗi dự án mục tiêu: - Nếu được cài đặt dưới dạng tập lệnh console: `memory-custodian init --project-root /path/to/project --agent all` - Từ một bản kiểm tra nguồn: `scripts/memory-custodian init --project-root /path/to/project --agent all` Sử dụng `--agent codex`, `--agent claude`, `--agent gemini`, hoặc `--agent all` để tạo các tệp khởi động mỏng mà tác nhân của bạn đọc.

3) Hiểu những gì khởi tạo tạo ra (nơi bộ nhớ tồn tại): Khởi tạo tạo ra bộ nhớ bền vững mặc định dưới `docs/memory/`: - `manifest.md` (định tuyến những gì cần tải) - `brief.md` (hình dạng dự án hiện tại) - `decisions.md` (các quyết định chính) - `constraints.md` (các yêu cầu cứng) - `do-not-use.md` (các đường dẫn bị từ chối / bia mộ) - `inbox.md` (khu vực dàn dựng) Các tệp khởi động nền tảng (ví dụ: `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`) vẫn mỏng và chỉ các tác nhân đến `docs/memory/`.

4) Sắp xếp bản tóm tắt đã tạo trước khi dựa vào nó: Sau `init`, `brief.md` bắt đầu như một giàn giáo với các TODO. Điền nó từ các nguồn dự án có thẩm quyền (README, mã, tài liệu) trước khi coi bộ nhớ đã sẵn sàng. Sử dụng `memory-custodian status --project-root /path/to/project` (hoặc `scripts/memory-custodian status ...`) để xem liệu bản tóm tắt có còn chưa được sắp xếp hay không; `status` và `check` báo cáo một bản tóm tắt chưa được sắp xếp.

5) Tải bộ nhớ phù hợp cho một tác vụ (đọc ưu tiên manifest): Quy trình làm việc dự kiến cho các tác nhân là: 1) Đọc `docs/memory/manifest.md`. 2) Đọc `docs/memory/brief.md`. 3) Chỉ tải các tệp liên quan đến tác vụ được đặt tên bởi manifest. Để kiểm tra thủ công, tạo một gói ngữ cảnh với: - `memory-custodian read --project-root /path/to/project --task planning` - `memory-custodian read --project-root /path/to/project --task implementation` - `memory-custodian read --project-root /path/to/project --task artifact`

6) Thêm bộ nhớ bền vững khi có điều gì đó nên tồn tại trong cuộc trò chuyện hiện tại: Ghi lại các quyết định/ràng buộc/ưu tiên/các phương pháp bị từ chối bằng cách sử dụng CLI: - `memory-custodian add "Chúng tôi đã chọn tải ưu tiên manifest." --type decision` - `memory-custodian add "Duy trì sao lưu thử lại đồng bộ." --type decision --area sync --reason "Giữ các lần thử lại bị giới hạn qua các lần khởi chạy."` Giữ các mục quyết định ngắn (công cụ thực thi hướng dẫn mã thông báo và từ chối các ghi quá dài trừ khi bạn cho phép rõ ràng các mục dài).

7) Chỉ bật các mô-đun bộ nhớ tùy chọn khi chúng trở nên liên quan: Các mô-đun tùy chọn (ví dụ: quy tắc, hồ sơ, khu vực) là tùy chọn và không được tải trừ khi được bật và định tuyến bởi manifest. Bật chúng khi cần: - `memory-custodian enable preferences` - `memory-custodian enable rules/output` - `memory-custodian enable profile/git` - `memory-custodian enable area/frontend` Bật không bao giờ ghi đè lên một tệp mô-đun hiện có.

8) Sử dụng 'do-not-use' để bảo toàn các phương pháp bị từ chối và tránh hồi quy: Khi bạn cố ý từ chối một phương pháp (ví dụ: một phần phụ trợ lưu trữ hoặc kiến trúc), hãy ghi lại nó trong `docs/memory/do-not-use.md` (thông qua chỉnh sửa hoặc quy trình làm việc thêm/quên thích hợp) để các phiên tương lai không đề xuất lại nó.

9) Kiểm tra sức khỏe và khả năng tương thích giao thức thường xuyên: Chạy xác thực xác định để đảm bảo cấu trúc, ngân sách và siêu dữ liệu giao thức là chính xác: - `memory-custodian check --project-root /path/to/project` Sử dụng `memory-custodian status` để có cái nhìn tổng quan nhanh và phát hiện một bản tóm tắt chưa được sắp xếp.

10) Nén và duy trì bộ nhớ (ưu tiên xem trước, các thay đổi an toàn): Sử dụng các lệnh bảo trì để giữ bộ nhớ nhỏ và hiện tại: - `memory-custodian compact --project-root /path/to/project` Nén được bảo vệ và ưu tiên xem trước; chỉ áp dụng các thay đổi sau khi xem xét kế hoạch. Nén hộp thư đến là bảo thủ (ví dụ: loại bỏ đơn vị dấu đầu dòng cấp cao nhất trùng lặp chính xác và lọc bia mộ) và mong đợi một tác nhân/con người thực hiện quảng bá ngữ nghĩa thành các quyết định/ràng buộc.

11) Quên thông tin lỗi thời một cách an toàn (ưu tiên xem trước): Xóa hoặc biên tập các chủ đề lỗi thời bằng cách quên ưu tiên xem trước: - Xem trước: `memory-custodian forget "ghi chú triển khai cũ" --mode soft --project-root /path/to/project` - Áp dụng sau khi xem xét: `memory-custodian forget "ghi chú triển khai cũ" --mode soft --apply --project-root /path/to/project` Các kết quả khớp rộng yêu cầu xác nhận rõ ràng (ví dụ: `--allow-broad-match`). Một số trường hợp yêu cầu viết lại thủ công; công cụ sẽ từ chối các xóa toàn bộ không an toàn.

12) Sửa chữa hoặc thay thế một thiết lập hiện có khi cần: Nếu các tệp bị thiếu hoặc siêu dữ liệu cần cập nhật mà không ghi đè nội dung đã sắp xếp: - Sửa chữa: `memory-custodian init --project-root /path/to/project --repair` Nếu bạn cố ý muốn thay thế hoàn toàn, hãy sử dụng thay thế ưu tiên xem trước và chỉ áp dụng khi chính xác: - `memory-custodian init --project-root /path/to/project --replace-existing` - sau đó thêm `--apply` chỉ khi các tệp được liệt kê nên được thay thế.

13) Di chuyển phiên bản bộ nhớ giao thức/dự án khi công cụ cập nhật: Khi `check` báo cáo siêu dữ liệu giao thức cũ hoặc bị thiếu, hãy di chuyển manifest dự án ngoại tuyến: - Xem trước: `memory-custodian migrate --project-root /path/to/project` - Áp dụng sau khi xem xét: `memory-custodian migrate --apply --project-root /path/to/project`

14) Sử dụng lệnh gọi đúng trên Windows so với kiểm tra nguồn: Trên Windows, cài đặt lệnh console và sử dụng `memory-custodian ...`. Từ một bản kiểm tra kho lưu trữ trên bất kỳ nền tảng nào, bạn có thể chạy `scripts/memory-custodian ...` làm trình bao bọc.