review

Tổng quan về review skill

review làm gì

review là một self-improving-agent skill dùng để kiểm tra auto-memory của Claude Code. Skill này giúp agent rà soát MEMORY.md, tìm các mục nên được nâng cấp thành hướng dẫn lâu dài, nhận diện nội dung đã lỗi thời hoặc bị trùng lặp, và đưa ra khuyến nghị bảo trì thay vì để bộ nhớ dự án phình to không kiểm soát. Hãy dùng review skill khi bạn muốn biết agent đã học được gì, điều gì nên trở thành chỉ dẫn bền vững cho dự án, và nội dung nào nên được cắt bỏ.

Trường hợp phù hợp nhất với review skill này

review skill hữu ích nhất cho các nhóm đang dùng Claude Code memory trong một workflow Context Engineering. Skill này phù hợp với những dự án mà các bài học lặp lại, ưu tiên về công cụ, quyết định kiến trúc hoặc lỗi thường gặp được ghi lại tự động nhưng vẫn cần rà soát biên tập định kỳ. Skill này kém hữu ích hơn nếu dự án của bạn không dùng Claude Code memory, không có thư mục project memory .claude, hoặc chỉ cần tóm tắt một lần cho một file nguồn.

Điểm khác biệt so với một prompt thông thường

Một prompt kiểu “summarize my memory” thông thường thường bỏ sót các bước kiểm tra mang tính vận hành. review skill cung cấp cho agent một lộ trình kiểm toán cụ thể: xác định thư mục memory theo từng dự án, đọc MEMORY.md, kiểm tra áp lực số dòng so với giới hạn khởi động 200 dòng, phát hiện các mẫu lặp lại, xác minh tham chiếu file đã lỗi thời, và tách riêng các mục nên nâng cấp khỏi những mục có giá trị thấp. Cấu trúc đó giúp đầu ra dễ hành động hơn khi bảo trì ngữ cảnh dài hạn cho agent.

Cách sử dụng review skill

Cài đặt review và các file cần kiểm tra đầu tiên

Cài đặt skill từ GitHub repository bằng lệnh:

npx skills add alirezarezvani/claude-skills --skill review

Sau khi cài đặt, hãy đọc SKILL.md trước. Đường dẫn repository này chứa toàn bộ workflow trong một file duy nhất, không có thêm rules/, resources/, references/ hoặc script nào cần kiểm tra. Các phần nguồn quan trọng nhất là Usage, What It Does, Step 1: Locate memory directory, và Step 2: Read and analyze MEMORY.md.

Các lệnh sử dụng review cơ bản

Skill upstream được thiết kế xoay quanh cách gọi kiểu /si:review:

• /si:review để kiểm toán memory đầy đủ
• /si:review --quick để xem số lượng và các ứng viên nổi bật
• /si:review --stale để tập trung vào các mục đã lỗi thời
• /si:review --candidates để chỉ hiển thị các mục có khả năng nên được nâng cấp

Trong thực tế, hãy gọi review skill từ project root mà bạn muốn kiểm toán. Skill này cần truy cập được project memory của Claude Code, thường nằm trong một đường dẫn được suy ra từ current working directory bên trong ~/.claude/projects/.../memory.

Thông tin đầu vào giúp review cho kết quả tốt hơn

Một prompt yếu là: “Review memory.”

Một prompt tốt hơn là:

“Run the review skill for this repository. Check the project auto-memory, count MEMORY.md lines against the startup limit, identify recurring lessons that should be promoted into durable instructions, flag stale entries that reference deleted files or old tools, and group recommendations by promote, consolidate, prune, and keep.”

Prompt này hiệu quả hơn vì nêu rõ tiêu chí kiểm toán và các nhóm quyết định. Nếu bạn biết các thay đổi gần đây của dự án, hãy đưa vào: thư mục đã đổi tên, công cụ đã gỡ bỏ, chuẩn coding mới, hoặc thay đổi về policy. Những chi tiết đó giúp agent đánh giá một memory entry đã lỗi thời hay vẫn còn giá trị.

Quy trình review được khuyến nghị

Bắt đầu với /si:review --quick nếu file memory lớn hoặc bạn chỉ cần phân loại nhanh. Chạy review đầy đủ khi chuẩn bị làm mới context, onboarding một thiết lập agent mới, hoặc dọn dẹp memory đã tích lũy trước một chu kỳ phát triển tính năng lớn. Dùng --stale sau các đợt refactor lớn, thay đổi dependency, hoặc di chuyển file. Dùng --candidates khi mục tiêu của bạn là Context Engineering: nâng cấp các bài học lặp lại vào CLAUDE.md, tài liệu dự án, hoặc quy tắc của nhóm.

