Cmd. /verify
앱을 빌드·실행·관찰해 변경이 실제로 의도대로 동작하는지 확인하는 번들 skill 명령
핵심 요약
/verify는 번들 skill로, 테스트·타입체크에 의존하지 않고 앱을 직접 빌드·실행·관찰해 변경이 의도대로 동작하는지 확인합니다.- 관련 상황이면 Claude가 알아서 호출하기도 하며, v2.1.145 이상에서만 쓸 수 있습니다.
- 성공 기준을 첫 프롬프트나 프로젝트 skill에 명확히 적어야 하고, 관찰 가능한 결과 없이 "좋아 보임"으로 끝나는 검증은 실패로 봅니다.
- 프로젝트별 실행 절차가 다르면
/run-skill-generator로 전용 skill을 먼저 만들어 두면/verify가 그 절차를 재사용합니다.
명령어 원본 선언
/verify공식 설명 요약
/verify는 번들 skill(bundled skill)입니다. 코드 변경이 의도한 대로 동작하는지를 테스트나 타입체크에 의존하지 않고, 프로젝트 앱을 직접 **빌드(build)하고 실행(run)한 뒤 결과를 관찰(observe)**하여 확인합니다.
공식 문서의 원문 설명은 다음과 같습니다.
Skill. Confirm a code change does what it should by building your project's app, running it, and observing the result, rather than relying on tests or type checks.
번들 skill이라도 직접 작성하는 skill과 똑같이 동작합니다. Claude에게 전달되는 프롬프트이고, 관련 상황이면 Claude가 알아서 호출하기도 합니다.
최소 지원 버전
v2.1.145이상 (Commands 문서의min-version: 2.1.145표기, "Requires Claude Code v2.1.145 or later")
사용법
/verify- 별칭(alias)은 없습니다.
- 인자 없이 호출하며, 검증 대상과 성공 기준은 대화 맥락이나 프로젝트 skill에서 전달합니다.
좋은 사용 예
- 로그인, 결제, 검색, 대시보드처럼 실제 workflow 동작 확인이 필요한 변경
- 문서/라우팅/locale 변경처럼 build 결과와 화면 링크를 함께 확인해야 하는 작업
- 테스트는 통과했지만 사용자 관점의 동작 검증이 남은 PR
- 푸시 전에 로컬 변경이 실제 앱에서 의도대로 보이는지 마지막으로 확인할 때
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/verify | 앱을 빌드·실행·관찰하여 변경이 의도대로 동작하는지 확인 (번들 skill) | 변경의 동작 검증, acceptance 기준 확인 |
/run | 프로젝트 앱을 실행해 변경이 작동하는 모습을 직접 확인 (번들 skill) | 실행/관찰 환경부터 띄워야 할 때 |
/run-skill-generator | /run·/verify가 깨끗한 환경에서 앱을 빌드·실행·구동하는 방법을 프로젝트별 skill로 작성 (번들 skill) | 프로젝트 전용 실행/검증 절차를 가르쳐야 할 때 |
/code-review | correctness bug 및 정리(reuse·simplify·efficiency) 리뷰 (번들 skill) | 코드 결함 탐지 |
/simplify | 정리 전용 리뷰 후 수정 적용 (번들 skill, v2.1.154부터 버그 탐색 제외) | 동작 변경 없이 코드 정리만 할 때 |
활용 사례
/verify로 변경을 검증한 뒤 결함이 의심되면/code-review로 코드 결함을 따로 점검- 프로젝트마다 빌드·실행 절차가 다르면
/run-skill-generator로 전용 skill을 먼저 만들어 두면/verify가 그 절차를 재사용 - CI에서 잡히지 않는 UI·UX 회귀를 사람 관점에서 잡아내는 마지막 게이트로 사용
주의사항
/verify가 무엇을 성공으로 볼지(성공 기준)를 첫 프롬프트나 프로젝트 skill에 명확히 작성해야 합니다.- 관찰 가능한 결과 없이 "좋아 보임"으로 끝나는 검증은 실패로 취급하세요. 빌드·실행 후 실제 결과를 관찰해야 합니다.
- 테스트·타입체크를 대체하는 명령이 아닙니다. 그것들로는 잡히지 않는 실제 동작을 보완 검증하는 용도입니다.
v2.1.145미만 버전에서는 사용할 수 없습니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Run and verify your app (Skills): https://code.claude.com/docs/en/skills#run-and-verify-your-app