investigate

Tổng quan về skill investigate

Skill investigate làm gì

Skill investigate dùng cho debug có hệ thống và phân tích nguyên nhân gốc khi thứ gì đó bị hỏng, chập chờn hoặc hoạt động khác với kỳ vọng. Skill này phù hợp với người dùng cần nhiều hơn một bản vá nhanh: nếu bạn muốn hiểu vì sao lỗi xảy ra, điều gì đã thay đổi và cách sửa nào là an toàn, investigate sẽ giúp bạn cấu trúc công việc đó.

Ai nên dùng

Hãy dùng skill investigate cho code review, xử lý sự cố, sửa lỗi và những tình huống kiểu “hôm qua vẫn chạy”. Đây là lựa chọn rất phù hợp khi bạn cần agent ngừng đoán mò, thu thập bằng chứng và đi từ triệu chứng đến nguyên nhân đã được xác nhận trước khi đụng vào code.

Điểm nổi bật của nó

Khác biệt cốt lõi là quy tắc “không sửa nếu chưa tìm ra nguyên nhân gốc”. Điều đó khiến skill investigate kỷ luật hơn một prompt debug thông thường: nó đẩy quy trình đi theo hướng điều tra, phân tích, đặt giả thuyết rồi mới triển khai, thay vì nhảy thẳng vào chỉnh sửa. Skill này cũng hỗ trợ kích hoạt chủ động, rất hữu ích trong workflow agent khi skill cần bật lên ngay khi xuất hiện lỗi hoặc stack trace.

Cách dùng skill investigate

Cài đặt và gọi skill

Cài skill investigate bằng:

npx skills add garrytan/gstack --skill investigate

Hãy dùng nó khi prompt của bạn mô tả rõ một trạng thái lỗi, chẳng hạn stack trace, lỗi 500, regression hoặc output bất thường. Để đạt kết quả tốt nhất, hãy nêu rõ triệu chứng, chỗ nó xuất hiện và trạng thái “đúng” cần trông như thế nào.

Cung cấp đầu vào khởi điểm đúng

Một prompt dùng skill investigate tốt nên có:

• thông báo lỗi chính xác hoặc trích đoạn log
• lệnh, endpoint hoặc thao tác người dùng kích hoạt lỗi
• những gì đã thay đổi gần đây
• những gì bạn đã kiểm tra
• mức độ ảnh hưởng và tính khẩn cấp

Ví dụ: “Hãy investigate vì sao npm test giờ thất bại trong CI sau lần merge gần nhất. So sánh main với HEAD, kiểm tra các thay đổi gần đây trong auth middleware, và đừng đề xuất đổi code cho đến khi nguyên nhân gốc được xác nhận.”

Đọc đúng file trước

Bắt đầu với SKILL.md, rồi xem SKILL.md.tmpl nếu có logic dùng template hoặc routing. Vì repository này không có các thư mục riêng như rules/, resources/ hay scripts/, giá trị chính nằm ở chính file skill và mọi tham chiếu nội tuyến mà nó có. Với investigate cho Code Review, hãy đặc biệt chú ý ngôn ngữ trigger và các ranh giới quanh thao tác an toàn trước khi sửa.

Mẹo quy trình giúp đầu ra tốt hơn

Hãy xem investigate như một workflow ra quyết định, không phải cuộc trò chuyện tự do. Hãy yêu cầu agent:

1. xác định kiểu lỗi,
2. thu thập bằng chứng hỗ trợ,
3. đưa ra một hoặc hai giả thuyết có thể kiểm chứng,
4. xác minh nguyên nhân có khả năng nhất,
5. triển khai bản sửa nhỏ nhất nhưng an toàn nhất.

Nếu bỏ qua bước 1, skill vẫn có thể sinh phân tích, nhưng sẽ kém hữu ích hơn cho code review hoặc xử lý sự cố.

Câu hỏi thường gặp về skill investigate

investigate chỉ dành cho bug thôi à?

Không. Skill investigate cũng phù hợp với regression, triển khai thất bại, tích hợp bị hỏng và thay đổi hành vi không rõ nguyên nhân. Nếu nhiệm vụ là “tìm xem vì sao chuyện này đang xảy ra”, investigate thường là điểm bắt đầu đúng.

Nó khác gì một prompt thông thường?

Một prompt thông thường có thể yêu cầu sửa ngay. Skill investigate có cấu trúc hơn: nó buộc phải nghĩ về nguyên nhân gốc trước, nhờ đó giảm nguy cơ chỉnh sửa mong manh và giúp thay đổi cuối cùng dễ bảo vệ hơn trong code review.

investigate có phù hợp với người mới không?

Có, nếu người dùng có thể cung cấp một triệu chứng và chút ngữ cảnh. Người mới thường được lợi từ skill này vì nó giảm suy đoán, nhưng họ vẫn cần chia sẻ bằng chứng cụ thể như log, các bước tái hiện, hoặc một lệnh đang fail.

Khi nào không nên dùng?

Đừng dùng investigate khi bạn đã biết chính xác thay đổi mình muốn, hoặc khi chỉ đang sửa nội dung đơn giản mà không có lỗi cần chẩn đoán. Trong các trường hợp đó, một prompt tác vụ đơn giản sẽ nhanh hơn.

Cách cải thiện skill investigate

Cung cấp bằng chứng, không chỉ phàn nàn

Bước nhảy chất lượng lớn nhất đến từ đầu vào sắc hơn. Thay vì nói “app bị hỏng”, hãy đưa request đang fail, văn bản lỗi, file path, môi trường chạy và trạng thái tốt gần nhất. Skill investigate hoạt động tốt nhất khi có thể neo từng giả thuyết vào bằng chứng quan sát được.

Thu hẹp phạm vi tìm kiếm

Nếu sự cố nằm trong Code Review, hãy xác định subsystem có khả năng liên quan và khoảng thay đổi. Ví dụ: “Tập trung vào auth, chỉ xét hai commit gần nhất, và kiểm tra xem bug có tái hiện trong staging không.” Cách này giúp investigate không lan quá rộng và tăng cơ hội tìm ra nguyên nhân gốc nhanh.

Lặp lại sau lần đầu

Nếu câu trả lời đầu tiên chưa kết luận được, hãy yêu cầu một cuộc điều tra hẹp hơn thay vì viết lại theo hướng rộng hơn. Các follow-up tốt là: “Liệt kê ba giả thuyết hàng đầu kèm mức độ tin cậy,” “Cho biết bằng chứng nào sẽ bác bỏ từng giả thuyết,” hoặc “Lần theo lỗi từ input đến output và dừng trước khi viết code.”