Lối tắt dễ mắc
Chắc là X; sửa ngay được.
Cách làm đúng
Đó là dấu hiệu cảnh báo; quay lại điều tra có hệ thống.
Ctrl K
Tóm tắt nhanh / Lệnh
Bộ Marketing
/ak:debugging
Kỷ luật debug tận gốc
Bắt buộc điều tra nguyên nhân gốc, truy vết ngược, validation nhiều lớp và xác minh mới trước khi tuyên bố đã sửa bug, test, build hoặc lỗi hiệu năng.
01
Đọc lỗi
02
Điều tra nguyên nhân gốc
03
So sánh pattern
04
Truy vết ngược
Nguyên tắc 01
Sửa mò làm mất thời gian và tạo bug mới.
Nguyên tắc 02
Sửa tại nguồn sinh ra dữ liệu hoặc hành vi sai, không phải tại triệu chứng nhìn thấy.
Nguyên tắc 03
Hoàn tất phải có bằng chứng xác minh mới và đã đọc thật sự.
Bản đồ thực thi
Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.
01
Khởi động
Đầu vào, phạm vi, route
- 1 Đọc lỗi Thu thập lỗi thật, cách tái hiện, thay đổi gần đây và bằng chứng trước khi đụng vào code.
- 2 Điều tra nguyên nhân gốc Hoàn thành Phase 1 của systematic debugging trước mọi nỗ lực sửa.
02
Xử lý
Agent / skill thực thi
- 3 So sánh pattern Tìm ví dụ đang chạy đúng, so sánh khác biệt và xác định vì sao đường này lỗi.
- 4 Truy vết ngược Nếu lỗi xuất hiện sâu trong luồng chạy, lần ngược call stack đến nơi dữ liệu sai hoặc trigger bắt đầu.
03
Kiểm chứng
Gate, review, xác thực
- 5 Kiểm giả thuyết Lập giả thuyết tối thiểu và kiểm nó trước khi triển khai cách sửa cuối.
- 6 Sửa tại nguồn Sửa nguyên nhân ban đầu, không chỉ che triệu chứng ở nơi lỗi lộ ra.
04
Đóng
Báo cáo, bàn giao, artifact
- 7 Thêm phòng tuyến Sau khi biết nguyên nhân gốc, thêm validation đầu vào, guard logic nghiệp vụ, guard môi trường hoặc instrumentation khi phù hợp.
- 8 Xác minh mới Chạy lệnh xác minh, đọc output, rồi mới được tuyên bố thành công.
Đừng bỏ qua bước bắt buộc
Mỗi mục đối chiếu một lối tắt dễ mắc với cách làm đúng mà skill yêu cầu.
Lối tắt dễ mắc
Giờ chắc chạy rồi.
Cách làm đúng
Phải chạy xác minh và đọc output trước khi nói là chạy được.
Prompt mẫu
Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.
Điều tra bug Khuyến nghị
/ak:debugging gửi checkout thất bại với lỗi 500- Dùng khi:
- Dùng khi hành vi bị lỗi và nguyên nhân chưa được chứng minh.
- Kết quả:
- Luồng điều tra nguyên nhân gốc trước rồi sửa tại nguồn.
Test fail
/ak:debugging các test middleware xác thực đang thất bại- Dùng khi:
- Dùng khi test fail cần bằng chứng trước khi sửa code.
- Kết quả:
- Đọc lỗi, so sánh pattern, kiểm giả thuyết và xác minh mới.
Lỗi hiệu năng
/ak:debugging dashboard tải chậm- Dùng khi:
- Dùng khi hiệu năng kém bất thường.
- Kết quả:
- Truy vết dựa trên bằng chứng đến đúng bottleneck trước khi tối ưu.
Phạm vi xử lý
- Debug có hệ thống
- Truy vết nguyên nhân gốc
- Phòng thủ nhiều lớp
- Quy trình xác minh
- Test failure
- Lỗi hiệu năng
- Build failure