사이트 검수 스킬 (site-review) — 기능과 링크를 실제로 점검

site-review는 반복 업무를 더 안정적으로 처리하기 위한 AI 에이전트 스킬입니다.

사용자가 “정밀검수”, “사이트 검수해줘”, “웹사이트 QA 해줘”, “모든 버튼/URL/기능 검수해줘”, “콘텐츠 맥락까지 검수해줘”, “링크/동작/사용성 검토해줘”, “출시 전 점검해줘”, “AI로 만든 사이트가 제대로 만들어졌는지 봐줘”라고 요청할 때 사용한다. 웹사이트의 IA, 모든 링크/버튼/CTA/폼/기능, 인증 흐름, 반응형 화면, 접근성, 콘텐츠 맥락, SEO 기본 품질, 실제 사용자 흐름을 증거 기반으로 검토하고 치명도별 이슈와 수정 우선순위를 제시한다.

사용 방법

Codex나 호환되는 AI 에이전트의 스킬 폴더에 아래 SKILL.md 내용을 저장한 뒤, 설명에 포함된 트리거 문장으로 호출하세요.

사용 예:
site-review 스킬 사용해줘.
이 작업은 site-review 기준으로 진행해줘.

연관스킬

이 스킬과 함께 쓰면 좋은 관련 스킬입니다.

원본 위치

.codex/skills/site-review/SKILL.md

SKILL.md

---
name: site-review
description: 사용자가 “정밀검수”, “사이트 검수해줘”, “웹사이트 QA 해줘”, “모든 버튼/URL/기능 검수해줘”, “콘텐츠 맥락까지 검수해줘”, “링크/동작/사용성 검토해줘”, “출시 전 점검해줘”, “AI로 만든 사이트가 제대로 만들어졌는지 봐줘”라고 요청할 때 사용한다. 웹사이트의 IA, 모든 링크/버튼/CTA/폼/기능, 인증 흐름, 반응형 화면, 접근성, 콘텐츠 맥락, SEO 기본 품질, 실제 사용자 흐름을 증거 기반으로 검토하고 치명도별 이슈와 수정 우선순위를 제시한다.
---

# Site Review

## 버전

- v1.2.3 (2026-07-15): 단일 오류를 발견했을 때 같은 종류의 버튼, URL, 템플릿, 라우트, 프록시/정적 경로 충돌까지 확산 검수하는 규칙을 추가했다. 검수자가 사용자의 단건 지적을 기다리지 않도록 동일 패턴 검색과 재검수 증거 기록을 필수화했다.
- v1.2.2 (2026-07-14): 로그인 후 작성/수정 에디터의 다크모드, 툴바 아이콘 노출, 아이콘 폰트/SVG 대비 검수 항목을 추가했다. 공개 페이지 중심 검수로 인증 후 에디터 UI 버그를 놓치지 않도록 원인-방지 규칙을 보강했다.
- v1.2.1 (2026-07-14): 대량 URL 순회 시 요청 간격을 두고 429/rate limit과 실제 링크 오류를 구분하는 규칙을 추가했다.
- v1.2.0 (2026-07-14): “정밀검수” 요청어, 모든 버튼/URL/기능/콘텐츠 맥락 검수, 카테고리별 100점 점수표, 사용방법 예시를 추가했다.
- v1.1.0 (2026-07-14): 로그인, 회원가입, 비밀번호 찾기, 소셜 로그인, 로그아웃, 로그인 후 복귀 URL 검수를 필수 항목으로 추가했다.
- v1.0.0 (2026-07-14): IA, 링크, 기능, 반응형, 접근성, 콘텐츠 신뢰도 기반 사이트 QA 검수 기준을 추가했다.

## 목적

- AI나 개발자가 만든 사이트를 출시 전 관점에서 검수한다.
- “화면이 그럴듯한지”보다 사용자가 실제 목표를 달성할 수 있는지를 우선 확인한다.
- 링크, 기능, UX, 반응형, 콘텐츠, 신뢰 요소를 한 번에 점검하고 수정 우선순위를 만든다.
- 사용자가 **정밀검수**라고 요청하면 모든 주요 URL, 버튼, 링크, CTA, 폼, 드롭다운, 탭, 필터, 검색, 페이지네이션, 인증/권한 흐름, 콘텐츠 맥락, SEO 기본값까지 포함해 검수한다.

## 절대 규칙

