audit

Tổng quan

audit skill là gì?

audit skill được thiết kế cho các nhà phát triển frontend và nhóm cần đánh giá hệ thống chất lượng kỹ thuật của mã nguồn. Nó kiểm tra khả năng truy cập (A11y), hiệu suất, sự nhất quán về chủ đề, thiết kế đáp ứng và các mẫu chống chỉ định phổ biến. Kỹ năng này tạo ra báo cáo có điểm số với đánh giá mức độ nghiêm trọng (P0-P3) và kế hoạch hành động, giúp bạn ưu tiên cải tiến và duy trì tiêu chuẩn cao.

Ai nên sử dụng audit?

• Kỹ sư frontend muốn xác thực chất lượng mã
• Nhóm QA tập trung vào khả năng truy cập và hiệu suất
• Trưởng dự án chuẩn bị cho việc tuân thủ hoặc ra mắt
• Bất kỳ ai cần đánh giá mã có cấu trúc, không phải đánh giá thiết kế

Các vấn đề được giải quyết

• Xác định các khoảng trống về khả năng truy cập (độ tương phản, ARIA, điều hướng bàn phím, HTML ngữ nghĩa, văn bản thay thế, biểu mẫu)
• Phát hiện các nút thắt hiệu suất
• Làm nổi bật các vấn đề về chủ đề và thiết kế đáp ứng
• Phát hiện các mẫu chống chỉ định và nợ kỹ thuật
• Cung cấp đánh giá mức độ nghiêm trọng rõ ràng và các bước tiếp theo

Cách sử dụng

Các bước cài đặt

1. Cài đặt audit skill bằng lệnh:

   npx skills add https://github.com/pbakaus/impeccable --skill audit
   

2. Xem file SKILL.md để biết hướng dẫn chi tiết và tiêu chí chấm điểm.

Chuẩn bị

• Trước khi chạy audit, hãy gọi /frontend-design để thu thập ngữ cảnh thiết kế và các mẫu chống chỉ định. Nếu chưa có ngữ cảnh thiết kế, chạy /teach-impeccable trước.
• audit skill tập trung vào các khía cạnh kỹ thuật có thể đo lường; nó không sửa lỗi mà chỉ ghi lại để xử lý sau.

Chạy audit

• Sử dụng kỹ năng để quét mã frontend của bạn. Nó kiểm tra năm khía cạnh chính:
  • Khả năng truy cập (A11y)
  • Hiệu suất
  • Chủ đề
  • Thiết kế đáp ứng
  • Các mẫu chống chỉ định
• Mỗi khía cạnh được chấm điểm từ 0 (vấn đề nghiêm trọng) đến 4 (tuân thủ xuất sắc).
• Kết quả là báo cáo toàn diện với đánh giá mức độ nghiêm trọng (P0-P3) và khuyến nghị có thể hành động.

Cấu trúc file và xem xét

• Bắt đầu với SKILL.md để biết quy trình làm việc và chi tiết chấm điểm.
• Khám phá các file hỗ trợ như README.md, AGENTS.md, metadata.json và các thư mục như rules/, resources/, references/, hoặc scripts/ để có thêm ngữ cảnh.

Câu hỏi thường gặp

audit có phù hợp để đánh giá thiết kế không?

Không. audit skill thực hiện kiểm tra kỹ thuật ở cấp mã. Để đánh giá thiết kế, hãy sử dụng /frontend-design hoặc các kỹ năng liên quan.

Báo cáo audit bao gồm những gì?

Báo cáo bao gồm khả năng truy cập, hiệu suất, chủ đề, thiết kế đáp ứng và các mẫu chống chỉ định, mỗi phần được chấm điểm và ưu tiên theo mức độ nghiêm trọng.

audit có tự động sửa lỗi không?

Không. audit ghi lại các vấn đề và cung cấp kế hoạch hành động. Hãy sử dụng các kỹ năng khác hoặc sửa thủ công để xử lý các phát hiện.

Tôi có thể tìm tiêu chí chấm điểm ở đâu?

Chi tiết chấm điểm và danh sách kiểm tra nằm trong SKILL.md. Mở tab Files để xem toàn bộ cây thư mục và các script hỗ trợ.

Khi nào nên sử dụng audit?

Sử dụng audit trước khi ra mắt, kiểm tra tuân thủ hoặc như một phần của đánh giá chất lượng mã định kỳ để đảm bảo frontend của bạn đáp ứng tiêu chuẩn kỹ thuật.