ce-test-browser

소개 ce-test-browser

pull request 또는 브랜치 변경으로 인해 영향을 받는 페이지에 대해, 오로지 agent-browser CLI만을 사용하여 엔드투엔드 브라우저 테스트를 실행하는 워크플로우입니다. 이 워크플로는 의도적으로 다른 브라우저 자동화 시스템이나 브라우저 MCP 통합을 배제합니다. Claude Code에서는 Chrome MCP 도구를 사용하지 않으며, Codex에서는 다른 브라우징 도구를 대체하지 않습니다. agent-browser는 페이지 열기, 요소 클릭, 양식 작성, 스크린샷 촬영, 렌더링된 콘텐츠 스크래핑에 사용됩니다. 이 워크플로는 PR 번호, 브랜치 이름, ‘current’라는 단어 또는 --port 플래그를 인수로 받아들입니다.

이 워크플로는 먼저 agent-browser가 설치되어 있는지 확인하고, 설치되어 있지 않은 경우 /ce-setup을 실행하라는 안내와 함께 중단됩니다. 그런 다음, 파이프라인 모드를 제외하고는 headed 모드로 실행할지 headless 모드로 실행할지 묻습니다. 파이프라인 모드의 경우, 차단 없이 기본적으로 headless 모드로 실행됩니다. 테스트 범위는 PR 번호의 경우 gh pr view를, current 또는 특정 브랜치의 경우 main 브랜치와의 git diff를 사용하여 변경된 파일을 기반으로 결정됩니다. 변경된 파일은 Rails 뷰, 컨트롤러, Stimulus 컨트롤러, ViewComponents, 레이아웃, 스타일시트, 헬퍼, Next.js 앱 및 컴포넌트 경로를 포괄하는 패턴 테이블을 통해 테스트 가능한 경로로 매핑되어, 테스트할 URL 목록을 생성합니다.

포트 처리는 수동 모드와 파이프라인 모드를 구분합니다. 명시적인 --port 인자, 컨텍스트 내 프로젝트 지침, package.json의 dev/start 스크립트, 환경 설정 파일, 또는 기본값인 3000을 통해 선호하는 포트를 결정하며, 의도적으로 설명문에서 포트를 검색하지 않습니다. 파이프라인 모드에서는 여러 에이전트가 병렬로 실행될 수 있으므로 사용 가능한 포트를 위쪽부터 스캔하며, 리스닝 중인 포트가 없으면 최대 30초 동안 대기한 후 백그라운드에서 개발 서버를 시작합니다. 수동 모드에서는 선호하는 포트를 직접 사용하며, 서버가 실행 중이지 않을 경우 사용자에게 서버를 시작하도록 요청합니다. 영향을 받는 각 경로에 대해 탐색하여 대화형 스냅샷을 캡처하며, 사용자가 ‘watch’를 선택한 경우 --headed 플래그를 사용합니다. 그런 다음 페이지 제목이나 헤딩, 주요 대화형 요소와 같은 핵심 요소를 검증합니다. 이 기능을 사용하여 변경 사항이 적용된 페이지가 여전히 올바르게 렌더링되고 정상적으로 작동하는지 확인하십시오.

자주 묻는 질문

이 스킬은 어떤 브라우저 자동화 도구를 사용하나요?

전적으로 agent-browser CLI를 사용합니다. Claude Code의 Chrome MCP 도구를 사용하거나 Codex의 다른 브라우징 도구를 대체하지 않습니다.

agent-browser가 설치되어 있지 않으면 어떻게 되나요?

사용자에게 현재 설치 환경에서 /ce-setup 명령을 실행하여 agent-browser를 설치한 후 다시 시도하라는 안내를 표시한 다음, agent-browser 없이는 스킬이 작동할 수 없으므로 중단됩니다.

테스트할 페이지는 어떻게 결정하나요?

PR의 경우 gh pr 뷰에서, 브랜치나 현재 버전의 경우 main을 기준으로 한 git diff를 통해 변경된 파일을 가져온 다음, 파일 패턴 테이블을 사용하여 해당 파일을 경로에 매핑해 URL 목록을 생성합니다.

개발 서버 포트는 어떻게 결정되나요?

우선순위에 따라 결정됩니다: 명시적인 --port 인수, 프로젝트 내 컨텍스트 지침, package.json의 dev 스크립트, .env와 같은 환경 설정 파일 순이며, 이 모든 조건이 충족되지 않으면 기본값인 3000을 사용합니다. 본문에서 포트 번호를 검색하지는 않습니다.

파이프라인 모드에서는 무엇이 다른가요?

헤드(headed) 또는 헤드리스(headless) 모드를 선택하는 과정을 건너뛰고 기본적으로 헤드리스 모드로 설정되며, 에이전트가 병렬로 실행될 수 있으므로 위쪽부터 순차적으로 진정으로 사용 가능한 포트를 스캔하고, 리스닝 중인 개발 서버가 없으면 백그라운드에서 개발 서버를 자동으로 시작합니다.