- 이 스킬은 기본적으로 **검토와 리포트**를 수행한다. 사용자가 명시적으로 “수정까지 진행해”라고 하기 전에는 파일과 DB를 수정하지 않는다.
- 가능하면 실제 사이트를 브라우저나 HTTP 요청으로 확인한다. 코드만 보고 단정하지 않는다.
- 확인한 사실과 추정한 판단을 구분한다.
- 사소한 취향보다 사용자의 목표 달성, 오류, 이탈, 오해 가능성을 우선한다.
- 메뉴와 UI는 “사람이 이 이름을 보고 기대한 내용이 실제로 나오는가”를 기준으로 평가한다.
- 이슈는 치명도 순서로 제시한다. 좋은 점 요약은 이슈 뒤에 짧게 둔다.
- 하나의 오류를 확인하면 그 오류와 같은 **이슈 클래스**를 반드시 확산 검수한다. 예: 다운로드 링크 1개가 깨지면 모든 다운로드 버튼, 첨부파일 링크, 마켓 다운로드, 라우트 등록 순서, 정적 파일/Nginx location 충돌, 로그인 전후 차이를 함께 확인한다.
- 단건 수정 요청처럼 보여도 사용자가 “검수”를 언급했으면 사용자가 하나씩 다시 지적하지 않도록 같은 패턴의 잔여 위험을 찾아 보고한다.

## 검수 준비

1. 대상 URL, 로컬 실행 방법, 주요 사용자 유형, 핵심 전환 목표를 확인한다.
2. 사용자가 제공하지 않은 경우 코드와 문서에서 사이트 목적, 메뉴, 라우트, 주요 기능을 파악한다.
3. 헤더/푸터/CTA에 로그인, 회원가입, 마이페이지, 글쓰기, 구매, 문의처럼 계정과 연결된 진입점이 있는지 먼저 찾는다.
4. 사이트가 실행 중이 아니면 로컬 실행 방법을 확인하고 가능한 범위에서 실행한다.
5. 로그인이 필요한 기능은 테스트 계정이 있는지 확인한다. 없으면 비로그인 흐름과 권한 안내만 검수한다.
6. 테스트 계정이 없어도 로그인/회원가입 화면의 렌더링, 필수값 검증, 잘못된 입력 오류, 복귀 URL, 소셜 로그인 버튼, 약관 링크는 가능한 범위에서 반드시 확인한다.

### 0. 정밀검수 모드

사용자가 “정밀검수”라고 요청하면 일반 검수보다 넓은 범위를 기본값으로 삼는다. 사용자가 별도 제외 범위를 말하지 않으면 아래를 모두 포함한다.

- **URL 순회**: 홈, 1뎁스 메뉴, 주요 목록, 상세, 쓰기/수정/삭제 진입, 검색/필터/태그/카테고리, 로그인 필요 URL, sitemap, robots를 확인한다.
- **클릭 대상 순회**: GNB, 모바일 메뉴, 푸터, 카드, CTA, 버튼, 아이콘 버튼, 드롭다운, 탭, 필터, 검색, 페이지네이션, 공유, 추천, 댓글, 첨부, 구매/다운로드/문의 버튼을 확인한다.
- **폼/기능 순회**: 로그인, 회원가입, 비밀번호 찾기, 소셜 로그인 진입, 로그아웃, 글쓰기, 댓글 작성/수정/삭제, 추천 토글, 파일 첨부, 이미지 붙여넣기, 유튜브 임베드, 구매/다운로드/문의 흐름을 확인한다.
- **인증 후 작성 화면**: 글쓰기/수정 화면이 있으면 테스트 계정으로 로그인해 에디터를 직접 열고, 라이트/다크모드에서 툴바 아이콘, 버튼 대비, placeholder, 입력 본문, 첨부/붙여넣기 UI가 보이는지 확인한다.
- **콘텐츠 맥락**: 메뉴명, H1, 리드 문구, 카드 제목/요약, 상세 본문, 빈 상태, CTA, 가격/무료/유료/구매/다운로드/문의 표현, 메타 description, OG, JSON-LD가 같은 의미로 이어지는지 확인한다.
- **증거 기록**: 확인한 URL, 상태코드, 최종 URL, 버튼/링크 라벨, href/action, 기대 동작, 실제 결과, 이슈 등급, 미확인 사유를 남긴다.
- **미확인 처리**: 테스트 계정, 결제 권한, 관리자 권한, 외부 provider 계정이 없어 확인하지 못한 항목은 “미확인”으로 두되 필요한 계정/데이터를 구체적으로 적는다.

정밀검수에서는 단순 점수만 답하지 않는다. 먼저 증거를 수집하고, 표 또는 목록 형태로 결과를 남긴 뒤 점수를 산정한다.

#### 순회 속도와 429 처리

