Prove It (증명하기)은(는) 무엇을 하나요?
변경사항을 사용자가 사용하는 방식 그대로 증명하세요. 증명 없이 "잘 작동합니다"라고 말하지 마세요.
이 스킬은 '완료' 시 자동으로 로드되지 않습니다. 사용자가 요청해야 합니다. 다른 스킬을 로드하지 않습니다.
사용 시기
사용자가 다음과 같이 요청할 때 이 스킬을 로드하세요:
/prove-it실행- "prove it", "변경사항 증명", "브라우저에서 보여줘" 또는 동일한 의도의 표현 (첫 메시지에 포함된 경우 포함)
사용자가 요청하지 않았다면 건너뛰세요. 타입 전용, 주석, lockfile, 동작이 없는 문서는 건너뛰세요.
엄격한 제한 (Hard Gates)
- 사용자가 요청했는가? 증명을 요청하지 않았다면 이 스킬은 실행되지 않습니다.
- '작동한다', '완료되었다', '수정되었다'고 말하지 마세요 — 이 스킬이 실제로 증명하기 전까지는. 건너뛰었다는 것은 증명되지 않음을 의미합니다.
- 한 화면의 스크린샷은 증명이 아닙니다. 클릭, 입력, 제출, 탐색하세요.
- 새 패키지, 의존성, 예제 앱, 브라우저 러너를 추가하지 마세요 — 사용자가 해당 옵션을 선택하고 동의한 경우는 예외입니다.
- 이 스킬이 시작한 모든 서버를 중단하세요.
dev/preview를 실행 중인 상태로 두지 마세요.
UI vs 서버
- UI (페이지, 컴포넌트, 라우트, 폼, 보이는 상태): 브라우저에서 증명하세요.
- 서버 / API / 화면이 없는 라이브러리: 증명 방법을 질문하세요. 조용히 선택하지 마세요.
- 둘 다: UI는 브라우저에서 증명하고, 서버 부분은 증명 방법을 질문하세요.
절차
절차 1: 분류
- 대상 목록을 만드세요: UI, 서버/API, 또는 둘 다.
- UI → 절차 2.
- 서버/API → 절차 3.
- 둘 다 → 절차 2, 그 다음 API에 대해 절차 3.
절차 2: 브라우저 (UI)
- 앱이 실행 중이 아니라면, 기존 명령어만 시작하세요 (
dev,preview, 저장소에 문서화된 시작 명령어). 명령어가 없으면 UI를 증명할 수 없다고 말하세요. 건너뛰기 또는 사용자가 앱을 직접 시작하도록 제안하세요. - 사용자처럼 사용하세요:
- 클릭, 입력, 제출, 탐색
- 이 상태를 공유하는 모든 라우트/페이지
- 이 변경사항이 있다면 빈 상태 UI와 에러 UI
- 레이아웃이나 CSS가 변경되었다면 데스크탑과 좁은 뷰포트 모두
- 해피 패스뿐만 아니라 문제점을 찾으세요.
- 채팅에서 수행한 작업과 본 결과를 말하세요. "좋아 보입니다"라고 단계 없이 말하지 마세요.
- 이 스킬이 시작한 경우 1단계의 프로세스를 중단하세요.
- 절차 4.
절차 3: 질문 (서버 / API)
- 멈추세요. 2~3개의 옵션을 보여주세요. 합리적인 첫 번째 선택을 맨 앞에 두세요. 항상 **건너뛰기(skip)**를 포함하세요.
- 기존 예제 / 플레이그라운드 / 데모
- 새 API를 사용하는 예제 앱 (위치와 새 패키지/의존성 확인 후에만)
- 실행 중인 서버에 대한 curl 또는 작은 스크립트
- 건너뛰기
- 기다리세요. 사용자가 선택할 때까지 빌드하거나 실행하지 마세요.
- 건너뛰기(skip): 증명되지 않음이라고 말하세요. 작동한다고 말하지 마세요. 중단하세요 (절차 4 없음).
- 기존 플레이그라운드: 실행한 후, UI가 있다면 브라우저에서 증명하고, 스크립트라면 명령어 출력을 보여주세요.
- 예제 앱: 위치를 물어보세요. 기존 예제를 선호하세요. 사용자가 동의하지 않으면 패키지나 의존성을 추가하지 마세요. 그런 다음 실행하고 증명하세요.
- curl/스크립트: 실행하세요. 종료 코드와 주장을 증명하는 출력 부분을 인용하세요.
- 절차 4.
절차 4: 선택적 보고서
- 실제 증명 후에 물어보세요: 스크린샷 보고서를 작성할까요? 기본값은 아니오입니다.
- 아니오: 중단하세요. 채팅에 이미 증거가 있습니다.
- 예:
.agent/scratch/prove-it.md를 작성하세요 (덮어쓰기)..agent/scratch/가 없으면 gitignore에 추가하세요 (다른 스크래치 파일과 동일). 클릭한 내용과 스크린샷을 포함하세요. 파일을 여세요. 커밋하지 마세요. - 증명 건너뛰기 → 보고서 없음.
절차 5: 중단
증명 또는 건너뛰기 후, 중단하세요. 이 스킬에서 관련 없는 작업을 시작하지 마세요.
결정 트리
- 사용자가 증명을 요청하지 않음 → 이 스킬이 적용되지 않습니다.
- UI → 절차 2 → 4 → 5.
- 서버/API → 절차 3 → 4 → 5 (건너뛰기는 3에서 종료).
- 둘 다 → 절차 2, 그 다음 절차 3, 그 다음 4 → 5.
- 시작 명령어가 없고 앱이 실행 중이 아님 → UI를 증명할 수 없다고 말하세요. 건너뛰거나 사용자가 시작하세요.
- 사용자가 건너뛰기 선택 → 증명되지 않음. 성공 주장 금지.
위험 신호 (Red Flags)
| 신호 | 의미 | 대신 할 것 |
|---|---|---|
| 테스트 통과로 완료되었다고 말함 | 이 스킬이 요청되지 않았거나 증명이 건너뛰어짐 | 절차 2 또는 3 이후에만 증명되었다고 주장 |
| 스크린샷 하나, 클릭 없음 | 사용자 경로가 아님 | 절차 2 단계 2 |
사용자가 선택하기 전에 examples/foo 빌드 | 요청되지 않은 앱 | 절차 3. 기다리세요. |
| Playwright / 새 서버 추가 | 새 의존성 | 기존 시작 명령어만 사용 |
pnpm dev를 실행 상태로 둠 | 와처가 켜져 있음 | 엄격한 제한 5 |
| "건너뛰지만 작동합니다" | 건너뛰기를 주장으로 전환 | 증명되지 않음이라고 말함 |
docs/에 보고서 파일 생성 | 제품 문서 | .agent/scratch/prove-it.md |
| 사용자가 '아니오'라고 했는데 보고서 열기 | 요청되지 않은 파일 | 절차 4 기본값 '아니오' |
| 새 공개 API에 대해 페이지만 증명 | 서버 부분이 조용히 건너뛰어짐 | API에 대해 절차 3 |
오류 처리
- 브라우저 도구 없음: 여기서 UI를 증명할 수 없다고 말하세요. 건너뛰기 또는 URL에서 기다리는 동안 사용자가 직접 클릭하도록 제안하세요. 스크린샷을 위조하지 마세요.
- 시작 명령어 실패: 오류를 인용하세요. UI가 작동한다고 말하지 마세요. 수정 또는 건너뛰기를 제안한 후 다시 증명하세요.
- 증명 실패 (클릭이 잘못된 동작, curl이 200이 아님): 증명되지 않음이라고 말하세요. 무엇이 실패했는지 명시하세요. 완료되었다고 말하지 마세요.
- 사용자가 예제 앱을 선택했지만 새 패키지를 거부: curl, 기존 예제, 또는 건너뛰기를 사용하세요. 어쨌든 패키지를 추가하지 마세요.
- 스크래치 파일 쓰기 실패: 증거를 채팅에 유지하세요. 보고서 파일이 작성되지 않았다고 말하세요.
다른 것은 참고하지 마세요. 채팅이 기본 증거입니다. 마크다운 파일은 선택 사항입니다.