debugging-and-error-recovery

Tổng quan về skill debugging-and-error-recovery

Skill debugging-and-error-recovery là một cách có cấu trúc để chẩn đoán lỗi mà không đoán mò. Skill này phù hợp nhất với lập trình viên và agent đang đối mặt với test thất bại, build hỏng, hành vi runtime bất thường, log nhiễu hoặc các regression chỉ xuất hiện sau khi thay đổi. Nếu bạn cần skill debugging-and-error-recovery cho Debugging, mục tiêu không chỉ là “sửa lỗi”, mà là giữ lại bằng chứng, tái hiện vấn đề và xác định nguyên nhân gốc trước khi tiếp tục thay đổi.

Skill này dùng để làm gì

Skill này hữu ích nhất khi lỗi là có thật nhưng nguyên nhân chưa rõ. Nó thúc đẩy tư duy “dừng dây chuyền”: không tiếp tục đẩy tính năng khi một vấn đề đã biết chưa được xử lý. Điều đó khiến nó rất phù hợp với quy trình test-driven, triage sự cố và mọi repo mà một sai sót nhỏ có thể kéo theo các lỗi sau đó gây nhiễu.

Ai nên cài đặt

Hãy cài debugging-and-error-recovery nếu bạn thường xuyên debug code với agent và muốn một quy trình lặp lại được thay vì prompt ứng biến. Skill này đặc biệt hữu ích cho các nhóm muốn nâng chất lượng bàn giao từ log, CI thất bại và bug report sang một kế hoạch sửa lỗi rõ ràng.

Điểm khác biệt của skill này

Giá trị chính nằm ở tính kỷ luật: tái hiện trước, giữ lại bằng chứng, chẩn đoán theo thứ tự, rồi xác minh bản sửa và ngăn tái diễn. Cách này sẵn sàng ra quyết định hơn một prompt chung chung kiểu “debug cái này”, vì nó nói rõ agent phải hành xử thế nào khi lần thử đầu không thành.

Cách dùng skill debugging-and-error-recovery

Cài đặt và nạp skill

Dùng luồng cài đặt debugging-and-error-recovery từ repo manager, rồi bắt đầu bằng việc đọc SKILL.md. Trong repository này không có script hỗ trợ hay thư mục phụ trợ, nên skill được cố ý giữ nhẹ, tập trung vào một quy trình rõ ràng thay vì một toolchain lớn.

Biến một lỗi mơ hồ thành prompt có thể dùng được

Cách dùng debugging-and-error-recovery hiệu quả nhất là cung cấp sẵn ba thứ: triệu chứng, bằng chứng và ranh giới. Ví dụ, thay vì nói “sửa app của tôi”, hãy nói: “npm test fails trên user-auth.spec.ts sau commit abc123; đây là stack trace, hành vi mong đợi và lần chạy cuối cùng còn tốt.” Như vậy skill có đủ ngữ cảnh để tái hiện và triage thay vì tự dựng ra một giả thuyết.

Quy trình gợi ý để đạt kết quả tốt nhất

Hãy bắt đầu bằng việc yêu cầu agent giữ lại bằng chứng và tái hiện vấn đề trước khi sửa code. Sau đó để nó đi qua các bước triage theo đúng thứ tự: tái hiện, khoanh vùng, xem các thay đổi gần đây, xác định nguyên nhân gốc, sửa tối thiểu, rồi xác minh. Quy trình này quan trọng vì skill được tối ưu cho debugging-and-error-recovery, không phải để mở rộng tính năng hay refactor diện rộng.

Đọc các file repository này trước

Với repo này, file đầu tiên cần đọc là SKILL.md. Không có reference, rule hay script bổ sung nào khác để tham khảo, nên việc áp dụng khá đơn giản nhưng đồng thời cũng có nghĩa là bạn phải tự cung cấp các ràng buộc, command và thông tin môi trường cụ thể của dự án trong prompt.

Câu hỏi thường gặp về skill debugging-and-error-recovery

Skill này có tốt hơn prompt debug thông thường không?

Thường là có, nếu bạn cần sự nhất quán. Một prompt bình thường có thể yêu cầu sửa lỗi, nhưng debugging-and-error-recovery bổ sung một quy trình: dừng lại, giữ bằng chứng, tái hiện, chẩn đoán theo thứ tự và xác minh. Điều đó giảm bớt kiểu “sửa nhanh” vốn hay che mất vấn đề thật.

Khi nào tôi không nên dùng nó?

Đừng dùng cho công việc kiến trúc mang tính giả định, lập kế hoạch tính năng, hoặc các nhiệm vụ không có lỗi quan sát được. Nếu bạn đang khám phá các phương án thiết kế thay vì khôi phục từ một error, hướng dẫn debugging-and-error-recovery có thể quá chặt cho công việc đó.

Skill này có thân thiện với người mới không?

Có, vì quy trình được nêu rất rõ. Người mới được lợi từ việc skill nói rõ cần thu thập gì và nên điều tra theo thứ tự nào. Hạn chế chính là người mới vẫn phải đưa ra một triệu chứng thực, chứ không chỉ một yêu cầu hỗ trợ chung chung.

Nó có phù hợp với workflow của agent phổ biến không?

Có. Nó phù hợp khi agent có quyền truy cập vào log, test, diff và một môi trường có thể chạy được. Nó kém hữu ích hơn nếu agent không thể xem bằng chứng hoặc xác minh thay đổi, vì vòng lặp khôi phục phụ thuộc vào phản hồi.

Cách cải thiện skill debugging-and-error-recovery

Cung cấp đầu vào lỗi mạnh hơn

Cách tốt nhất để cải thiện đầu ra của debugging-and-error-recovery là đưa vào đúng mode failure, command gây lỗi, kết quả mong đợi, kết quả quan sát được và các thay đổi gần đây. Ví dụ: “pnpm test chỉ fail trên Linux sau khi nâng cấp zod; đây là diff và stack trace.” Như vậy phạm vi tìm kiếm sẽ được thu hẹp ngay lập tức.

Giữ lại ngữ cảnh mà skill có thể hành động

Hãy cung cấp log, ảnh chụp màn hình, bước tái hiện, thông tin môi trường và bất kỳ baseline tốt nào đã biết. Skill hoạt động tốt hơn khi nó có thể so sánh “trước” và “sau” thay vì bắt đầu từ một mô tả trống rỗng. Nếu lỗi xảy ra không thường xuyên, hãy nói rõ và giải thích điều gì làm nó dễ xuất hiện hơn.

Yêu cầu bản sửa tối thiểu và bước xác minh

Một prompt dùng debugging-and-error-recovery mạnh nên yêu cầu bản sửa nhỏ nhất an toàn có thể, cộng với kế hoạch xác minh hoặc cập nhật test. Cách này giúp tránh sửa quá tay và làm đầu ra phù hợp hơn cho các nhóm coi trọng tính ổn định.

Lặp lại sau lần thử đầu tiên

Nếu lần đầu chưa kết luận được, hãy tinh chỉnh prompt bằng bằng chứng tốt nhất tiếp theo: bước tái hiện được thu hẹp hơn, stack trace cụ thể hơn, hoặc đúng file path đang bị nghi ngờ. Skill debugging-and-error-recovery cải thiện tốt nhất khi mỗi vòng lặp đều làm giảm độ bất định thay vì chỉ lặp lại cùng một triệu chứng.