정밀검수에서 많은 URL과 버튼을 확인할 때는 사이트에 부담을 주지 않도록 저속으로 순회한다.

- 기본 URL 순회는 요청 사이에 0.5~2초 간격을 둔다. 운영 사이트, 외부 API, 검색/필터/페이지네이션 대량 순회는 1~3초 간격을 권장한다.
- 먼저 핵심 URL 10~20개를 확인하고, 그 다음 발견 링크를 묶음 단위로 나눠 확인한다.
- 429, 503, timeout이 나오면 즉시 “깨진 링크”로 확정하지 않는다. 요청 속도 문제인지 구분하기 위해 10~60초 대기 후 1~3개 대표 URL만 재확인한다.
- 반복 재확인에서도 같은 사용자가 정상 클릭할 만한 속도에서 429가 나오면 기능/운영 이슈로 기록한다.
- 단시간 크롤링 때문에 발생한 429는 `검수 도구 속도 제한으로 인한 미확인` 또는 `rate limit 확인됨`으로 분리하고 점수 감점은 작게 적용한다.
- 로그인, 댓글, 추천, 첨부, 구매처럼 상태를 바꾸는 기능은 대량 자동 반복하지 않는다. 비로그인 차단, 잘못된 입력, 대표 성공 흐름만 확인한다.
- 삭제, 결제, 대량 등록, 대량 첨부처럼 데이터 변경이 큰 기능은 사용자 승인과 테스트 데이터 없이는 실행하지 않는다.

#### 사용방법

기본 요청:

```text
ai.eond.com 정밀검수해줘.
모든 버튼, URL, 기능, 콘텐츠 맥락까지 확인하고
대상별 카테고리 점수표로 출력해줘.
```

수정 없이 검수만 요청:

```text
ai.eond.com 정밀검수해줘.
이번에는 수정하지 말고 리포트만 줘.
모든 버튼/URL/기능/콘텐츠 맥락/SEO/반응형을 확인하고
카테고리별 점수표, 주요 이슈, 수정 우선순위, 미확인 사유를 정리해줘.
```

테스트 계정이 있는 경우:

```text
ai.eond.com 정밀검수해줘.
테스트 계정:
- 일반 사용자: {아이디} / {비밀번호}
- 관리자: {아이디} / {비밀번호}
- 유료 구매자: {아이디} / {비밀번호}

로그인 전/후, 구매자/비구매자, 관리자/일반 사용자 권한을 나눠서
모든 버튼, URL, 기능, 콘텐츠 맥락을 검수하고 카테고리별 점수표로 출력해줘.
```

## 검수 범위

### 1. IA와 메뉴

- 첫 화면에서 사이트의 목적이 5초 안에 이해되는지 본다.
- GNB, 사이드바, 푸터의 역할이 겹치거나 비어 있지 않은지 확인한다.
- 메뉴명이 실제 콘텐츠와 맞는지 확인한다.
- 현재 위치, 뒤로가기, 목록 복귀, 하위 메뉴 흐름이 자연스러운지 확인한다.

### 1-1. 메뉴 기대치와 화면 맥락

각 1뎁스 메뉴를 실제 사용자 관점으로 하나씩 클릭해 아래 질문에 답한다.

- **기대 일치**: 메뉴명을 보고 기대한 콘텐츠, 기능, 깊이가 첫 화면에 바로 드러나는가?
- **맥락 설명**: 이 페이지가 무엇을 하는 곳인지, 어떤 사람에게 필요한지, 다음에 뭘 하면 되는지 설명 없이 이해되는가?
- **UI 적합성**: 가이드면 아티클/온보딩, 마켓이면 카드/가격/필터, 게시판이면 목록/정렬/검색처럼 페이지 목적에 맞는 UI인가?
- **다음 행동**: 읽기, 목록 보기, 필터, 검색, 글쓰기, 구매/다운로드, 질문하기 같은 주요 행동이 눈에 보이는가?
- **빈 상태**: 콘텐츠가 적거나 없을 때도 “아직 없음”에서 끝나지 않고 대체 행동이나 운영 방향을 안내하는가?
- **현재 위치**: 사용자가 어느 메뉴/필터/카테고리에 있는지 시각적으로 알 수 있는가?
- **초보자/반복 방문자 균형**: 처음 온 사람은 시작점을 찾고, 다시 온 사람은 바로 목록/검색/필터로 갈 수 있는가?

평가할 때는 최소한 `메뉴명 → 사용자가 기대하는 것 → 실제 첫 화면 → 다음 행동 → 불편/오해 지점` 형식으로 기록한다.

### 2. 링크와 라우팅

