Phân tích capture GPU với rdc-cli
Skill hướng dẫn Claude dùng rdc-cli để mở file capture RenderDoc (.rdc), truy vết draw call, shader, pixel và tự động kiểm thử GPU trong CI.
Lập trìnhNâng cao★ 159⑂ 32Điểm AI 8/10Cập nhật lần cuối: 22 thg 7, 2026
Làm được gì
- Hướng dẫn trọn vòng đời phiên làm việc với capture RenderDoc:
rdc open→rdc info/stats/events→ duyệt VFS (rdc ls,rdc cat) →rdc debug pixel/vertex/thread→ xuất dữ liệu →rdc close. - Phân tích render pass (
rdc passes,rdc pass,rdc unused-targets), so sánh trạng thái pipeline, decode constant buffer, xuất render target/texture ra PNG. - Viết script kiểm thử hồi quy GPU bằng các lệnh assert (
assert-pixel,assert-clean,assert-count,assert-state,assert-image) trả về mã lỗi khác 0 khi thất bại. - Bao gồm replay từ xa (
--proxy), chế độ split thin-client (--listen/--connect), workflow Android (Adreno/Mali) và danh mục lỗi thường gặp kèm cách xử lý.
Phù hợp với ai
- Lập trình viên game/engine/đồ họa muốn phân tích frame bằng shell pipeline thay vì GUI RenderDoc.
- Đội ngũ cần kiểm thử tự động kết quả render trong CI (màu pixel, số draw call, so sánh ảnh).
- Người làm việc trên laptop macOS/Windows nhưng GPU nằm trên server Linux.
Ví dụ sử dụng
- "Liệt kê draw call của pass GBuffer dưới dạng JSON" →
rdc open capture.rdcrồirdc draws --pass "GBuffer" --json. - "Truy vết vì sao pixel (512,384) tại EID 1024 bị đen" →
rdc debug pixel 1024 512 384 --trace. - "Tạo script CI kiểm tra ảnh render" →
rdc assert-clean+rdc assert-count draws --expect 10 --op ge+rdc assert-pixel ....
· · · 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/BANANASJIM/rdc-cli/HEAD/src/rdc/_skills/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 src/rdc/_skills từ repo GitHub BANANASJIM/rdc-cli vào ~/.claude/skills/rdc-cli/ 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/BANANASJIM/rdc-cli.git && mkdir -p ~/.claude/skills/rdc-cli && cp -r rdc-cli/src/rdc/_skills/* ~/.claude/skills/rdc-cli/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Chuẩn bị: cần một bản build RenderDoc cục bộ có Python bindings (và adb nếu làm việc với Android).
- Cài CLI: chạy
pip install rdc-clitrong terminal. - Kiểm tra môi trường: chạy
rdc doctorđể xem trạng thái module renderdoc, renderdoccmd, adb. - Tải skill:
git clone https://github.com/BANANASJIM/rdc-cli.git. - Chạy
mkdir -p ~/.claude/skills/rdc-cli && cp -r rdc-cli/src/rdc/_skills/* ~/.claude/skills/rdc-cli/để copy SKILL.md và thư mục references. - Khởi động lại Claude Code và thử yêu cầu: "mở file .rdc này và cho tôi xem draw calls" — skill sẽ tự kích hoạt.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT