UI 참조 캡처
코드는 구조, 스타일, 문자열 및 아이콘을 제공합니다. 하지만 런타임에 발생하는 일(백엔드가 응답하는 내용, 요소가 나타나는 순서, 실제 앱이 대기하는 시간)은 알 수 없으며, 타사 UI에 대해서는 아무것도 알려주지 않습니다. 이 스킬은 이러한 격차를 채우기 위해 참조 자료를 고정된 선호 순서로 제공하며, 리뷰어의 개인 브라우저에서 즉석으로 작업하지 않습니다.
마지막 규칙에는 역사가 있습니다. 이 스킬이 만들어진 프로덕션에서, 에이전트가 리뷰어의 로그인된 브라우저에 접근하여 라이브 앱을 캡처하도록 허용된 적이 있습니다. 라이브 플로우가 중단되었고, 에이전트는 리뷰어가 중단을 요청한 후에도 '정리' 단계를 계속 수행했으며, 테스트 작업 공간에 불필요한 항목을 남겼고, 세션은 약 68분 후에 사용할 수 있는 것이 아무것도 구축되지 않은 채 나쁘게 종료되었습니다. 동일한 캡처는 나중에 세션 기록에서 몇 분 만에 복구되었습니다. 먼저 오프라인 참조를 사용하고, 사용자가 요청할 때만 격리된 브라우저를 사용하며, 사용자가 중단을 요청하는 즉시 중지합니다.
위치
- 입력 파일(녹화, 내보내기, 사용자가 제공한 스크린샷): 도착하는 즉시
products/<slug>/references/<name>/에 복사합니다. 다운로드 폴더와 OS의 임시 캡처 폴더는 정리되며, 원래 프로덕션의 한 녹화는 시스템이 삭제했을 폴더에 있었습니다. macOS 녹화 이름에는 AM/PM 앞에 좁은 줄 바꿈 없는 공백(U+202F)이 포함됩니다. 이름을 입력하지 말고 글로브(glob)로 찾으십시오. - 작업 자료(수천 개의 프레임, 복구된 캡처, 원시 OCR): 모든 저장소 외부의 스크래치 폴더(예:
$TMPDIR/pvs-<slug>-<name>/). - 보관할 가치가 있는 결과(OCR 타임라인, 실제 데이터가 크롭된 키 프레임, 분석):
references/<name>/, SOURCES.md에서 인용.
실제 작업 공간의 녹화 및 캡처에는 실제 고객 이름, 이메일, 전화번호, 내부 ID 및 다른 사람의 대화가 포함됩니다. 이러한 내용은 워크벤치 저장소에 절대 들어가지 않으며, 비디오에도 표시되지 않습니다. 섹션 1 단계 6에는 변경해야 할 사항이 나열되어 있습니다.
기술 선택
| 보유한 자료 | 기술 | 읽을 파일 |
|---|---|---|
| 제품 화면 녹화 | 1. 녹화 분석 | references/recording-analysis.md |
| 앱을 본 과거 세션 | 2. 트랜스크립트에서 캡처 복구 | 이 파일, 섹션 2 |
| 로컬에서 실행 가능한 앱 | 3. 프로덕션처럼 구축된 로컬 인스턴스 | references/local-instance.md |
| 타사 제품 | 4. 웹 리서치, 공개 소스만 | references/third-party-ui-prompt.md |
| 없음(전화 통화, 엔드 카드, 생성된 텍스트) | 키트에서 디자인하고 표시 | product-truth (mock) |
해당 순서대로 시도하십시오. 누군가에게 녹화를 요청하기 전에 섹션 2를 확인하십시오. 캡처가 이미 존재할 수 있습니다. 네 가지 모두 작동하지 않으면 그렇게 말하고, 리뷰어의 브라우저로 대체하지 마십시오.
1. 화면 녹화 분석
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
S="$PVS_HOME/skills/ui-reference-capture/scripts"
W="$TMPDIR/pvs-acme-board" # 저장소 외부 스크래치
bash "$S/frames.sh" references/board/rec.mov "$W" --fps 10 --logical-width 1440
bash "$S/ocr.sh" "$W/logical" "$W/ocr.jsonl" # macOS 전용
"$PVS_HOME/bin/pvs-py" "$S/ocr_events.py" "$W/ocr.jsonl" references/board/ocr-timeline.txt --fps 10 \
--region "panel=0.6,0,1,[email protected]"
"$PVS_HOME/bin/pvs-py" "$S/grid.py" sheet "$W/overview.png" "$W/logical" --every 20 --cols 4
frames.sh는 작은 썸네일(변경 감지)과 앱의 논리적 너비로 프레임을 기록합니다(레티나 녹화는 2배: 논리적 너비는 픽셀 너비의 절반). 따라서 한 프레임 픽셀은 재구성된 앱의 CSS 1px과 같습니다.ocr.sh는ocr.swift(Apple Vision)를 캐시 폴더에 한 번 컴파일하고 프레임당 하나의 JSON 라인을 작성합니다. Linux에서는 "unsupported"와 함께 종료됩니다. 대신 콘택트 시트를 읽으십시오.ocr_events.py는 프레임별 OCR을 안정적인 범위로 변환합니다:start-end [region] text. 이 타임라인은 실제 앱이 표시하는 정확한 문자열과 시점을 제공하며, 비디오를 육안으로 추측하는 것보다 훨씬 뛰어납니다.grid.py sheet는 콘택트 시트를 만듭니다: 2초마다 개요, 그런 다음 단계별로 10fps의 조밀한 시트.grid.py overlay는 측정을 위해 프레임에 논리적 픽셀 그리드를 그립니다.- 키 프레임을
references/<name>/frames/<t>-<state>.jpg로 저장합니다(실제 데이터는 크롭). references/<name>/analysis.md를references/recording-analysis.md의 구조로 작성합니다: 정확한 문자열이 포함된 실제 타임라인, 측정된 모션(패널이 열리는 데 걸리는 시간, 커서가 멈추는 시간), "비디오를 위해 변경해야 함" 표(실제 이름, 이메일, 전화번호, 작업 공간, 내부 ID, 긴 대기 시간, Dock과 같은 OS 크롬), 그리고 누군가가 그 위에 구축하기 전에 제기해야 할 제품 격차(스토리에 필요한 단계이지만 녹화에서 실패하는 것으로 표시됨).
녹화는 대기 시간이 압축될 때 격차를 숨깁니다. 단축한 모든 대기를 기록하십시오.
2. 과거 세션에서 캡처 복구
Claude Code 세션에서 도구가 반환한 모든 이미지(브라우저 스크린샷, 창 캡처, 읽은 이미지)와 채팅에 붙여넣은 모든 이미지는 해당 세션의 JSONL에 저장됩니다.
"$PVS_HOME/bin/pvs-py" "$S/recover_transcript_images.py" ~/.claude/projects/<project>/<session>.jsonl \
[--from-line N] [--tool screenshot]
출력 폴더가 없으면 새 임시 폴더에 쓰고 git 작업 트리 내부의 폴더는 거부합니다. 이러한 캡처는 실제 계정을 보여주기 때문입니다. index.tsv(파일, 시간, 도구, 입력)를 작성하여 필요한 화면을 찾을 수 있습니다. 콘택트 시트(grid.py sheet <out> <dir> --labels name)에서 검토한 다음, 실제 데이터가 크롭된 클리어된 것만 references/<name>/에 복사합니다. 원래 프로덕션에서 하나의 전체 비디오는 117개의 복구된 이미지와 코드로 구축되었습니다.
3. 프로덕션처럼 구축된 로컬 인스턴스
앱이 사용자 머신에서 실행될 수 있을 때 가장 신뢰할 수 있는 참조: 프로덕션 커밋에서 프로덕션 빌드 인수로 빌드하고, 가상 데이터로 시드하며, 모든 공유 시스템에서 격리하고, 헤드리스 브라우저로 캡처합니다. 시작하기 전에 references/local-instance.md를 읽으십시오. 사용자가 앱 실행에 동의해야 하며, 사용자의 계정이나 공유 데이터베이스를 절대 사용하지 않습니다.
4. 타사 UI
타사 화면의 경우 references/third-party-ui-prompt.md로 리서치 서브 에이전트를 실행합니다: 공개 소스만(공식 문서, 도움말 센터, 보도 자료, 마케팅 스크린샷, 벤더 소유의 공개 임베드 데모), 로그인 절대 금지, 제출 또는 예약 절대 금지, 약 30분. 모든 값은 확인됨, 측정됨 또는 추론됨으로 표시되어 반환됩니다. 자체 컴포넌트가 있는 제품의 경우 해당 컴포넌트를 선호합니다(채팅 앱의 미리보기를 렌더링하는 제품에는 미리보기 컴포넌트가 있음, 채팅 앱을 재구축하는 대신 사용). 실제 통합을 증명하는 경우에만 전체 타사 화면을 표시하고, 그 외에는 제품 내부에서 로고와 배지를 사용합니다.
일치: 재구축이 일치함을 증명
"$PVS_HOME/bin/pvs-py" "$S/pair.py" snapshots/nocam-12.4s.png references/board/frames/12.4-board.png \
640 40 1100 300 "$W/pair-board-header.png" --ref-scale 2 --logical-width 1440 --render-width 1920
카메라를 배율 1로 설정하여 우리의 스냅샷을 찍고(#camera{transform:none!important}가 포함된 컴포지션 복사본), 두 이미지에서 동일한 논리적 상자를 크롭하여 쌓습니다. 스크립트는 채널당 평균 절대 차이를 출력합니다. 차이가 더 이상 감소하지 않고 쌓인 이미지에 오프셋이 없을 때까지 반복합니다. 앱 px로 측정하고 명시적으로 변환하십시오: 혼란스러운 배율은 잘못된 좌표의 반복적인 원인이었습니다.
규칙 및 이유
- 리뷰어의 개인 브라우저나 프로필을 절대 사용하지 않음, 그로부터 가져온 것(글꼴, 아이콘, 저장소)도 사용하지 않음. 누군가 중단을 요청하면 정리 과정을 포함한 모든 브라우저 작업을 즉시 중지.
- 로그인 절대 금지, 토큰이나 브라우저 저장소를 읽지 않음. 캡처에 로그인이 필요한 경우, 해당 사람이 자신의 세션에 자신의 비밀번호를 입력하거나 캡처가 이루어지지 않습니다.
- 복구 및 녹화된 자료는 비공개로 유지. 먼저 임시 폴더에 저장하고, 크롭된 복사본만 사용.
- 모든 추론된 값을 표시. 절반만 추측된 참조는 어느 절반인지 명시해야 함.