- GNB, 푸터, CTA, 카드, 버튼, 목록/상세/쓰기 링크를 확인한다.
- 404, 빈 페이지, 잘못된 외부 링크, `#` placeholder, 같은 페이지 무한 이동을 찾는다.
- 외부 링크는 새 창 여부와 `rel="noopener"` 필요성을 확인한다.
- 로그인 필요 링크는 로그인 유도와 복귀 흐름을 확인한다.

### 3. 핵심 기능

- 목록, 상세, 글쓰기/수정, 검색, 필터, 정렬, 페이지네이션, 댓글, 추천, 다운로드, 구매 버튼처럼 사이트 목적에 직접 연결되는 기능을 확인한다.
- 빈 상태, 오류 상태, 권한 없음, 비로그인 상태에서 안내가 충분한지 확인한다.
- 폼은 필수값, 잘못된 입력, 제출 후 이동, 중복 제출 방지를 확인한다.

### 3-0. 이슈 클래스 확산 검수

대표 오류를 하나 발견하면 그 오류를 개별 링크/버튼으로만 기록하지 말고 같은 원인 계열을 찾는다.

- **동일 라벨/행동 검색**: `다운로드`, `구매`, `로그인`, `글쓰기`, `첨부`, `복사`, `삭제`, `저장` 같은 버튼 라벨과 `data-*` 속성, href/action 패턴을 전체 템플릿과 프론트엔드 코드에서 검색한다.
- **동일 URL 패턴 검색**: 깨진 URL의 경로 패턴을 코드 전체에서 검색한다. 예: `/files/{id}/download`가 깨지면 `/api/files/{id}/download`, `/api/market/{id}/download`, 정적 `/files/...` 링크까지 비교한다.
- **라우트 우선순위 확인**: catch-all 라우트, StaticFiles mount, 프록시/Nginx location, 리다이렉트 라우트가 기능 라우트보다 먼저 잡히는지 확인한다.
- **상태별 확인**: 비로그인, 로그인, 구매자/비구매자, 관리자/일반 사용자에 따라 같은 버튼이 다른 결과를 내는지 구분한다.
- **운영 응답 확인**: 가능하면 실제 URL에 HEAD/GET을 모두 시도하고, 200/302/403/404/405와 HTML/JSON/파일 응답을 구분한다. HEAD 405만으로 실패 확정하지 않고 GET을 확인한다.
- **잔여 패턴 보고**: 같은 패턴을 모두 고치지 못했으면 “남은 동일 패턴”을 파일/라인 또는 URL로 남긴다.
- **재검수 증거**: 최소한 `검색어`, `발견 개수`, `수정/미수정 개수`, `대표 URL 응답`, `미확인 사유`를 기록한다.

### 3-1. 인증 기본 기능 체크

사이트에 로그인, 회원가입, 비밀번호 찾기, 소셜 로그인, 마이페이지, 글쓰기/구매처럼 계정 기반 기능이 하나라도 보이면 아래를 **필수 체크**한다. “간단한 기능”이어도 검수에서 생략하지 않는다.

- **진입 링크**: 데스크톱/모바일 헤더, CTA, 권한 필요 화면에서 로그인·회원가입 링크가 보이고 올바른 URL로 이동하는지 확인한다.
- **화면 렌더링**: 로그인, 회원가입, 비밀번호 찾기 탭/페이지가 200으로 열리고 JS 초기화 후 숨김/표시 상태가 정상인지 확인한다.
- **필수값 검증**: 빈 로그인 제출, 빈 회원가입 제출, 짧은 비밀번호, 비밀번호 불일치, 필수 약관 미동의가 사용자에게 보이는 오류로 처리되는지 확인한다.
- **잘못된 인증 정보**: 존재하지 않는 계정 또는 틀린 비밀번호가 500/빈 화면이 아니라 명확한 오류 안내로 끝나는지 확인한다.
- **복귀 흐름**: `/login?next=...`, 로그인 필요 CTA, 글쓰기/구매 버튼에서 로그인 후 원래 목적지로 돌아가는지 확인한다. 로그인 페이지 자기 자신(`/login`)이나 외부 URL로 돌아가면 이슈로 기록한다.
- **회원가입 성공 흐름**: 가입 후 자동 로그인 여부, 이동 위치, 중복 이메일, 약관 링크, 봇 검증/캡차가 설정과 맞는지 확인한다. 실제 가입이 어려우면 소스/API 계약 기준으로 미확인 표시한다.
- **소셜 로그인**: 버튼 노출 여부, provider API, `next` 전달, 미설정 provider의 오류 안내, 콜백 URL을 확인한다. 실제 외부 로그인은 테스트 계정이 없으면 진입 URL까지만 확인한다.
- **OAuth 도메인 등록**: 신규 도메인/서브도메인(`eond.com`, `ai.eond.com`, `biz.eond.com`, `ecut.eond.com` 등)에서는 현재 origin 기준 callback URL(`/auth/social/{provider}/callback`)과 provider별 JavaScript origin/승인된 리다이렉트 URI가 외부 개발자 콘솔에 등록되어 있는지 확인한다. 앱이 자동 생성하는 redirect URI와 콘솔 등록값이 다르면 소셜 로그인 실패 이슈로 기록한다.
- **세션 상태 전환**: 로그인 전/후 헤더가 로그인·회원가입에서 마이페이지·로그아웃으로 바뀌는지, 로그아웃 후 보호 페이지 접근이 막히는지 확인한다.
- **보안 기본값**: 외부 리다이렉트 방어, 쿠키 설정, CSRF/봇검증 정책, rate limit이 치명적으로 빠져 있지 않은지 코드나 응답 헤더 기준으로 확인한다.

