← ClaudeAtlas

screenshot-annotatorlisted

Annotate screenshots for documentation — draw region outlines, leader lines and numbered callout badges, with coordinates measured from pixels, leader lines routed without overlap, and everything verified before drawing. Outputs PNG (no Figma needed) or draws into Figma. 한국어 트리거 — "스크린샷에 번호 달아줘", "마크업 적용", "콜아웃 추가", "박스 위치 보정", "절차 이미지 만들어줘", "확대 도해", "상태 카탈로그", "표시 자리 점선". Not for general image editing or design generation.
seonhwakei/screenshot-annotator · ★ 0 · Data & Documents · score 63
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 | 노