audit

개요

audit 스킬이란?

audit는 프런트엔드 코드베이스에 대해 체계적인 기술 품질 검사를 수행하는 전문 도구입니다. 접근성, 성능, 테마, 반응형 디자인, 안티패턴 등 다섯 가지 핵심 영역에 중점을 둡니다. 이 스킬은 P0부터 P3까지 심각도 등급이 포함된 점수화된 보고서를 생성하며, 문제 해결을 위한 실행 가능한 계획도 제공합니다. 웹 접근성, 성능 최적화, 전반적인 프런트엔드 품질에서 높은 기준을 유지하려는 팀에 적합합니다.

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

audit는 프런트엔드 개발자, UI/UX 디자이너, 기술 리드 등 웹 인터페이스 품질을 평가하고 문서화해야 하는 분들을 위해 설계되었습니다. 특히 문제 해결이나 심층 디자인 검토를 시작하기 전에 코드 수준의 문제를 명확하고 객관적으로 감사하고자 할 때 유용합니다.

해결하는 문제

• 접근성 격차 식별(예: 대비, ARIA, 키보드 내비게이션)
• 성능 병목 현상 감지
• 테마 일관성 점검
• 반응형 디자인 구현 평가
• 일반적인 프런트엔드 안티패턴 탐지

사용 방법

설치 단계

1. audit 스킬 설치:
   다음 명령어로 프로젝트에 스킬을 추가하세요:

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

2. 주요 파일 검토:

   • 전체 스킬 개요와 사용법은 SKILL.md에서 확인하세요.
   • 지원 문서는 README.md, AGENTS.md, metadata.json을 참고하세요.
   • 추가 맥락과 도우미 스크립트는 rules/, resources/, references/, scripts/ 폴더를 탐색하세요.

감사 실행

• 준비:
  • 먼저 /frontend-design를 호출해 디자인 컨텍스트를 수집하고 안티패턴 및 원칙을 로드하세요.
  • 디자인 컨텍스트가 없으면 스킬 문서에 안내된 대로 /teach-impeccable을 실행하세요.
• 감사 수행:
  • 관련 인자(예: 기능, 페이지, 컴포넌트 이름)를 사용해 audit 스킬을 실행하세요.
  • 스킬이 코드베이스를 스캔하고 각 영역별 점수와 심각도 수준이 포함된 JSON 보고서를 출력합니다.
• 다음 단계:
  • 생성된 보고서를 활용해 우선순위에 따라 수정하세요. audit 스킬은 문제를 문서화하지만 자동으로 해결하지는 않습니다.

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

• 주요 릴리스나 코드 리뷰 전
• 신규 프로젝트나 팀 온보딩 시
• 프런트엔드 품질 보증을 위한 지속적 통합 과정에서

자주 묻는 질문

audit 스킬은 무엇을 검사하나요?

audit 스킬은 프런트엔드 코드에서 접근성, 성능, 테마, 반응형 디자인, 안티패턴을 체계적으로 검토합니다. 심각도 등급과 실행 가능한 권고사항이 포함된 점수화된 보고서를 출력합니다.

audit가 문제를 자동으로 고치나요?

아니요, audit는 기술적 문제를 식별하고 문서화하지만 자동으로 수정하지는 않습니다. 보고서를 참고해 다른 도구나 수동 업데이트로 문제를 해결하세요.

audit는 디자인 비평에 적합한가요?

아니요, audit는 코드 수준에서 측정 가능한 프런트엔드 품질에 집중합니다. 디자인 비평에는 보완적인 스킬이나 워크플로우를 사용하세요.

더 자세한 정보는 어디서 찾을 수 있나요?

저장소의 파일 탭을 열어 모든 지원 문서와 중첩된 참조, 도우미 스크립트를 탐색하세요. 가장 관련성 높은 안내는 SKILL.md에서 시작하세요.