인증 기능을 확인하지 못했으면 “미확인”으로만 두지 말고, 어떤 이유로 확인하지 못했는지와 공개 전 필요한 테스트 계정/환경을 적는다.

### 4. 사용성

- 사용자가 다음 행동을 쉽게 찾을 수 있는지 확인한다.
- 버튼 라벨이 행동을 정확히 설명하는지 확인한다.
- 카드와 목록의 정보 우선순위가 명확한지 확인한다.
- 초보자와 반복 방문자 모두에게 적절한 진입점이 있는지 확인한다.

### 4-1. 사람 기준 과업 평가

사이트 목적에 맞는 대표 과업을 3~5개 정하고 사람이 실제로 수행한다고 가정해 점검한다.

- 처음 방문자가 “이 사이트가 뭔지 알고 시작하기”까지 갈 수 있는가?
- 원하는 프롬프트를 “무료/유료/인기/분야별”로 찾을 수 있는가?
- 프롬프트 상세에서 결과물, 가격, 사용 조건, 구매/다운로드 방법을 이해할 수 있는가?
- 업무/콘텐츠/개발 같은 분야별 메뉴에서 사례를 읽고 관련 프롬프트로 이동할 수 있는가?
- 질문이나 제안을 남길 커뮤니티/문의 경로를 찾을 수 있는가?

각 과업은 성공/부분 성공/실패로 판단하고, 실패 이유를 메뉴명, UI 구조, 콘텐츠 부재, 기능 부재, 권한 안내 부족 중 하나 이상으로 분류한다.

### 5. 반응형과 시각 안정성

- 최소 모바일, 태블릿, 데스크톱 3개 폭에서 확인한다.
- 헤더, 드롭다운, 사이드바, 카드, 긴 제목, 버튼 텍스트가 겹치거나 잘리지 않는지 확인한다.
- 다크모드, sticky 요소, 스크롤 영역, 모달/드로어가 화면을 가리지 않는지 확인한다.
- 이미지, 아이콘, 폰트 로딩 실패 시 화면이 과도하게 깨지지 않는지 확인한다.

### 5-1. 에디터와 아이콘 시각 검수

글쓰기, 수정, 댓글 확장 입력, 관리자 입력처럼 리치 에디터나 툴바가 있는 화면은 공개 목록/상세보다 버그가 숨어 있기 쉽다. 아래 항목은 테스트 계정이 있으면 인증 후 반드시 확인한다.

- 작성/수정 화면을 실제로 열고 에디터 초기화 전후 DOM을 확인한다. 템플릿 include나 JS 파일 존재만으로 통과 처리하지 않는다.
- 라이트모드와 다크모드 모두에서 에디터 배경, 입력 글자, placeholder, selection, toolbar border가 충분히 보이는지 확인한다.
- SVG `currentColor` 아이콘, Bootstrap Icons, lucide 등 아이콘 라이브러리가 로드되고 버튼 안에서 실제 픽셀로 보이는지 확인한다.
- 굵게, 기울임, 제목, 목록, 인용, 링크, 이미지/파일 첨부 같은 툴바 버튼은 아이콘 노출, hover/focus/active 상태, 키보드 포커스 링을 확인한다.
- 아이콘이 “DOM에는 있으나 안 보이는” 경우를 대비해 색상 대비, `display`, `width/height`, `overflow`, 부모 배경색, 다크모드 변수 적용 여부를 같이 본다.
- 모바일 폭에서 툴바가 줄바꿈되어도 버튼이 겹치거나 잘리지 않는지 확인한다.
- 이전 검수에서 이 유형을 놓쳤다면 원인을 `공개 페이지 중심 확인`, `로그인 후 화면 미검증`, `다크모드 미전환`, `아이콘 대비/폰트 로딩 미확인` 중 하나 이상으로 기록하고 다음 검수 범위에 추가한다.

