Dùng hạn mức còn dư cho việc đáng làm

Kiểm tra phần đã viết giúp bạn áp dụng kết quả ngay vào công việc hiện tại.

Phù hợp khi

Có thay đổi chưa commit, chuẩn bị gửi hoặc bàn giao.

Kết quả nhận được

Danh sách vấn đề có bằng chứng, vị trí mã, điều kiện phát sinh và cách sửa.

Hãy rà soát các thay đổi chưa commit trong kho mã hiện tại, gồm cả phần đã và chưa stage, theo chế độ chỉ đọc.
Đọc quy tắc dự án và ngữ cảnh liên quan trước. Tập trung vào lỗi logic, trường hợp biên, quyền truy cập, xử lý đồng thời, tính nhất quán trạng thái và lỗi hồi quy.
Chỉ báo cáo tối đa 5 vấn đề có bằng chứng rõ ràng. Mỗi vấn đề cần mức độ nghiêm trọng, tệp và dòng, điều kiện phát sinh, tác động, cách sửa tối thiểu và cách kiểm chứng.
Không coi cách đặt tên, định dạng hay sở thích cá nhân là lỗi. Nếu không có vấn đề đủ chắc chắn, hãy nói rõ.
Không sửa tệp. Nếu không có thay đổi để rà soát, giải thích rồi dừng, không mở rộng ra toàn bộ kho mã.

Hoàn thành khiMỗi phát hiện gắn với thay đổi và điều kiện cụ thể; không tìm thấy lỗi cũng là kết quả hợp lệ.

Kiểm thử chạy lại được sẽ tiếp tục hữu ích cho các thay đổi sau.

Phù hợp khi

Đang bảo trì dự án mã nguồn có môi trường kiểm thử hoạt động.

Kết quả nhận được

Một kiểm thử quan trọng, kết quả chạy và rủi ro còn chưa được bao phủ.

Đọc quy tắc dự án, mã nguồn và kiểm thử hiện có. Chọn một luồng người dùng quan trọng, phạm vi rõ ràng, rồi xác định khoảng trống kiểm thử thực tế.
Chạy các kiểm thử liên quan trước và ghi lại kết quả ban đầu. Nếu môi trường không dùng được hoặc kiểm thử cũ thất bại, giải thích trở ngại, không quy lỗi cũ cho thay đổi mới.
Chọn một kiểm thử thiếu có giá trị nhất theo tác động nghiệp vụ, triển khai bằng framework hiện có. Kiểm tra hành vi người dùng quan sát được, không chỉ sao chép chi tiết triển khai và không chạy theo tỷ lệ bao phủ.
Chạy kiểm thử mới và kiểm thử hồi quy liên quan. Báo cáo lỗi mà kiểm thử phát hiện được, kết quả và rủi ro còn lại.
Không sửa logic nghiệp vụ đúng chỉ để kiểm thử qua, không tạo hệ thống kiểm thử mới, không commit hoặc triển khai. Hoàn thành một việc này rồi dừng.

Hoàn thành khiKiểm thử chạy được và giải thích rõ lỗi thực tế mà nó giúp phòng tránh.

Giảm thời gian phải tìm lại các bước cũ mỗi khi bắt đầu việc mới hoặc tiếp quản dự án.

Phù hợp khi

Dự án chạy được nhưng tài liệu đã cũ hoặc thường phải giải thích lại.

Kết quả nhận được

Các bước khởi chạy đã xác minh, vai trò thư mục và hướng dẫn xử lý lỗi.

Hãy xác minh tài liệu chạy và bàn giao dự án hiện tại mà không sửa mã nghiệp vụ.
Đọc quy tắc dự án, tài liệu hiện có, khai báo gói và cấu hình. Ưu tiên cập nhật tài liệu sẵn có, tuân thủ nơi lưu tài liệu và không tạo tệp trùng mục đích.
Ghi lệnh cài đặt, khởi chạy, build và kiểm thử; vai trò các thư mục chính; tên biến môi trường cần thiết và cách xử lý lỗi thường gặp. Không ghi bí mật hay thông tin xác thực thật.
Kiểm chứng các lệnh cục bộ an toàn khi môi trường cho phép. Không triển khai, di chuyển dữ liệu hay ghi ra hệ thống bên ngoài. Phân biệt phần đã xác minh, chưa xác minh và cần người xác nhận, kèm bằng chứng từ tệp hoặc lệnh.
Chỉ giữ hướng dẫn ngắn gọn cần cho bảo trì. Không tạo hàng loạt chú thích, tái cấu trúc hoặc nâng cấp phụ thuộc.

