Compass — Điều hướng codebase bằng đồ thị
Skill kết nối Compass CLI để dựng đồ thị tri thức cục bộ và trả lời câu hỏi về kiến trúc, phụ thuộc, phạm vi ảnh hưởng kèm bằng chứng nguồn.
Lập trìnhTrung cấp★ 130⑂ 7Điểm AI 9/10Cập nhật lần cuối: 15 thg 8, 2026
Làm được gì
- Dựng đồ thị tri thức cục bộ của repo (
compass-out/graph.json) và chuyển câu hỏi tự nhiên thành truy vấn đồ thị. - Định tuyến đúng lệnh theo mục đích:
query,explain,path,affected,callers/callees,call-graph,search,tree,review. - Hỗ trợ bản đồ kiến trúc, truy vết chuỗi phụ thuộc, ước lượng phạm vi ảnh hưởng thay đổi, review rủi ro PR, và xem đồ thị tại một commit lịch sử (
--at REV). - Bắt buộc tôn trọng phân trang (
next=), hướng cạnh, độ tin cậy và nguồn gốc — phân biệt rõ "quan sát được" với "suy luận". - Phân loại ranh giới thao tác: chỉ đọc, xuất bản cục bộ, cần mạng/thông tin xác thực, và phá hủy/ghi từ xa.
Phù hợp với ai
- Lập trình viên vừa nhận một repo lớn, lạ và cần nắm nhanh kiến trúc.
- Nhóm cần xác định phạm vi ảnh hưởng trước khi refactor hoặc đổi API.
- Người review PR muốn chỉ ra điểm rủi ro kèm dẫn chứng vị trí mã nguồn.
- Người có thể cài Compass CLI trên máy cục bộ.
Ví dụ sử dụng
- "Luồng xác thực trong repo này hoạt động thế nào?" → chạy
compass update .rồicompass query "authentication flow", chỉ mở các file quyết định để kiểm chứng. - "Sửa
parse_configthì ảnh hưởng tới đâu?" →compass affected "parse_config" --depth 3để lấy phạm vi review. - "Vì sao module A phụ thuộc module B?" →
compass path "A" "B"để lấy đường phụ thuộc ngắn nhất kèm vị trí bằng chứ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/crabbuild/compass/HEAD/crates/compass-cli/assets/compass-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.
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 crates/compass-cli/assets/compass-skill từ repo GitHub crabbuild/compass vào ~/.claude/skills/compass/ 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/crabbuild/compass /tmp/compass && cp -r /tmp/compass/crates/compass-cli/assets/compass-skill ~/.claude/skills/compass⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Cài Compass CLI trước: xem README của repo https://github.com/crabbuild/compass (ví dụ
cargo install --path crates/compass-cli), rồi kiểm tra bằngcompass --help. - Tải mã nguồn skill:
git clone https://github.com/crabbuild/compass /tmp/compass - Sao chép thư mục skill:
cp -r /tmp/compass/crates/compass-cli/assets/compass-skill ~/.claude/skills/compass - Kiểm tra thư mục
references/đã được sao chép cùng (chứa tài liệu tham chiếu theo yêu cầu). - Khởi động lại Claude Code, mở thư mục gốc của repo cần phân tích và chạy
compass initrồicompass update .một lần. - Gõ
/compasshoặc hỏi "phân tích kiến trúc codebase này" để kích hoạt skill.
Xem mã nguồn trên GitHub ↗Giấy phép: NOASSERTION