FAQ về review skill

review chỉ dành cho Claude Code memory phải không?

Đúng vậy, skill này được thiết kế riêng theo các quy ước auto-memory của Claude Code, đặc biệt là project memory trong ~/.claude/projects/.../memory và MEMORY.md. Bạn có thể điều chỉnh hướng dẫn review cho các file memory khác, nhưng giá trị mạnh nhất của skill này xuất hiện khi agent có thể đi theo layout Claude Code memory như kỳ vọng.

Điều gì xảy ra nếu không có thư mục memory?

Skill nên báo rằng auto-memory có thể đang bị tắt hoặc không khả dụng, rồi gợi ý kiểm tra thiết lập memory, chẳng hạn dùng /memory. Đây là một điểm cần cân nhắc hữu ích trước khi cài đặt: nếu nhóm của bạn chưa bật hoặc chưa tích lũy Claude Code memory, review sẽ có rất ít nội dung để phân tích cho đến khi memory tồn tại.

Khi nào không nên dùng review?

Không dùng review để thay thế code review, security review, hoặc QA tài liệu. Skill này kiểm toán chất lượng memory của agent, không kiểm tra tính đúng đắn của source code. Nó cũng không phù hợp với các dự án hoàn toàn mới chưa có mẫu lặp lại, các nhóm chủ động tránh persistent agent memory, hoặc những trường hợp bạn chỉ cần một bản tóm tắt đơn giản cho một tài liệu duy nhất.

review hỗ trợ Context Engineering như thế nào?

Với Context Engineering, review biến memory thô thành một hàng đợi bảo trì. Skill này giúp quyết định quan sát lặp lại nào nên trở thành context ổn định, mục nào bị trùng, và ghi chú lỗi thời nào nên được loại bỏ trước khi chúng làm sai lệch các agent trong tương lai. Đầu ra có giá trị nhất khi bạn xem nó như một lượt biên tập lại ngữ cảnh vận hành của agent.

Cách cải thiện review skill

Cung cấp bằng chứng cho review, không chỉ đưa lệnh

review skill hoạt động tốt hơn khi agent có thể kiểm tra các file memory thực tế và repository hiện tại. Hãy đảm bảo agent có thể xác minh các đường dẫn được nhắc đến bằng kiểm tra filesystem, thay vì chỉ dựa vào nội dung memory. Nếu bạn nghi ngờ một hướng dẫn đã lỗi thời, hãy nói rõ lý do: “we migrated from Jest to Vitest,” “the api/legacy folder was removed,” hoặc “the deployment process changed last week.”

Yêu cầu các nhóm quyết định có thể hành động ngay

Hãy yêu cầu các nhóm kết quả gắn với hành động cụ thể. Các nhóm hữu ích gồm:

• Promote to durable project instruction
• Consolidate with similar entries
• Prune because stale or low-value
• Keep as temporary memory
• Investigate because evidence is unclear

Cách này giúp đầu ra review không biến thành một bản tóm tắt mơ hồ, đồng thời giúp việc cập nhật CLAUDE.md, tài liệu nhóm, hoặc các file memory sau kiểm toán trở nên dễ dàng hơn.

Các lỗi thường gặp cần chú ý

Lỗi phổ biến nhất là nâng cấp quá nhiều quan sát chỉ xảy ra một lần. Một memory item thường chỉ nên được nâng cấp nếu nó lặp lại, có tính policy, hoặc hữu ích rộng rãi cho các phiên làm việc sau này. Một lỗi khác là xóa các mục chỉ vì chúng cũ; chỉ riêng tuổi đời không đồng nghĩa với lỗi thời. Các tín hiệu lỗi thời tốt hơn gồm file không còn tồn tại, công cụ đã được thay thế, quy ước bị mâu thuẫn, hoặc tham chiếu đến công việc tạm thời đã hoàn tất.

Lặp lại sau lần review đầu tiên

Sau lần review đầu tiên, hãy yêu cầu agent chuyển các khuyến nghị thành một patch plan tối giản: cần thêm gì, gộp gì, xóa gì, và kiểm tra lại gì. Sau đó chạy lại review ở quick mode để xác minh memory đã ngắn hơn, ít trùng lặp hơn, và khớp hơn với cách dự án hiện đang vận hành. Nhờ vậy, review trở thành một vòng lặp bảo trì liên tục thay vì một báo cáo dùng một lần.