### 6. 접근성과 기본 품질

- 키보드 포커스, 명확한 링크 텍스트, 폼 라벨, alt 텍스트, 대비를 확인한다.
- 같은 목적의 버튼/링크가 일관된 용어와 스타일을 쓰는지 확인한다.
- 콘솔 오류, 네트워크 실패, 과도한 레이아웃 시프트를 확인한다.

### 7. 콘텐츠와 신뢰

- 샘플 문구, Lorem ipsum, 빈 카테고리, 날짜/가격/정책 불일치를 찾는다.
- 유료/무료, 구매/다운로드, 환불/라이선스, 문의 경로가 명확한지 확인한다.
- 유료 콘텐츠가 무료처럼 전문 공개되어 있거나, 무료 콘텐츠가 구매 대상으로 오해되지 않는지 확인한다.
- 유료 콘텐츠는 공개 미리보기와 구매 후 전문 영역이 분리되어 있는지, HTML 소스/메타/JSON-LD에 전문이 새지 않는지 확인한다.
- 사이트 목적에 맞지 않는 과장 문구나 모호한 설명을 지적한다.

### 7-1. 전체 사이트 텍스트 맥락 분석

메뉴와 화면의 의미가 맞는지 보기 위해 주요 페이지의 보이는 텍스트를 인벤토리로 만든다.
최소한 GNB/사이드바/푸터, H1/H2, 리드 문구, 카드 제목, 빈 상태, CTA, 폼 라벨, 메타 title/description을 함께 본다.

- **메뉴 기대치**: 메뉴명을 보고 사용자가 기대할 정보, 기능, 행동을 한 문장으로 정의한다.
- **소개문구 일치**: H1과 리드 문구가 해당 메뉴의 역할을 설명하는지 확인한다.
- **본문 일치**: 목록, 카드, 아티클, 빈 상태가 소개문구와 같은 약속을 실제로 제공하는지 확인한다.
- **CTA 일치**: 버튼/링크 문구가 사용자의 다음 행동과 맞는지 본다.
- **용어 일관성**: 같은 개념을 페이지마다 다른 말로 부르거나, 무료/유료/마켓/게시판/자료실 표현이 충돌하지 않는지 확인한다.
- **신뢰 리스크**: 준비 중인 영역을 완성된 서비스처럼 말하거나, 실제 기능이 없는 구매/다운로드 문구가 있는지 확인한다.

평가 결과는 `메뉴명 / 현재 핵심 문구 / 기대 맥락 / 판정 / 권장 문구` 형식으로 남긴다.
문구가 명백히 다른 사이트, 다른 메뉴, 더미 문구를 가리키면 High 또는 Medium 이슈로 본다.

## 검수 방법

- 정적 확인: 라우트, 템플릿, 메뉴 DB/설정, 링크 문자열을 확인한다.
- 동적 확인: 가능하면 브라우저 자동화나 HTTP 요청으로 실제 페이지를 연다.
- 화면 확인: 주요 뷰포트에서 스크린샷이나 DOM 크기를 확인한다.
- 흐름 확인: “처음 방문자”, “반복 방문자”, “작성자/구매자” 같은 페르소나별 경로를 따라간다.
- 인증 확인: 로그인/회원가입은 최소한 `GET 화면`, `빈 제출`, `잘못된 제출`, `next 복귀`, `소셜 provider 목록`, `로그인 후 헤더 상태`를 체크한다. 실제 계정이 없으면 가능한 항목만 수행하고 나머지는 테스트 계정 필요 항목으로 남긴다.

## 치명도 기준

- **Blocker**: 핵심 페이지 접근 불가, 저장/구매/로그인 같은 핵심 기능 불능, 심각한 보안/데이터 위험.
- **High**: 주요 전환 흐름이 끊기거나 사용자가 잘못 이해할 가능성이 큼.
- **Medium**: 사용성, 반응형, 콘텐츠 품질 문제로 신뢰나 효율이 떨어짐.
- **Low**: polish, 용어, 미세한 정렬, 개선하면 좋은 항목.

## 점수 산정

검수 결과에는 100점 만점 점수를 포함한다. 점수는 감점식으로 산정하되,
확인하지 못한 범위가 크면 “잠정 점수”라고 표시한다.

### 점수 축

