audit

Tổng quan

Kỹ năng audit là gì?

audit là công cụ chuyên biệt để thực hiện các kiểm tra chất lượng kỹ thuật có hệ thống trên mã nguồn frontend. Nó tập trung vào năm lĩnh vực chính: truy cập, hiệu suất, chủ đề, thiết kế đáp ứng và các mẫu chống hiệu quả. 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à cung cấp kế hoạch hành động để khắc phục. Điều này giúp các nhóm đảm bảo tiêu chuẩn cao về truy cập web, tối ưu hiệu suất và chất lượng frontend tổng thể.

Ai nên sử dụng audit?

audit được thiết kế cho các nhà phát triển frontend, nhà thiết kế UI/UX và các trưởng nhóm kỹ thuật cần đánh giá và ghi nhận chất lượng giao diện web. Nó đặc biệt hữu ích khi bạn muốn có một cuộc kiểm tra rõ ràng, khách quan về các vấn đề ở cấp mã trước khi bắt đầu khắc phục hoặc đánh giá thiết kế sâu hơn.

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

• Xác định các thiếu sót về truy cập (ví dụ: độ tương phản, ARIA, điều hướng bằng bàn phím)
• Phát hiện các điểm nghẽn hiệu suất
• Kiểm tra tính nhất quán của chủ đề
• Đánh giá việc triển khai thiết kế đáp ứng
• Phát hiện các mẫu chống hiệu quả phổ biến trong frontend

Cách sử dụng

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

1. Cài đặt kỹ năng audit:
   Sử dụng lệnh sau để thêm kỹ năng vào dự án của bạn:

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

2. Xem lại các tệp chính:

   • Bắt đầu với SKILL.md để có tổng quan đầy đủ về kỹ năng và hướng dẫn sử dụng.
   • Kiểm tra README.md, AGENTS.md và metadata.json để xem tài liệu hỗ trợ.
   • Khám phá các thư mục rules/, resources/, references/ và scripts/ để có thêm ngữ cảnh và các script trợ giúp.

Thực hiện kiểm tra audit

• Chuẩn bị:
  • Gọi /frontend-design trước để thu thập ngữ cảnh thiết kế và đảm bảo các mẫu chống hiệu quả cùng nguyên tắc được tải.
  • Nếu chưa có ngữ cảnh thiết kế, chạy /teach-impeccable theo hướng dẫn trong tài liệu kỹ năng.
• Thực thi kiểm tra:
  • Chạy kỹ năng audit với tham số phù hợp (ví dụ: tên tính năng, trang hoặc thành phần).
  • Kỹ năng sẽ quét mã nguồn và xuất báo cáo JSON với điểm số và mức độ nghiêm trọng cho từng khía cạnh.
• Bước tiếp theo:
  • Sử dụng báo cáo để ưu tiên sửa lỗi. Kỹ năng audit ghi nhận các vấn đề nhưng không tự động sửa.

Khi nào nên dùng audit

• Trước các bản phát hành lớn hoặc đánh giá mã
• Khi tiếp nhận dự án hoặc nhóm mới
• Là một phần của quy trình tích hợp liên tục để đảm bảo chất lượng frontend

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

Kỹ năng audit kiểm tra những gì?

Kỹ năng audit xem xét có hệ thống các khía cạnh truy cập, hiệu suất, chủ đề, thiết kế đáp ứng và các mẫu chống hiệu quả trong mã frontend của bạn. Nó tạo báo cáo có điểm số với đánh giá mức độ nghiêm trọng và khuyến nghị hành động.

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

Không, audit chỉ xác định và ghi nhận các vấn đề kỹ thuật mà không tự động sửa. Hãy dùng báo cáo để hướng dẫn việc khắc phục bằng công cụ khác hoặc cập nhật thủ công.

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

Không, audit tập trung vào các khía cạnh đo lường được ở cấp mã của chất lượng frontend. Để đánh giá thiết kế, hãy sử dụng các kỹ năng hoặc quy trình bổ sung.

Tôi có thể tìm thêm thông tin ở đâu?

Mở tab Files trong kho lưu trữ để khám phá toàn bộ tài liệu hỗ trợ, bao gồm các tham chiếu lồng nhau và script trợ giúp. Bắt đầu với SKILL.md để có hướng dẫn phù hợp nhất.