Smart Explore (Duyệt cấu trúc code)

Làm được gì

Thay vì đọc trọn file (Read), skill buộc Claude dùng quy trình 3 lớp dựa trên phân tích AST của tree-sitter:

1. smart_search — quét cả thư mục, trả về danh sách symbol (hàm/class/method) kèm số dòng và khung cấu trúc file (~2–6k token)
2. smart_outline — bộ xương của một file: hàm, class, thuộc tính, import (~1–2k token)
3. smart_unfold — mở đúng một symbol với toàn bộ mã nguồn, JSDoc, decorator (~0.4–2.1k token)

Một lệnh search thay cho cả chu trình Glob → Grep → Read. Vì cắt theo biên node AST nên method dài không bị cắt cụt. Tài liệu có bảng so sánh: tiết kiệm 4–8 lần so với Read và 11–18 lần so với Explore agent.

Hỗ trợ sẵn JS/TS/TSX, Python, Go, Rust, Ruby, Java, C/C++; có thể thêm grammar khác (ví dụ Solidity) qua file .claude-mem.json. Markdown được xử lý riêng: outline theo heading, unfold theo section, hiện cả frontmatter.

Phù hợp với ai

• Lập trình viên làm việc trên codebase lớn, hay bị tràn context
• Người cần định vị nhanh một tính năng nằm rải rác ở nhiều file trước khi refactor hoặc fix bug
• Nhóm muốn giảm chi phí token thực tế
• Người viết tài liệu kỹ thuật / hướng dẫn onboarding từ mã nguồn

Ví dụ sử dụng

• Truy vết tính năng: smart_search(query="shutdown", path="./src") cho ra 14 symbol ở 7 file, rồi chỉ unfold performGracefulShutdown để xem logic chính.
• Đi trong file khổng lồ: outline worker-service.ts (1.466 token) để thấy 12 hàm và 24 thành viên class, sau đó unfold đúng method startSessionProcessor — tổng ~3k token thay vì ~12k nếu đọc cả file.
• Viết tài liệu kiểu kết hợp: dùng smart_* cho code, dùng Read thường cho file cấu hình JSON/Markdown nhỏ để lấy bối cảnh.

Lưu ý: chính tài liệu khuyên dùng Grep cho tìm chuỗi/regex chính xác, Read cho file dưới ~100 dòng, và Explore agent khi cần tổng hợp kiến trúc qua 6+ file.

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục plugin/skills/smart-explore từ repo GitHub thedotmack/claude-mem vào ~/.claude/skills/smart-explore/ 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.