Hoàn thành khiNgười khác làm theo để bắt đầu công việc được và biết bước nào đã được kiểm chứng.

Làm một lần rồi tái sử dụng khi sắp xếp tệp hoặc xử lý dữ liệu.

Phù hợp khi

Thường tự làm sạch CSV, sắp xếp log, đổi định dạng tệp hoặc tạo báo cáo theo mẫu.

Kết quả nhận được

Script tối thiểu, hướng dẫn dùng và kết quả kiểm chứng với ví dụ thật.

Hãy giúp tôi biến một thao tác thủ công lặp lại thành script tối thiểu có thể dùng được.
Trước khi viết, hỏi cùng lúc về các bước hiện tại, vị trí một đầu vào thật và đầu ra mong muốn. Chỉ triển khai sau khi có thông tin, không đoán tệp cần xử lý.
Tuân thủ quy tắc dự án, ưu tiên phụ thuộc có sẵn. Hỗ trợ dry-run mặc định, ghi đầu ra thật vào thư mục mới, bảo đảm chạy lại không phá dữ liệu gốc. Không xóa hoặc ghi đè tệp gốc.
Báo lỗi rõ ràng với đầu vào không hợp lệ và ghi log cần thiết. Kiểm chứng bằng một ví dụ đầu vào/đầu ra thật, kèm lệnh chạy và hướng dẫn ngắn.
Không tải dữ liệu lên, gọi dịch vụ trả phí hay ghi ra hệ thống bên ngoài. Hoàn thành luồng này rồi dừng, không mở rộng thành nền tảng đa năng.

Hoàn thành khiChạy lại cùng ví dụ vẫn cho đầu ra đúng và giữ nguyên tệp gốc.

Thao tác thực tế giúp tìm nút không phản hồi, thông báo lỗi và vấn đề bố cục di động.

Phù hợp khi

Có website truy cập được hoặc dự án cục bộ và một luồng muốn kiểm tra.

Kết quả nhận được

Vấn đề tái hiện được, ảnh chụp và các bước kiểm tra lại.

Hãy kiểm tra một luồng người dùng trên website bằng trình duyệt thật.
Xác nhận URL, luồng cần kiểm tra và môi trường thử nghiệm trước. Nếu không có công cụ trình duyệt, nói rõ và cung cấp các bước kiểm tra thủ công, không khẳng định đã thao tác.
Kiểm tra đầu vào đúng, trống và sai; trạng thái tải và thất bại; bố cục di động; thao tác bàn phím; lỗi console và yêu cầu mạng thất bại.
Với việc gửi tin, thanh toán, xuất bản hoặc đổi dữ liệu thật, dừng trước khi gửi và dùng môi trường thử nghiệm hoặc hỏi tôi xác nhận.
Báo cáo tối đa 3 vấn đề quan trọng, kèm bước tái hiện, hành vi mong đợi và thực tế, ảnh chụp. Nếu không thấy lỗi, nêu phạm vi đã kiểm tra.
Chỉ kiểm tra luồng này, không sửa mã nghiệp vụ. Để lại các bước kiểm tra lại có thể lặp lại.

Hoàn thành khiMỗi vấn đề có cách tái hiện và ảnh chụp khớp với phạm vi đã kiểm tra thực tế.

Xác định phạm vi, mã liên quan và tiêu chí nghiệm thu giúp lần triển khai sau bắt đầu dễ hơn.

Phù hợp khi

Có ý tưởng tính năng nhưng chưa chốt cách triển khai.

Kết quả nhận được

Kế hoạch triển khai dựa trên dự án hiện tại và tiêu chí nghiệm thu.

