완성 페이지 KWCAG 재검사
validate_pageValidates rendered pages against KWCAG 2.2 in a real browser, translating axe-core results into 33 criteria and flagging items that need manual review.
Instructions
조립·변환이 끝난 페이지를 실제 브라우저로 열어 KWCAG 2.2 기준으로 재검사한다. axe-core 전수 실행을 KWCAG 33항목으로 번역하고, 보류된 명도 대비는 직접 실측하며, 수동 확인이 필요한 항목은 확인 절차와 함께 명시한다 — 자동 판정은 접근성 이슈의 일부이므로 이 도구의 통과가 심사 통과를 뜻하지 않는다. 템플릿을 프레임워크로 변환한 뒤, 페이지를 조립한 뒤, 콘텐츠를 채운 뒤에 호출하라. url(dev 서버·배포본) 또는 filePath(로컬 HTML)를 권장한다 — 상대 경로 자산이 그대로 해석된다. 파일을 쓴다: outDir(기본 reports/) 아래 화면별 폴더에 리포트(md)·원시 데이터(json)·스크린샷 2장을 남기고 SUMMARY.md를 갱신한다. keepRuns를 주면 보존 개수를 넘은 이전 검사 기록을 지운다. 이 기록을 Stop 훅과 gate 명령이 읽어 작업 종료를 판정한다. 요소 하나의 색·배치·폰트만 확인할 때는 inspect_page를 쓴다. 반환: 마크다운 — 결론 한 줄(위반 수·검사 무효·공통부 누락), 직전 대비, KRDS 사용 문제, 리소스 오류, 산출물 경로, 리포트 전문.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "validate_page"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | 검사할 페이지 URL(http/https) — dev 서버·배포본. url·filePath·html 중 정확히 하나만 준다 | |
| html | No | HTML 문자열 — 상대 경로 자산이 깨지므로 최후 수단(임시 파일로 써서 검사한다). url·filePath·html 중 정확히 하나만 준다 | |
| outDir | No | 리포트·스크린샷 저장 디렉터리(기본 reports/, 프로젝트 루트 기준) — 화면별 하위 폴더에 검사 이력이 쌓인다. gate·Stop 훅은 reports/를 읽으니 바꾸지 않는 것을 권장 | |
| screen | No | 화면 이름 — 검사 기록 폴더 이름이 된다. 같은 화면을 호스트·포트를 바꿔 검사해도 이력이 이어지고, 상태 화면(actions)은 다른 이름으로 따로 기록하라 — 예: "apply-form", "apply-form-오류". 없으면 url·파일 이름에서 만든다 | |
| actions | No | 검사 전에 실행할 상호작용(순서대로, 실제 클릭·키 입력) — 모달 열림·탭 전환·오류 표시 같은 상태 화면을 검사할 때. click·fill은 selector, fill은 value, press는 key(Enter·Escape·ArrowRight 등, selector를 주면 그 요소에 초점 뒤), wait는 selector(보일 때까지) 또는 ms. 예: [{type:"click",selector:"#apply"},{type:"wait",selector:".form-hint-invalid"}]. 한 단계라도 실패하면 검사 무효로 기록돼 gate가 막는다. 임시 빌드로 초기값을 바꾸지 말고 이것을 쓴다 | |
| filePath | No | 검사할 로컬 HTML 파일 경로 — 상대 경로는 프로젝트 루트(MCP 서버 실행 위치) 기준. url·filePath·html 중 정확히 하나만 준다 | |
| keepRuns | No | 화면별로 남길 최근 검사 수 — 첫 회(기준 증빙)는 항상 따로 남기므로 결과는 첫 회 + 최근 N회(최대 N+1개)다. 미지정이면 환경 변수 KRDS_A11Y_KEEP_RUNS, 그것도 없으면 전부 보존 | |
| sourceDir | No | url(dev 서버·배포본)을 검사할 때 그 화면을 만드는 소스 폴더(프로젝트 루트 기준) — 예: "src", ["src", "public"], JSP는 "src/main/webapp". 넘기면 gate가 검사 뒤 소스가 바뀌었는지(낡음)를 판정해 재검사를 요구한다. 없으면 url 검사의 낡음은 판정 불가 |