audit

개요

audit 스킬이란?

audit 스킬은 프론트엔드 개발자와 팀이 코드베이스의 기술 품질을 체계적으로 평가할 수 있도록 설계되었습니다. 접근성(A11y), 성능, 테마 일관성, 반응형 디자인, 일반적인 안티패턴을 점검합니다. 이 스킬은 심각도 등급(P0-P3)과 실행 가능한 계획이 포함된 점수화된 보고서를 생성하여 개선 우선순위를 정하고 높은 품질 기준을 유지하도록 돕습니다.

누가 audit를 사용해야 하나요?

• 코드 품질 검증을 원하는 프론트엔드 엔지니어
• 접근성과 성능에 중점을 둔 QA 팀
• 준수 준비나 출시를 앞둔 프로젝트 리더
• 구조화된 코드 수준 감사를 필요로 하는 모든 분 (디자인 평가는 아님)

해결하는 문제들

• 접근성 격차 식별 (대비, ARIA, 키보드 내비게이션, 시맨틱 HTML, 대체 텍스트, 폼)
• 성능 병목 현상 발견
• 테마 및 반응형 디자인 문제 강조
• 안티패턴 및 기술 부채 탐지
• 명확한 심각도 등급과 다음 단계 제공

사용 방법

설치 단계

1. 다음 명령어로 audit 스킬을 설치하세요:

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

2. 자세한 지침과 점수 기준은 SKILL.md 파일을 확인하세요.

준비

• audit 실행 전 /frontend-design을 호출하여 디자인 컨텍스트와 안티패턴을 수집하세요. 디자인 컨텍스트가 없으면 먼저 /teach-impeccable을 실행하세요.
• audit 스킬은 측정 가능한 기술적 측면에 집중하며, 문제를 직접 수정하지 않고 후속 조치를 위해 문서화합니다.

audit 실행

• 스킬을 사용해 프론트엔드 코드베이스를 스캔하세요. 다섯 가지 핵심 영역을 점검합니다:
  • 접근성 (A11y)
  • 성능
  • 테마
  • 반응형 디자인
  • 안티패턴
• 각 영역은 0점(치명적 문제)부터 4점(우수 준수)까지 점수화됩니다.
• 결과는 심각도 등급(P0-P3)과 실행 가능한 권장사항이 포함된 종합 보고서로 제공됩니다.

파일 구조 및 검토

• 워크플로우와 점수 세부사항은 SKILL.md에서 시작하세요.
• 추가 컨텍스트를 위해 README.md, AGENTS.md, metadata.json 및 rules/, resources/, references/, scripts/ 폴더를 살펴보세요.

자주 묻는 질문

audit는 디자인 리뷰에 적합한가요?

아니요. audit 스킬은 코드 수준의 기술 점검을 수행합니다. 디자인 평가는 /frontend-design 또는 관련 스킬을 사용하세요.

audit 보고서에는 무엇이 포함되나요?

접근성, 성능, 테마, 반응형 디자인, 안티패턴을 다루며, 각 항목은 점수화되고 심각도에 따라 우선순위가 지정됩니다.

audit가 문제를 자동으로 수정할 수 있나요?

아니요. audit는 문제를 문서화하고 실행 가능한 계획을 제공합니다. 발견된 문제는 다른 스킬이나 수동으로 수정해야 합니다.

점수 기준은 어디서 확인할 수 있나요?

점수 세부사항과 체크리스트는 SKILL.md에 있습니다. 전체 파일 트리와 도움 스크립트는 Files 탭에서 확인하세요.

언제 audit를 사용해야 하나요?

출시 전, 준수 점검 시, 또는 정기적인 코드 품질 검토의 일환으로 사용하여 프론트엔드가 기술 기준을 충족하는지 확인하세요.