Hãy lập kế hoạch triển khai khả thi cho tính năng tiếp theo, không sửa mã nghiệp vụ trong lần này.
Trước tiên hỏi tôi về vấn đề cần giải quyết và hành vi người dùng mong muốn. Sau đó đọc quy tắc và phần triển khai liên quan của dự án, không tưởng tượng hệ thống chưa tồn tại.
Mô tả hành vi hiện tại và mục tiêu, phạm vi và phần loại trừ, mô-đun liên quan, lựa chọn và đánh đổi chính, rủi ro tương thích, cách kiểm chứng.
Chia việc thành bước nhỏ nghiệm thu độc lập được, mỗi bước có tiêu chí người dùng quan sát được. Ghi rõ điều chưa biết, không coi giả định là sự thật.
Lưu kế hoạch ngắn theo quy tắc lưu tài liệu nội bộ. Hoàn thành kế hoạch rồi dừng, không viết mã hay triển khai.

Hoàn thành khiMỗi bước có điểm kết thúc rõ ràng và các điểm chưa biết quan trọng được ghi ra.

Ngay cả khi không có mã cần viết, thông tin sẵn có vẫn có thể trở thành tài liệu dùng lại.

Phù hợp khi

Có ghi chú họp, bản nháp, hồ sơ dự án hoặc hướng dẫn rời rạc.

Kết quả nhận được

Tài liệu có cấu trúc, danh sách cần xác nhận và việc cần làm.

Hãy sắp xếp một nhóm tư liệu hiện có. Trước tiên xác nhận vị trí và mục đích sử dụng sau khi sắp xếp, không đọc thư mục không liên quan.
Giữ nguyên bản gốc và ghi kết quả vào tài liệu mới theo quy tắc của không gian làm việc.
Gộp thông tin trùng, tổ chức theo chủ đề và phân biệt sự thật, ý kiến, quyết định, điều cần xác nhận. Ghi tệp hoặc đoạn nguồn cho kết luận quan trọng.
Đánh dấu mâu thuẫn và thông tin thiếu, không bịa sự thật, ngày tháng hay số liệu. Chỉ trích việc cần làm đã có trong tư liệu, không tự tạo người phụ trách hoặc hạn chót.
Xuất nội dung đã sắp xếp, danh sách cần xác nhận và mục lục ngắn. Kiểm tra kết luận chính truy về được tài liệu gốc, không tải tư liệu lên.

Hoàn thành khiKết luận quan trọng truy được nguồn, mâu thuẫn và thiếu sót không bị âm thầm xóa đi.

Thay việc dò từng dòng bằng một báo cáo chất lượng dữ liệu có căn cứ.

Phù hợp khi

Có CSV hoặc bảng tính cần kiểm tra trước khi tổng hợp, nhập hay phân tích.

Kết quả nhận được

Danh sách bất thường, cơ sở đánh giá và đề xuất làm sạch nếu cần.

Hãy kiểm tra chất lượng dữ liệu trong CSV hoặc bảng tính tôi chỉ định.
Xác nhận vị trí tệp, ý nghĩa trường và quy tắc nghiệp vụ chính trước. Nếu chưa có quy tắc, bắt đầu bằng kiểm tra mô tả, không tự coi giá trị ngoại lệ là lỗi.
Kiểm tra bản ghi trùng, giá trị thiếu, kiểu dữ liệu không nhất quán, định dạng ngày và giá trị vượt quy tắc đã biết.
Với mỗi loại phát hiện, nêu số lượng, dòng hoặc mã bản ghi, cơ sở đánh giá và tác động có thể có. Tránh trình bày thông tin cá nhân không cần thiết.
Không xóa, ghi đè, tải bản gốc lên hoặc tự điền dữ liệu thiếu. Xuất báo cáo bất thường và đề xuất quy tắc làm sạch, đồng thời đối chiếu tổng số bản ghi.
Lần này chỉ kiểm tra. Chờ xác nhận quy tắc làm sạch trước khi xử lý tiếp.

Hoàn thành khiMỗi bất thường có vị trí và căn cứ, dữ liệu gốc không bị thay đổi.