wtorreshome/audit-core

audit-core은(는) 무엇을 하나요?

웹 DOM을 감사하여 접근성 문제를 식별하고, 개발자가 규정을 준수할 수 있도록 명확하고 구조화된 결과를 제공합니다.

개요

이 기술은 웹 페이지의 DOM을 분석하여 접근성 위반 사항을 자동으로 감지합니다. 감사는 다양한 접근성 범주(예: ARIA, 색상 대비, 키보드 접근성)를 다루며, 결과는 JSON 형식으로 반환됩니다.

사용법

AI 에이전트(예: Claude Code, Cursor, Codex)와 함께 이 기술을 사용하려면 다음 지침을 따르세요.

입력

• 분석할 웹 페이지의 URL 또는 HTML 콘텐츠.

출력

• 구조화된 JSON 결과로, 각 발견 사항에 다음 정보가 포함됩니다:
  • 문제 유형
  • 심각도(예: 'critical', 'serious', 'moderate', 'minor')
  • 영향을 받는 DOM 요소 (CSS 선택자)
  • 문제 설명
  • 수정 제안

예시

{
  "issues": [
    {
      "type": "color-contrast",
      "severity": "serious",
      "selector": "#header .title",
      "description": "텍스트 색상이 배경과 충분한 대비를 이루지 못합니다.",
      "suggestion": "텍스트 색상을 #333333 이상으로 어둡게 하거나 배경을 더 밝게 하십시오."
    },
    {
      "type": "missing-alt-text",
      "severity": "critical",
      "selector": "img.banner",
      "description": "이미지에 대체 텍스트 속성이 누락되었습니다.",
      "suggestion": "alt=\"회사 로고\"와 같이 설명적인 텍스트를 추가하세요."
    }
  ]
}

지원되는 플랫폼

• Claude Code
• Cursor
• Codex (GitHub Copilot)
• 기타 AI 에이전트

설정

기본 동작을 변경하려면 환경 변수를 설정할 수 있습니다:

export AUDIT_SEVERITY_THRESHOLD=serious  # 'critical', 'serious', 'moderate', 'minor' 중 선택
export AUDIT_OUTPUT_FORMAT=json         # 현재는 JSON만 지원
export AUDIT_INCLUDE_BEST_PRACTICES=true # 권장 사항 포함 여부

참고 사항

• 감사 결과는 WCAG 2.1 AA 수준 지침을 기반으로 합니다.
• 감사는 정적 DOM 분석을 수행하므로 동적 콘텐츠는 완전히 포착되지 않을 수 있습니다.
• 최상의 결과를 위해 렌더링된 페이지에서 감사를 실행하세요.