PR Lens — Sơ đồ kiến trúc cho pull request
Mô tả thay đổi code thành tài liệu JSON rồi render ra sơ đồ kiến trúc/luồng dữ liệu SVG động và gắn vào pull request.
Lập trìnhTrung cấp★ 202⑂ 7Điểm AI 9/10Cập nhật lần cuối: 3 thg 9, 2026
Làm được gì
- Đọc diff bằng
git diff --find-renames <base>...<head>(dùng merge base) rồi viết tài liệu.pr-lens/graph.jsongồm lanes, nodes, edges và flows. - Chạy
validaterồirendercủa@coldtea/pr-lens-cliđể tạo SVG động (theme dark mặc định) cùngmanifest.json. - Gắn sơ đồ vào PR bằng
gh pr create/edit/commentvới cờ--attachvà ảnh Markdown. - Nếu chỉ cần giải thích, dùng
canvas pushđể lấy link xem công khai không cần đăng nhập (không chia sẻ link edit). - Sửa sơ đồ sai bằng overlay
.github/pr-lens.yml(rename, exclude, lane) thay vì sửa file được sinh ra.
Phù hợp với ai
- Lập trình viên, tech lead muốn reviewer hiểu bức tranh tổng thể trước khi đọc diff.
- Nhóm thường xuyên refactor hoặc thay đổi ranh giới service, hàng đợi, data store.
- Người muốn trực quan hóa codebase theo tư duy C4 (system context → container → component).
Ví dụ sử dụng
- "Vẽ sơ đồ kiến trúc cho PR này và đưa vào phần mô tả" → phân tích diff → graph.json → validate/render →
gh pr edit 42 --attach ... - "Cho tôi xem luồng dữ liệu của repo này" → render view kiến trúc + luồng dữ liệu rồi
canvas pushđể lấy link. - "Bỏ file test khỏi sơ đồ và đưa broadcast-lib vào lane functions" → thêm rule exclude/lane vào
.github/pr-lens.ymlrồi render lại.
· · · 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/coldteadotai/pr-lens/HEAD/packages/agent-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 packages/agent-skill từ repo GitHub coldteadotai/pr-lens vào ~/.claude/skills/pr-lens/ 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/coldteadotai/pr-lens.git /tmp/pr-lens && mkdir -p ~/.claude/skills/pr-lens && cp -r /tmp/pr-lens/packages/agent-skill/* ~/.claude/skills/pr-lens/⚠ Đâ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 Node.js (để dùng
npx) và Git. Nếu muốn gắn ảnh vào PR, cần GitHub CLI ≥ 2.99 (kiểm tragh --version). - Clone repo:
git clone https://github.com/coldteadotai/pr-lens.git /tmp/pr-lens - Tạo thư mục skill:
mkdir -p ~/.claude/skills/pr-lens - Copy nội dung skill:
cp -r /tmp/pr-lens/packages/agent-skill/* ~/.claude/skills/pr-lens/ - Kiểm tra có
SKILL.mdvà thư mụcreferences/(graph-document.md, config.md, example.graph.json). - Khởi động lại Claude Code, vào repo của bạn và yêu cầu: "vẽ sơ đồ cho thay đổi này".
- CLI chạy trực tiếp qua
npx @coldtea/pr-lens-cli@latest; kết quả nằm trong.pr-lens/và được thêm vào .gitignore — đừng commit chúng.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT