Nexus Mapper — Bản đồ codebase cho AI

Khảo sát repo lạ theo giao thức PROBE 5 giai đoạn và tạo thư mục kiến thức .nexus-map/ để mọi phiên AI hiểu ngay kiến trúc dự án.

Lập trìnhNâng cao★ 163⑂ 15Điểm AI 9/10Cập nhật lần cuối: 31 thg 3, 2026

Làm được gì

Kết hợp trích xuất AST bằng Tree-sitter với phân tích lịch sử Git để khảo sát cấu trúc repo một cách hệ thống.
Sinh ra thư mục .nexus-map/: INDEX.md (điểm vào khởi động lạnh, dưới 2000 token), arch/systems.md (biên hệ thống), arch/dependencies.md (đồ thị Mermaid), arch/test_coverage.md, concepts/concept_model.json (đồ thị máy đọc được), hotspots/git_forensics.md (điểm nóng & cặp thay đổi cùng nhau) và dữ liệu thô trong raw/.
Bắt buộc đi qua các cổng giai đoạn PROBE, cấm suy đoán theo tên thư mục; node không có bằng chứng phải ghi planned/inferred kèm evidence_gap.
Hỗ trợ hơn 30 ngôn ngữ theo phần mở rộng; ngôn ngữ lạ có thể bổ sung bằng --add-extension, --add-query hoặc --language-config.
Có quy tắc an toàn: ghi tạm vào .tmp/ rồi di chuyển nguyên khối, hỏi trước khi ghi đè, chỉ ghi nhận sự tồn tại của .env/khóa mà không sao chép giá trị.

Phù hợp với ai

Lập trình viên phải nhanh chóng nắm bắt một repo legacy hoặc dự án mã nguồn mở mới nhận.
Nhóm sắp refactor lớn, cần đánh giá phạm vi ảnh hưởng dựa trên bằng chứng thật.
Đội ngũ muốn có ngữ cảnh dùng chung để mỗi phiên AI không phải giải thích lại dự án từ đầu.

Ví dụ sử dụng

"Phân tích repo này và tạo cơ sở tri thức dự án" → sinh trọn bộ .nexus-map/, phiên AI sau chỉ cần đọc INDEX.md là bắt tay làm việc được.
Trước khi đổi tên một hàm public: query_graph.py --impact src/core/auth.py --git-stats raw/git_stats.json để biết bán kính ảnh hưởng và mức rủi ro.
Bỏ qua thư mục rác: chạy lại extract_ast.py với --exclude-dirs django_static,third_party/assets để cây file gọn hơn.

· · · 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/Haaaiawd/Nexus-skills/HEAD/skills/nexus-mapper/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.

↓ Tải ZIP

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 skills/nexus-mapper từ repo GitHub Haaaiawd/Nexus-skills vào ~/.claude/skills/nexus-mapper/ 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/Haaaiawd/Nexus-skills.git && mkdir -p ~/.claude/skills && cp -r Nexus-skills/skills/nexus-mapper ~/.claude/skills/ && pip install -r ~/.claude/skills/nexus-mapper/scripts/requirements.txt

⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.

Mở terminal và chuyển tới thư mục làm việc bạn muốn.
Clone repo: git clone https://github.com/Haaaiawd/Nexus-skills.git
Sao chép skill vào thư mục skill của Claude Code: mkdir -p ~/.claude/skills && cp -r Nexus-skills/skills/nexus-mapper ~/.claude/skills/
Kiểm tra Python: python --version (cần 3.10 trở lên).
Cài phụ thuộc: pip install -r ~/.claude/skills/nexus-mapper/scripts/requirements.txt
Xác nhận python -c "import tree_sitter" chạy không lỗi.
Khởi động lại Claude Code, cung cấp đường dẫn tuyệt đối của repo và yêu cầu: "dùng nexus-mapper tạo cơ sở tri thức cho dự án này".
(Tùy chọn) Thêm quy tắc vào CLAUDE.md/AGENTS.md để các phiên sau luôn đọc .nexus-map/INDEX.md trước.

Xem mã nguồn trên GitHub ↗