Compass — Điều hướng đồ thị mã nguồn
Skill giúp Claude dùng đồ thị tri thức cục bộ của Compass CLI để phân tích kiến trúc, phụ thuộc và phạm vi ảnh hưởng của thay đổi.
Lập trìnhNâng cao★ 162⑂ 8Điểm AI 9/10Cập nhật lần cuối: 28 thg 9, 2026
Làm được gì
- Khởi tạo đồ thị tri thức cục bộ bằng
compass ensurekhi bắt đầu phiên làm việc, rồi trả lời câu hỏi về mã nguồn bằng truy vấn đồ thị thay vì đọc tràn lan cả repo. - Định tuyến lệnh theo mục đích:
query,ask,search,callers/callees,call-graph,impact,affected,path,explain,architecture. - Bắt buộc theo hết phân trang (
next=cursor) và xác minh các kết luận quan trọng trực tiếp trong mã nguồn. - Quy trình Agent Graph Overlay: ghim revision,
prepare→ batch →apply→audit, cùng cổng kiểm soátrebasekhi Base Graph đổi. - Phân loại rõ ranh giới: chỉ đọc / tạo file cục bộ / cần mạng & thông tin đăng nhập / thao tác phá hủy.
Phù hợp với ai
- Lập trình viên làm việc trên repo lớn, thường xuyên cần hiểu kiến trúc và dò chuỗi gọi hàm.
- Nhóm cần đánh giá rủi ro pull request hoặc phạm vi refactor có dẫn chứng rõ ràng.
- Người đã hoặc đang định dùng Compass CLI.
Ví dụ sử dụng
- "Tổng quan kiến trúc repo này?" → chạy
compass ensure, đọc phần Agent Orientation trongGRAPH_REPORT.mdrồicompass architecture. - "Sửa hàm này thì ảnh hưởng tới đâu?" →
compass affected "<symbol>" --depth Nđể lấy phạm vi review. - "Module A phụ thuộc module B qua đường nào?" →
compass path "A" "B".
· · · 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 && mkdir -p ~/.claude/skills && 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 và kiểm tra
compass --helpchạy được (đây là điều kiện bắt buộc). - Clone repo:
git clone https://github.com/crabbuild/compass /tmp/compass - Sao chép skill:
mkdir -p ~/.claude/skills && cp -r /tmp/compass/crates/compass-cli/assets/compass-skill ~/.claude/skills/compass - Kiểm tra thư mục
references/đã được copy kèm theo. - Khởi động lại Claude Code, mở thư mục dự án và thử
/compass --help. - Với repo mới: chạy
compass initrồicompass update .; nếu muốn cập nhật liên tục, mở terminal thứ hai chạycompass watch ..
Xem mã nguồn trên GitHub ↗Giấy phép: NOASSERTION