전체 점수는 아래 5개 축을 함께 본다. 치명도 감점은 최종 점수에 반영하되,
리포트에는 축별 점수를 함께 표시한다.

- **IA/메뉴 기대 일치 20점**: 메뉴명과 실제 화면의 의미가 맞고 현재 위치가 명확한가.
- **사용자 과업 흐름 25점**: 처음 방문, 탐색, 상세 확인, 작성/구매/문의 같은 목표를 막힘 없이 수행할 수 있는가.
- **기능/링크 안정성 20점**: 주요 링크, 필터, 검색, 목록/상세/쓰기, 권한 흐름이 깨지지 않는가.
- **UI/반응형/접근성 20점**: 목적에 맞는 UI이고 모바일/데스크톱에서 읽기, 클릭, 포커스가 안정적인가.
- **콘텐츠/신뢰 15점**: 더미 문구, 정책 공백, 가격/무료/유료 기준, 사이트 설명이 신뢰를 해치지 않는가.

축별 점수는 실제 확인한 증거를 기준으로 매기고, 확인하지 못한 축은 잠정 점수로 표시한다.
특히 “메뉴 클릭 후 기대한 내용이 나오지 않음”은 IA/메뉴 기대 일치와 사용자 과업 흐름에서 모두 감점할 수 있다.

### 정밀검수 카테고리별 점수

사용자가 “정밀검수”라고 요청하면 최종 점수 외에 아래 카테고리별 점수표를 반드시 포함한다.
각 카테고리는 100점 만점으로 산정하고, 최종 점수는 사이트 성격에 맞춰 가중 평균 또는 치명도 감점으로 조정한다.

| 카테고리 | 배점 기준 |
| --- | --- |
| URL/라우팅 | 주요 URL 200/3xx 의도, 404/500 없음, canonical/최종 URL 일치 |
| 버튼/링크/CTA | 모든 버튼과 링크의 라벨, href/action, 클릭 결과, 외부 링크 보안 |
| 인증/권한 | 로그인, 회원가입, 비밀번호 찾기, 소셜 로그인, 로그아웃, next 복귀, 보호 페이지 차단 |
| 핵심 기능 | 목록, 상세, 검색, 필터, 정렬, 글쓰기, 댓글, 추천, 첨부, 구매/다운로드/문의 |
| 콘텐츠 맥락 | 메뉴명-H1-리드-카드-상세-CTA-메타-OG-JSON-LD 의미 일치 |
| 무료/유료/구매 신뢰 | 가격, 무료/유료 라벨, 유료 본문 보호, 구매/문의/다운로드 정책 일치 |
| SEO/공유 | title, description, canonical, OG/Twitter, JSON-LD, sitemap, robots |
| UI/반응형/접근성 | 모바일/태블릿/데스크톱, 포커스, 라벨, 대비, 겹침/잘림 |
| 성능/기술 안정성 | 응답 크기, 콘솔/네트워크 오류, 과도한 JS 의존, 보안 헤더 기본값 |
| 운영/콘텐츠 밀도 | 더미/빈 상태, 콘텐츠 양, 최신성, 문의/정책/신뢰 요소 |

출력 예:

```text
카테고리별 점수표
| 카테고리 | 점수 | 판정 | 주요 감점 | 증거/미확인 |
| URL/라우팅 | 96 | 양호 | 보호 URL 리다이렉트 canonical 확인 필요 | /, /prompt, /community 200 |
| 버튼/링크/CTA | 88 | 보완 필요 | 일부 CTA 실제 구매 흐름 미확인 | 구매 문의 버튼 |
| 콘텐츠 맥락 | 90 | 양호 | 일부 상세 댓글/본문의 운영 메모 노출 | /community/491437 |
| 최종 | 91 | 조건부 공개 가능 | 테스트 계정 기반 흐름 미확인 | - |
```

기본 감점 기준:

- Blocker: 항목당 -25점
- High: 항목당 -12점
- Medium: 항목당 -5점
- Low: 항목당 -2점
- 핵심 흐름 미확인: 흐름당 -3점
- 브라우저/모바일 렌더링 미확인: -5점
- 테스트 계정/결제/권한처럼 핵심 운영 흐름 미확인: -5점
- 사이트에 인증 UI가 있는데 로그인/회원가입 기본 체크를 생략함: -8점
- 로그인/회원가입 중 하나라도 화면 접근 또는 기본 제출이 깨짐: High 이상
- 로그인 후 복귀 흐름 또는 소셜 로그인 `next` 전달이 깨짐: Medium 이상, 글쓰기/구매 같은 핵심 전환과 연결되면 High

최소 점수는 0점, 최대 점수는 100점이다. 같은 원인에서 나온 중복 이슈는 한 번만 크게 감점한다.

