랜딩 페이지 리뷰은(는) 무엇을 하나요?
당신은 랜딩 페이지를 감사하고 평결을 landing/review.md에 작성합니다. 페이지는 landing-skills 파이프라인 또는 다른 곳에서 올 수 있습니다. 당신은 소스를 읽고, 네 가지 너비로 렌더링된 페이지를 보고, 모션과 3D가 있으면 테스트하고, 모든 것을 하나의 루브릭에 대해 판단합니다.
완성된 것처럼 보이는 페이지들은 종종 아무도 찾지 못한 방식으로 망가져 있습니다: 모든 리드를 버리면서 방문자에게 감사하는 폼, 클라이언트가 제공하지 않은 사양과 약속, WebGL을 사용할 수 없을 때 빈 화면이 되는 3D 페이지, 모든 너비에서 다른 규칙에 의해 상쇄되는 섹션 패딩. 네 가지 너비를 캡처하고 두 가지만 보는 리뷰어는 하나에서만 나타나는 것을 놓칩니다. 당신의 임무는 모든 것을 보고 확인된 것만 보고하는 것입니다.
<skill-dir> 아래는 이 SKILL.md를 포함하는 디렉토리를 의미합니다; 스크립트는 scripts/ 폴더에 있습니다. 스킬이 플러그인에서 로드된 경우, 이 파일의 경로는 로드될 때 제공되었습니다; 그렇지 않으면 find ~ -path '*landing-review/scripts/detect-tells.mjs' 2>/dev/null로 찾으십시오. 검토 중인 프로젝트에서 모든 명령을 실행하고, 스크립트는 전체 경로로 지정하십시오.
입력
페이지가 필요하며, 존재하는 모든 컨텍스트를 사용합니다.
- 페이지. 프로젝트 디렉토리, 단일 HTML 파일 또는 배포된 URL. 진입점을 찾으십시오:
index.html,src/pages/index.astro,src/App.jsx,app/page.tsx또는 스택에서 사용하는 것. 스택을 기록하십시오; 이는 시각적 패스에서 페이지를 제공하는 방식을 결정합니다. landing/brief.md: 제품, 대상, 전환 액션, 클라이언트가 제공한 사실과 증거, 제공된 에셋, 언어. 이것은 페이지가 주장할 수 있는 것에 대한 진실의 원천입니다.landing/copy.md: 승인된 카피. 이 카피와 페이지를 비교하십시오.landing/direction.md및landing/tokens.css: 이유가 있는 시각적 방향과 토큰. 기본값처럼 보이는 선택은 방향이 클라이언트에게 특정한 이유를 제시할 때 허용 가능합니다.
파일이 누락된 경우:
- brief 없음. 주장을 판단하기 전에 사용자에게 네 가지를 물어보십시오: 제품이 무엇인지, 대상이 누구인지, 하나의 전환 액션이 무엇인지, 그리고 어떤 사실, 숫자, 사용 후기 및 로고가 실제인지. 물어볼 수 없다면, 페이지 자체가 비즈니스에 대해 말하는 것에서 사실을 가져오고 모든 사용 후기, 고객 이름, 로고, 평점 및 지표를 확인되지 않은 것으로 처리하십시오: 각각을 차단기로 보고하고 "이것이 실제이고 클라이언트가 제공한 것인지 확인하거나 제거하십시오"라는 수정 사항을 추가하십시오. 확인되지 않은 증거가 출시되는 것은 조작된 증거와 동일한 위험입니다.
- copy.md 또는 direction.md 없음. 루브릭을 사용하여 카피와 비주얼을 각각의 장점에 따라 검토하십시오. "이것이 승인된 카피와 다릅니다"라고 말할 수 있는 능력을 잃는 것 외에는 아무것도 잃지 않습니다. 이 파일들을 요청하지 마십시오.
landing/폴더 없음. 프로젝트에landing/및landing/shots/를 만드십시오; 보고서와 스크린샷이 그곳에 저장됩니다.- 페이지가 빌드되지 않거나 제공되지 않음. 오류와 함께 루브릭 행 B15 아래에 보고하십시오. 다른 방법(배포된 URL, 이전 빌드)으로 렌더링된 페이지를 얻을 수 없는 경우, 시각적 패스를 실행할 수 없으며 평결은
incomplete입니다(평결 참조).
패스를 시작하기 전에 references/rubric.md를 읽으십시오. 모든 검사와 합격 기준, 실패 시 심각도를 포함합니다. landing/review.md를 작성하기 전에 references/report-format.md를 읽으십시오. references/snippets.md에는 패스가 실행하는 스크립트가 있습니다.
프로세스
다음 순서로 패스를 실행한 다음 보고서를 작성하십시오:
- 정적 패스: 소스를 스캔한 다음 읽습니다.
- 시각적 패스: 페이지를 렌더링하고 네 가지 너비로 봅니다.
- 모션 및 3D 패스: 페이지에 모션 또는 3D 장면이 있는 경우에만.
references/rubric.md의 전체 루브릭을 영역별로 살펴보십시오: 카피, 아트 디렉션, 빌드, 모션, 출시 준비 상태. 모든 행 ID에 대해 한 줄씩landing/review-checklist.md에 작업 체크리스트를 작성하십시오: 위치와 함께fail, 증거와 함께pass, 또는 이유와 함께n/a. 합격은 그 증거가 해당 행의 고유 "확인 방법"의 결과인 경우에만 계산됩니다: 목록이라고 명시된 곳의 목록, 개수라고 명시된 곳의 개수, 모든 섹션, 헤더 및 푸터가 포함된 곳의 모든 섹션. 페이지를 기억에서 체크한 행은 검토된 것이 아닙니다. 짧은 정적 페이지에서도 긴 페이지와 마찬가지로 카피와 아트 디렉션을 주의 깊게 읽고, 하나의 차단기가 이미 명백하더라도 모든 행을 살펴보십시오: 리뷰는 다음 라운드에서 수정해야 할 모든 것을 나열하며, 평결을 결정하는 것만 나열하지 않습니다.references/report-format.md에서 설명하는 대로landing/review.md를 작성하십시오: 표의 실패, "확인 및 이상 없음" 아래의 증거와 함께 합격. 그런 다음 이 파일 끝에 있는 자체 점검을 실행하십시오.
발견한 대로 메모를 유지하십시오: 모든 발견 사항에 대해, 그것을 본 위치(파일 및 줄, 또는 너비 및 섹션)와 확인 방법.
정적 패스
전체 저장소가 아닌 페이지의 소스 경로에 스캐너를 지정하십시오:
node <skill-dir>/scripts/detect-tells.mjs index.html styles.css
node <skill-dir>/scripts/detect-tells.mjs src --json
읽는 대상: 직접 지정한 모든 파일, 확장자에 관계없이. 디렉토리에서는 .html, .htm, .css, .scss, .js, .jsx, .mjs, .ts, .tsx, .astro, .vue, .svelte, .md 및 .mdx 파일을 읽고, node_modules, .git, dist, build, .next, .astro, .output, .vercel 및 .wrangler 폴더를 건너뛰고, 1MB가 넘는 파일을 건너니다. 각 줄은 25개의 규칙에 대해 확인됩니다. 발견 사항은 file:line [rule-id] message 형식으로 출력되고 그 다음 fix: 줄이 옵니다. 종료 코드 1은 무언가를 찾았음을, 0은 아무것도 찾지 못했음을, 2는 잘못된 경로 또는 사용법을 의미합니다. --self-test는 스캐너 자체를 확인합니다.
Markdown을 읽기 때문에 노트, 보고서, brief 및 이전 리뷰에서 인용된 구문도 보고합니다. 페이지 소스가 아닌 파일(landing/*.md, README, 노트, 이전 review.md 파일)의 모든 발견 사항은 무시하십시오.
모든 발견 사항을 평결이 아닌 살펴보라는 프롬프트로 취급하십시오. 줄을 열고, 실제로 무엇을 포함하고 있으며 페이지가 그것으로 무엇을 하는지 확인한 다음에만 결정하십시오. 규칙이 일치시킨 것을 설명하십시오: 태그 색상에 대한 팔레트 히트는 페이지 배경에 대한 발견 사항이 아닙니다. 조회가 결정하는 예:
- 로고 링크의
dead-anchor는 사소한 빌드 결함입니다. 주요 행동 촉구에서는 전환이 작동하지 않음을 의미합니다: 차단기. overused-font는 일반적인 서체가 스택을 선도함을 의미합니다.direction.md가 이유를 제시하지 않고 서체가 독특한 디스플레이나 모노 서체와 짝을 이루지 않는 경우에만 발견 사항입니다.palette-cream-terracotta는 두 개의 정확한 16진수 값에서 발생합니다. 크림만으로는 절대 신호가 아닙니다; 크림, 테라코타 악센트 및 유행하는 세리프의 묶음이 신호입니다.
깨끗한 스캔은 아무것도 증명하지 않습니다. 조작된 주장, JavaScript 없이 빈 페이지, 비대한 번들, 유효한 페이지 내 ID를 링크하지만 구매로 이어지지 않는 행동 촉구는 모두 소스에 패턴을 남기지 않습니다. 대부분의 실패는 부재, 개수, 모순, 구성 및 깨진 동작이며, 이는 줄 단위 정규식으로는 볼 수 없습니다. 페이지는 깨끗하게 스캔되고 다른 모든 패스에서 실패할 수 있습니다.
따라서 스캔 후 직접 소스를 읽으십시오. 읽어서 확인해야 할 검사는 references/rubric.md에 "source"로 표시되어 있습니다. 가장 많이 발견하는 것:
<head>: title,lang, 메타 설명, 파비콘, 오픈 그래프 태그.- 모든 폼: 제출 위치, 핸들러가 데이터로 하는 작업, 성공 메시지가 서버를 기다리는지 여부.
- 모든 행동 촉구
href: 실제로 연결되는 위치. - 글꼴: 각
font-family가@font-face, 스타일시트 링크 또는 프레임워크 글꼴 가져오기에 의해 로드되었는지, 아니면 시스템 스택만 있는지. - 페이지의 모든 주장, 숫자, 이름, 사양 및 약속을 brief에 대해 확인하십시오. brief가 제공되었다고 말한 모든 에셋을 페이지가 보여주는 것에 대해 확인하십시오.
- 자신을 상쇄하는 CSS, 예를 들어
padding단축 속성이 섹션 규칙보다 더 구체적이고 섹션의 수직 패딩을 조용히 0으로 재설정하는 컨테이너 클래스. 브라우저에서 계산된 패딩을 읽어 확인하십시오. prefers-reduced-motion: 존재 또는 부재, 그리고 그것이 하는 일.- 빌드된 HTML의 본문: 빈
<div id="root">이고<noscript>가 없으면 JavaScript 없이 페이지가 비어 있습니다.
시각적 패스
렌더링된 페이지가 필요합니다. 스캐너와 소스는 겹침, 레이아웃의 빈 절반, 줄바꿈된 헤드라인, 축소된 간격 또는 3D 장면 위에 있는 텍스트를 보여줄 수 없습니다.
페이지 제공
항상 HTTP를 통해 검토하십시오, 일반 HTML도 포함. 여러 검사에는 서버가 필요합니다: 루트 상대 에셋 경로(/styles.css, /assets/...)는 file://에서 실패하고, 루브릭 행 L7은 누락된 경로, /robots.txt 및 /sitemap.xml을 요청합니다. node_modules가 없으면 먼저 종속성을 설치하십시오.
- 배포된 URL: 직접 사용하십시오.
- 일반 HTML 및 CSS:
index.html이 있는 폴더에서python3 -m http.server 8000을 실행하고http://localhost:8000/을 여십시오. - Vite:
npm run build, 그런 다음npx vite preview(기본적으로 4173 포트). - Astro:
npm run build, 그런 다음npx astro preview(기본적으로 4321 포트). - Next.js:
npm run build, 그런 다음npm run start(기본적으로 3000 포트). - 다른 모든 빌드: 빌드한 다음 출력 폴더에서 동일한
python3 -m http.server명령을 실행하십시오.
Passes 아래에 검토한 URL을 작성하십시오. 아무것도 제공할 수 없을 때 최후의 수단으로만 file:// 경로를 여십시오; 그러면 L7이 실행되지 않고, 루트 상대 경로가 있는 모든 에셋이 그 이유만으로 누락될 수 있습니다. Passes 아래에 둘 다 나열하고, 서버가 찾았을 누락된 에셋을 보고하지 마십시오.
기존 빌드 출력을 검토하는 경우에만 소스와 최신 상태일 때 검토하십시오. find src index.html -newer dist/index.html (스택의 소스 및 출력 경로 사용)은 빌드 이후 변경된 소스 파일을 나열합니다; 파일이 나열되거나 빌드가 없으면 다시 빌드하십시오. Passes 아래에 어떤 것을 검토했는지와 그 이유를 명시하십시오.
캡처 방법 선택, 이 순서로
-
브라우저 도구, 환경에 있는 경우. 다음 기능이 필요합니다: URL로 이동, 뷰포트 너비 설정, 전체 페이지 스크린샷 촬영, 페이지에서 스크립트 실행, 미디어 기능(색 구성표, 모션 감소) 및 JavaScript 끄기 에뮬레이션.
-
대체 스크립트, 브라우저 도구가 없거나 캡처할 수 없는 경우. 브라우저를 사용할 수 없다고 들었더라도 실행하십시오:
npx를 통해 자체 브라우저를 시작하고 작동할 수 있습니다.node <skill-dir>/scripts/screenshot.mjs <url-or-file> landing/shots node <skill-dir>/scripts/screenshot.mjs <url-or-file> landing/shots --dark360.png,768.png,1280.png및1440.png(--dark 사용 시360-dark.png등), 전체 페이지, 1.5초 대기 후 각 파일 경로를 출력합니다. "Executable doesn't exist" 오류로 실패하면npx playwright install chromium을 실행하고 다시 시도하십시오. 0이 아닌 코드로 종료되거나,capture failed at <width>px를 출력하거나, 이미지를 쓰지 않으면 실패한 것입니다. -
둘 다 작동하지 않음. 그제야 시각적 패스가 실행되지 않은 것입니다. 어쨌든 정적 패스와 소스 읽기를 수행한 다음
incomplete에 대한 평결 규칙을 따르십시오.
대체 스크립트는 페이지에서 스크립트를 실행하거나, 모션 감소를 에뮬레이션하거나, JavaScript 또는 WebGL을 끄거나, 스크롤할 수 없습니다. 이 방법을 사용하면 이미지에서 볼 수 있는 것을 판단하고, 소스를 읽어 모션 감소, JavaScript 끄기 및 WebGL 끄기를 확인하고, Passes 아래에 라이브로 실행할 수 없었던 각 검사와 그 이유를 나열하십시오.
네 가지 너비 모두 캡처
각 너비(360, 768, 1280 및 1440, 높이 800도 괜찮음)에 대해:
- 너비를 설정하고, 페이지를 로드하고, 글꼴과 이미지를 기다립니다.
references/snippets.md의 뷰포트 확인으로 실제 너비를 확인하십시오. 일부 도구는 창을 최소 너비 이하로 줄이지 않고 조용히 더 넓은 페이지를 제공합니다; 대신 도구의 장치 또는 뷰포트 에뮬레이션을 사용하고 다시 확인하십시오.- 전체 페이지 스크린샷을
landing/shots/에 찍습니다. references/snippets.md의 측정 스크립트를 실행하고 그 주의 사항을 읽습니다: 오버플로, 뷰포트보다 넓은 요소, 레이아웃 이동, 캔버스 수.- 라이브 브라우저에서 페이지를 위에서 아래로 스크롤하십시오.
그런 다음 모든 이미지를 열고 읽으십시오: 네 가지 너비 모두, 그리고 찍었다면 어두운 이미지도. 넘어가기 전에 본 내용을 노트에 너비당 한 줄씩 작성하십시오. 두 가지 너비를 보고 나머지를 추정하는 것이 특정 너비에서만 나타나는 실패를 놓치는 방법입니다: 넓은 너비에서만 행의 절반을 비워두는 좁은 블록, 또는 메뉴 없이 숨겨진 섹션 링크가 가장 좁은 너비에서만 나타나는 경우.
전체 페이지 캡처가 실패하거나 잘려서 반환되는 경우(캔버스가 있는 긴 페이지에서 발생), 대신 각 너비에서 상단 및 여러 스크롤 위치(1/4, 1/2, 3/4, 하단)에서 뷰포트를 캡처하고 Passes 아래에 그렇게 명시하십시오. 대체 스크립트는 전체 페이지 캡처만 수행합니다; 그런 식으로 실패하면 어떤 너비가 누락되었는지 기록하십시오.
스크롤 기반 페이지의 전체 페이지 캡처는 스크롤 위치 0에서 오프스크린 상태인 패럴랙스 또는 고정 섹션에서 빈 밴드를 표시할 수 있습니다. 빈 영역을 보고하기 전에 라이브 페이지에서 그 위치로 스크롤하십시오. 거기서 렌더링되면 캡처 아티팩트이지 결함이 아닙니다.
찾아야 할 것
모든 너비에서, 루브릭을 열고:
- 가로 스크롤, 잘린 텍스트, 겹치는 요소, 이미지 또는 캔버스 위의 텍스트(읽기 어려운 경우).
- 간격: 수직 패딩이 없는 섹션, 위 블록에 딱 붙은 제목, 콘텐츠 밖으로 튀어나온 테두리.
- 구성: 1280 및 1440에서 반쯤 빈 행, 네 줄로 줄바꿈되거나 마지막 줄에 단어 하나를 남기는 헤드라인, 360에서 줄바꿈되는 눈썹, 레이블 및 버튼, 고르지 않은 높이의 카드.
- 360에서의 탐색: 섹션 링크에 여전히 도달할 수 있는지, 버튼이 최소 44x44 픽셀인지, 고정 헤더가 헤드라인을 덮는지.
- 360에서의 순서: 제품이 폼 위에 보이는지, 아니면 아래로 밀렸는지.
- 이미지: 실제 에셋인지, 아직 존재하지 않는 에셋에 대한 올바른 종횡비의 레이블이 지정된 플레이스홀더인지.
- 키보드: 1280에서 한 번 페이지를 Tab으로 이동하십시오. 포커스는 ...