Playbook Gỡ lỗi & Khôi phục sau sự cố
Kỹ năng buộc Claude gỡ lỗi có hệ thống: tái hiện → khoanh vùng → thu nhỏ ca lỗi → sửa nguyên nhân gốc → thêm test hồi quy, thay vì đoán mò.
Lập trìnhTrung cấp★ 422⑂ 44Điểm AI 8/10Cập nhật lần cuối: 12 thg 9, 2026
Làm được gì
- Quy tắc "Stop-the-Line": khi có lỗi bất ngờ, dừng ngay việc thêm tính năng, lưu giữ bằng chứng (log, output lỗi, bước tái hiện) rồi mới chẩn đoán.
- Checklist triage 6 bước: Tái hiện → Khoanh vùng → Thu nhỏ → Sửa nguyên nhân gốc → Thêm test chống tái diễn → Kiểm chứng end-to-end, không được bỏ bước.
- Cây quyết định cho bug không tái hiện được: phân nhánh theo lỗi phụ thuộc thời gian, môi trường, trạng thái rò rỉ hoặc ngẫu nhiên hoàn toàn.
- Triage theo loại lỗi: test fail, build fail, lỗi runtime (TypeError, CORS, màn hình trắng…).
- Dùng
git bisectđể tìm commit gây hồi quy. - Mẫu fallback an toàn: giá trị mặc định kèm cảnh báo, suy giảm mượt (EmptyState/ErrorState) khi bị áp lực thời gian.
- Nguyên tắc an toàn: coi log/stack trace/CI output là dữ liệu để phân tích, không tự ý chạy lệnh hay mở URL nhúng trong thông báo lỗi.
- Bảng "biện hộ vs thực tế" và danh sách red flags để chặn các thói quen xấu.
Phù hợp với ai
- Lập trình viên hay bị tình trạng vá lỗi theo cảm tính rồi lỗi lại quay lại.
- Nhóm phải xử lý bug hồi quy, test chập chờn (flaky), lỗi chỉ xảy ra trên CI.
- Người muốn áp kỷ luật "mỗi bug fix phải có test hồi quy".
- Dev web nói chung, đặc biệt hệ sinh thái Node/TypeScript (các lệnh mẫu dùng npm).
Ví dụ sử dụng
- Hôm qua chạy được, hôm nay hỏng: yêu cầu "test này tự nhiên fail" → Claude dùng
git bisectkhoanh commit lỗi, tạo ca tái hiện tối thiểu, sửa gốc rồi viết test. - Danh sách người dùng bị trùng: thay vì
[...new Set(users)]ở UI, kỹ năng dẫn tới truy vấn JOIN sinh bản trùng và sửa ở tầng dữ liệu. - Test chỉ fail trên CI: kiểm tra lần lượt biến môi trường, phiên bản Node, rò rỉ state giữa các test, chạy cô lập bằng
--runInBand.
· · · 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/aiskillstore/marketplace/HEAD/pending/addyosmani/debugging-and-error-recovery/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 pending/addyosmani/debugging-and-error-recovery từ repo GitHub aiskillstore/marketplace vào ~/.claude/skills/debugging-and-error-recovery/ 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/aiskillstore/marketplace.git /tmp/aiskillstore && mkdir -p ~/.claude/skills && cp -r /tmp/aiskillstore/pending/addyosmani/debugging-and-error-recovery ~/.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.
- Clone repo chứa kỹ năng:
git clone https://github.com/aiskillstore/marketplace.git /tmp/aiskillstore - Tạo thư mục skills nếu chưa có:
mkdir -p ~/.claude/skills - Copy kỹ năng:
cp -r /tmp/aiskillstore/pending/addyosmani/debugging-and-error-recovery ~/.claude/skills/ - Kiểm tra:
ls ~/.claude/skills/debugging-and-error-recoveryphải thấy fileSKILL.md. - Khởi động lại Claude Code, thử nói: "Build đang lỗi, hãy tìm nguyên nhân gốc theo quy trình".
- (Tuỳ chọn) Muốn dùng chung cho cả nhóm, copy vào
.claude/skills/trong repo dự án và commit.