screenshot-annotatorlisted
Install: claude install-skill seonhwakei/screenshot-annotator
# screenshot-annotator
제품 매뉴얼용 스크린샷에 **영역선 + 리더선 + 번호 배지**를 그린다.
Figma에 그릴 때는 대상 파일 키와 페이지 id를 **작업 시작 시 사용자에게 확인**한다.
Figma 없이 쓸 때는 `render.py`로 PNG를 내보낸다 — 좌표·스타일은 양쪽이 같다.
---
## 0. 불변식 — 이걸 어기면 반드시 어긋난다
지금까지 발생한 좌표 오류는 **전부** 아래 4가지 중 하나였다. 작업 전에 확인한다.
### 0-1. 측정은 **노드 export** 위에서만 한다
원본 이미지(`rawImages`)나 직접 리사이즈한 로컬 사본으로 좌표를 재면 안 된다.
이미지 fill은 `scaleMode: FILL`이라 **비율이 다르면 잘라낸다(crop)**.
| 원본 | 박스 | 결과 |
|---|---|---|
| 1918×965 (1.988) | 1040×524 (1.985) | crop 무시 가능 |
| **1920×1009 (1.903)** | 1040×524 (1.985) | **상·하 11px씩 잘림** → 위치별로 다르게 밀림 |
```
y_render ≈ y_squash × 1.043 − 6 # 1920×1009 케이스의 실제 어긋남
```
→ 반드시 `download_assets(nodeId=<그 rect>, defaultScale=1)`로 **렌더된 픽셀**을 받아
그 위에서 측정·라우팅·halo 판정을 **전부** 수행한다.
### 0-2. 좌표 기준계는 상수 하나로 고정
```
IMG_X, IMG_Y = 230, 60 # 프레임 안 이미지 원점
frame_x = IMG_X + image_x
frame_y = IMG_Y + image_y # 밴드가 여러 개면 + BAND_Y
```
밴드마다 이미지 y 오프셋을 다르게 두면 확대 도해의 표시 박스가 어긋난다(L4 사례, 68px).
### 0-3. Figma `node.x/y`는 **부모 상대 좌표**
섹션 안 프레임에 절대 좌표를 넣으면 프레임이 캔버스 저편으로 날아가 "안 보인다".
`absoluteBoundingBox`로 검증한다.
따라서 **섹션을 옮길 때 자식을 같이 옮기면 두 번 밀린다.** `sec.y = ny` 한 줄이면 끝이다.
(`clone()` 후 델타를 자식에도 더했다가 51프레임이 전부 섹션 밖으로 나갔다.)
### 0-4. 번호의 뜻은 **절차문**에서 읽는다 (2.2 화면 구성 표가 아니다)
같은 화면이라도 `2.2 화면 구성` 표의 번호와 `2.3 조작 절차`의 번호는 **다른 요소**를
가리킨다. 절차판을 그리면서 화면 구성 표의 라벨을 쓰면 번호는 맞고 대상이 틀린다.
실제 사례 — A-04-2 (1) 노드 상태:
| 번호 | 화면 구성 표(shot18) | **절차문 A-04-2** | v9에 그려져 있던 것 |
|---|---|---|---|
| 1 | 연결 상태 | **노드 이름** | 연결 상태 ❌ |
| 2 | 노