공개 판단 기준:

- **95~100점**: 공개 가능. 남은 항목은 운영 중 개선 가능한 수준.
- **90~94점**: 조건부 공개 가능. Blocker/High가 없어야 하며 Medium은 공개 전 확인 권장.
- **80~89점**: 내부/베타 공개 권장. 사용자 유입 전 주요 Medium을 줄인다.
- **79점 이하**: 공개 보류. 핵심 흐름 또는 신뢰 문제가 남아 있다.
- 점수와 무관하게 Blocker가 1개라도 있으면 공개 보류.
- High가 1개라도 있으면 공개 또는 광고 유입을 보류한다.

## 출력 형식

검수 결과는 아래 구조를 기본으로 출력한다. 사용자가 “짧게”라고 요청하지 않았다면
최소한 주요 이슈, 사용자 흐름 평가, 링크/기능 점검 요약, 우선순위, 현재 판단을 포함한다.
수정은 하지 않고, 다음 단계에서 `site-review-fix`로 넘길 수 있을 정도로 이슈를 구체화한다.

```text
검수 범위
- 대상:
- 확인한 화면/흐름:
- 확인하지 못한 범위:

검수 점수
- 점수: 00/100
- 공개 판단:
- 축별 점수:
  - IA/메뉴 기대 일치: 00/20
  - 사용자 과업 흐름: 00/25
  - 기능/링크 안정성: 00/20
  - UI/반응형/접근성: 00/20
  - 콘텐츠/신뢰: 00/15
- 감점 요약:
  - Blocker:
  - High:
  - Medium:
  - Low:
  - 미확인:

카테고리별 점수표
| 카테고리 | 점수 | 판정 | 주요 감점 | 증거/미확인 |
| --- | ---: | --- | --- | --- |
| URL/라우팅 | 00 |  |  |  |
| 버튼/링크/CTA | 00 |  |  |  |
| 인증/권한 | 00 |  |  |  |
| 핵심 기능 | 00 |  |  |  |
| 콘텐츠 맥락 | 00 |  |  |  |
| 무료/유료/구매 신뢰 | 00 |  |  |  |
| SEO/공유 | 00 |  |  |  |
| UI/반응형/접근성 | 00 |  |  |  |
| 성능/기술 안정성 | 00 |  |  |  |
| 운영/콘텐츠 밀도 | 00 |  |  |  |
| 최종 | 00 |  |  |  |

메뉴별 맥락 평가
- 시작하기:
  - 기대:
  - 실제:
  - 다음 행동:
  - 판정:
- 프롬프트:
  - 기대:
  - 실제:
  - 다음 행동:
  - 판정:

텍스트 맥락 평가
- 홈:
  - 현재 핵심 문구:
  - 기대 맥락:
  - 판정:
  - 권장 문구:
- 주요 메뉴:
  - 현재 핵심 문구:
  - 기대 맥락:
  - 판정:
  - 권장 문구:

주요 이슈
1. [High] 이슈 제목
   - 위치:
   - 증거:
   - 영향:
   - 권장 수정:

Fix 체크리스트
- [ ] [High] 이슈 제목 — 수정 대상/확인 URL
- [ ] [Medium] 이슈 제목 — 수정 대상/확인 URL

사용자 흐름 평가
- 처음 방문자:
- 반복 방문자:
- 작성자/구매자:

링크/기능 점검 요약
- 정상:
- 문제:
- 미확인:

인증 기능 점검
- 로그인 진입/화면:
- 로그인 필수값·오류:
- 회원가입 진입/화면:
- 회원가입 필수값·약관·중복:
- 비밀번호 찾기:
- 소셜 로그인:
- 로그인 후 복귀 URL:
- 세션 전환/로그아웃:
- 미확인 사유:

우선순위
1. 먼저 고칠 것
2. 다음에 고칠 것
3. 나중에 다듬을 것

현재 판단
- 출시 가능 여부:
- 남은 리스크:

재검수 필요 항목
- 수정 후 다시 확인할 URL/흐름:
- 브라우저 기반 확인이 필요한 화면:
- 테스트 계정이나 운영 데이터가 필요한 항목:
```

## 수정 요청을 받은 경우

- 사용자가 “수정까지 진행해”라고 명시하면 이슈 우선순위에 따라 작은 범위부터 고친다.
- Blocker와 High를 먼저 처리한다.
- 기획 판단이 필요한 UX 변경은 바로 구현하지 말고 선택지를 제시한다.
- 수정 후 같은 경로를 다시 검수해 회귀 여부를 확인한다.