Code Understand — Bản đồ trọng tâm kiến trúc theo yêu cầu
Tạo bản đồ xếp hạng các tệp và symbol mà kiến trúc thực sự dựa vào, kèm trích dẫn `file:line`, để định hướng nhanh trong codebase lạ.
Lập trìnhTrung cấp★ 3,520⑂ 350Điểm AI 8/10Cập nhật lần cuối: 3 thg 10, 2026
Giúp được gì
- Quét dự án và tạo danh sách xếp hạng các tệp/symbol chịu lực của kiến trúc (focus map).
- Mỗi mục đi kèm trích dẫn
file:linevà loại bằng chứng (định nghĩa / import / tệp đã thay đổi / khớp văn bản bằngrg). - Dùng CodeGraph nếu có để lấy cạnh call-graph thật; nếu không, dùng trình trích xuất regex +
rg, không cần cài thêm gì. - Với
--changedhoặc--since <sha>, bản đồ tập trung vào phạm vi ảnh hưởng của thay đổi bạn sắp thực hiện. - Có quy tắc rõ ràng: không commit JSON thô hay thư mục
.codegraph/vào tài liệu/PR.
Phù hợp với ai
- Lập trình viên mới nhận một repo lớn và cần hiểu kiến trúc trước khi sửa.
- Người chuẩn bị refactor lớn và muốn biết chỗ nào dễ vỡ.
- Người muốn viết mô tả PR có dẫn chứng
file:linethay vì phỏng đoán. - Môi trường đã có hoặc có thể cài CLI
obsidian-wiki.
Ví dụ sử dụng
- "Giải thích kiến trúc dự án này" →
obsidian-wiki code-understand --project . --prettyrồi đọc đúng các vị trí được trích dẫn. - Trước khi refactor →
obsidian-wiki code-understand --since HEAD~5để xem bán kính ảnh hưởng của các thay đổi gần đây. - Truy vết ai gọi một hàm →
--changed src/auth/session.tsđể lấy các symbol liên quan thay vì grep toàn cây.
· · · 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/Ar9av/obsidian-wiki/HEAD/.skills/code-understand/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 .skills/code-understand từ repo GitHub Ar9av/obsidian-wiki vào ~/.claude/skills/code-understand/ 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/Ar9av/obsidian-wiki.git /tmp/obsidian-wiki && mkdir -p ~/.claude/skills && cp -r /tmp/obsidian-wiki/.skills/code-understand ~/.claude/skills/⚠ Đâ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à clone repo:
git clone https://github.com/Ar9av/obsidian-wiki.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r obsidian-wiki/.skills/code-understand ~/.claude/skills/ - Cài CLI
obsidian-wikitheo hướng dẫn trong repo (nếu thiếu, Claude sẽ tự quay về cách khám phá bằng grep). - (Tùy chọn) Để có bằng chứng call-graph tốt hơn:
npm install -g @colbymchenry/codegraph— chỉ cài khi bạn đồng ý. - Kiểm tra bằng
obsidian-wiki doctor --project .và xem các dòngcode-understanding.*. - Khởi động lại Claude Code và thử yêu cầu: "giúp tôi hiểu codebase này".
Xem mã nguồn trên GitHub ↗Giấy phép: MIT