screenshot-to-compose은(는) 무엇을 하나요?
디자인을 Compose에서 눈대중 없이 충실히 재현합니다. 참조 이미지가 곧 승인 테스트이므로, 사용하는 모든 숫자는 관찰된 값(이미지에서 측정)이거나 추론된 값(추측임을 명시)이어야 하며, 완성된 화면은 마지막에 참조 이미지와 비교됩니다.
디자인이 입력으로 주어질 때
- 스크린샷/목업만 있는 경우: 아래 모든 단계를 따릅니다.
- Figma 프레임이 있는 경우: 측정 단계를 건너뛰고(Figma에서 값을 읽어옴) 나머지 단계를 진행합니다.
- 디자인이 아직 없는 경우: 먼저
app-design-studio스킬을 사용하고, 그 후에 이곳으로 돌아옵니다.
워크플로우
docs/design/ 디렉토리에서 파일 단위로 작업하며, 공통 기반이 마련된 후에 한 화면씩 진행합니다. 전체 화면 인벤토리를 이해하기 전에는 어떤 것도 구현하지 마십시오.
- 검사. 저장소를 먼저 읽습니다(아키텍처, 테마, 공유 컴포넌트, 기존 화면). 잘 동작하는 것은 유지합니다. 가정 사항을 기록합니다.
- 인벤토리. 참조 이미지를 수정 없이
docs/design/reference/에 복사합니다(케밥-케이스 이름 사용).SCREEN_INVENTORY.md를 작성합니다: 각 이미지 -> 화면 + 상태, 화면 간 링크, 누락된 참조(링크되었지만 이미지가 없는 화면), 픽셀 크기 및 종횡비. 로딩, 빈 상태, 에러, 오프라인, 권한, 프리미엄 등 모든 상태를 포함합니다. - 측정.
scripts/measure_image.py shot.png --frame-dp 390 --sample x,y ...를 실행하여 px->dp 스케일과 색상 샘플을 얻습니다(references/measuring.md참조). 픽셀은 dp가 아닙니다: 별도 지시가 없으면 390 dp 프레임을 기준으로 하며,dp = px / (imageWidthPx / 390)공식을 사용합니다. 관찰된 값과 추론된 값을 별도 컬럼에 기록합니다. - 설계 시스템. 측정된 색상을 Material 3 역할, 타이포그래피 스케일, 도형, 간격에 매핑하여 테마를 구성합니다. 화면은 테마 토큰만 사용합니다(화면에 직접 16진수 색상, 크기, 둥글기 사용 금지). 라이트/다크 모드를 모두 정의하고, 라이트만 있는 경우 레이아웃을 변경하지 않고 다크 모드를 유도합니다.
- 에셋(
references/assets.md). 아이콘: 하나의 패밀리를 선택하여 Iconify에서 가져오고scripts/svg_to_vectordrawable.py로 변환합니다. 아트워크: 직접 생성하며, 스크린샷에서 잘라내지 않습니다. 텍스트, 버튼, 카드, 링, 차트는 항상 Compose로 구현하고 이미지를 사용하지 않습니다. 출처, 라이선스, 모델, 프롬프트를ASSET_INVENTORY.md에 기록합니다. - 계획. 화면별로 사전에 결정할 사항: 뒤로가기 동작, 네트워크/오프라인 클래스, 권한, 작은 폰에서 스크롤 또는 맞춤, 모션.
SCREEN_IMPLEMENTATION_PLAN.md를 작성하고 빌드 순서를 정합니다. (이에 대한 품질 규칙은android-compose-quality-gate스킬에 있습니다.) - 구현 공통 기반을 먼저 만든 후 화면을 구현합니다: 불변 UI 상태 위의 무상태(stateless) 컴포저블, 인텐트가 있는 ViewModel, 파일당 하나의 컴포저블, 모든 텍스트는 문자열 리소스 사용. 독립적인 모듈만 파일이 겹치지 않도록 병렬화합니다. 카드, 타일 또는 빡빡한 텍스트를 만들기 전에
references/compose-lessons.md를 읽습니다. - 비교(
references/verification.md). 화면을 렌더링하고(에뮬레이터 스크린샷 또는 Roborazzi),scripts/compare_side_by_side.py로 참조 이미지와 동일한 너비로 나란히 배치한 후 레이아웃, 간격, 타이포그래피, 색상, 도형, 에셋의 차이를 나열하고 수정한 후 반복합니다. 그 다음 작은 기기(360 x 526 dp), 긴 텍스트/독일어, RTL, 다크 모드, 글꼴 크기 1.3을 테스트합니다. 픽셀 단위의 일치를 위해 기능이나 반응성을 희생하지 마십시오. - 전달. 참조 이미지, 프롬프트가 포함된 에셋, 아이콘 출처/라이선스, 인벤토리 및 비교 노트를 최신 상태로 유지합니다. 화면이 실제로 동작하고 시각적 비교를 통과했을 때만 완료된 것으로 간주합니다. 주제별로 커밋합니다.
일반적인 실패를 막는 규칙
- 참조 스크린샷에서 이미지를 잘라내지 마십시오(저해상도, 압축됨, UI가 내장됨).
- 네이티브 UI를 이미지로 대체하지 마십시오.
- 참조가 모호할 때 디자인을 임의로 만들지 마십시오: 가장 합리적인 추론을 하고 추론된 컬럼에 기록하며 참조에 가깝게 유지합니다.
- 실행 및 비교 전에는 화면이 완료되었다고 주장하지 마십시오.
- 저장소나 문서에 비밀(API 키)을 포함하지 마십시오; 이미지 서비스 키는 환경 변수에서 가져옵니다.
파일
references/measuring.md- px에서 dp로 변환, 색상 샘플링, 관찰된 값과 추론된 값 표.references/assets.md- Iconify에서 VectorDrawable로 변환, 이미지 생성 순서 및 리뷰, 내보내기 크기, 기타 출처.references/compose-lessons.md- 실제 시간을 소모했던 결함: 형제 카드 비율, 내부 측정 크래시, 너비 임계값, 자동 크기 조절 텍스트.references/verification.md- 에뮬레이터와 Roborazzi 비교 루프 및 기기 매트릭스.scripts/measure_image.py,scripts/svg_to_vectordrawable.py,scripts/compare_side_by_side.py(Python 3 + Pillow).