/design-handoff
익숙하지 않은 플레이스홀더가 보이거나 연결된 도구를 확인해야 한다면 CONNECTORS.md를 참조하세요.
디자인으로부터 포괄적인 개발자 핸드오프 문서를 생성합니다.
사용법
/design-handoff $ARGUMENTS
핸드오프 스펙 생성 대상: @$1
Figma URL이 제공되면 Figma에서 디자인을 가져옵니다. 그렇지 않으면 제공된 설명이나 스크린샷을 기준으로 작업합니다.
포함할 내용
시각적 사양
- 정확한 측정값 (패딩, 마진, 너비)
- 디자인 토큰 참조 (색상, 타이포그래피, 간격)
- 반응형 중단점 및 동작
- 컴포넌트 변형 및 상태
상호작용 사양
- 클릭/탭 동작
- 호버 상태
- 전환 및 애니메이션 (지속 시간, 이징)
- 제스처 지원 (스와이프, 핀치, 길게 누르기)
콘텐츠 사양
- 문자 제한
- 줄임표 처리 동작
- 빈 상태
- 로딩 상태
- 오류 상태
엣지 케이스
- 최소/최대 콘텐츠
- 다국어 텍스트 (더 긴 문자열)
- 느린 연결
- 누락된 데이터
접근성
- 포커스 순서
- ARIA 레이블 및 역할
- 키보드 상호작용
- 스크린 리더 알림
원칙
- 추측하지 마세요: 명시되지 않으면 개발자는 추측하게 됩니다. 모든 것을 명시하세요.
- 값 대신 토큰을 사용하세요:
16px대신spacing-md를 참조하세요. - 모든 상태를 보여주세요: 기본, 호버, 활성, 비활성, 로딩, 오류, 빈 상태.
- 이유를 설명하세요: "모바일에서는 사용자가 주로 한 손으로 사용하기 때문에 접힙니다"와 같은 설명은 개발자가 좋은 판단을 내리는 데 도움이 됩니다.
출력
## 핸드오프 스펙: [기능/화면 이름]
### 개요
[이 화면/기능의 용도, 사용자 컨텍스트]
### 레이아웃
[그리드 시스템, 중단점, 반응형 동작]
### 사용된 디자인 토큰
| 토큰 | 값 | 용도 |
|-------|-------|-------|
| `color-primary` | #[hex] | CTA 버튼, 링크 |
| `spacing-md` | [X]px | 섹션 간 간격 |
| `font-heading-lg` | [크기/두께/글꼴] | 페이지 제목 |
### 컴포넌트
| 컴포넌트 | 변형 | 속성 | 비고 |
|-----------|---------|-------|------|
| [컴포넌트] | [변형] | [속성] | [특별 동작] |
### 상태 및 상호작용
| 요소 | 상태 | 동작 |
|---------|-------|----------|
| [CTA 버튼] | 호버 | [배경 10% 어둡게] |
| [CTA 버튼] | 로딩 | [스피너, 비활성화] |
| [폼] | 오류 | [빨간 테두리, 오류 메시지 아래] |
### 반응형 동작
| 중단점 | 변경 사항 |
|------------|---------|
| 데스크톱 (>1024px) | [기본 레이아웃] |
| 태블릿 (768-1024px) | [변경 사항] |
| 모바일 (<768px) | [변경 사항] |
### 엣지 케이스
- **빈 상태**: [데이터가 없을 때 표시할 내용]
- **긴 텍스트**: [줄임표 규칙]
- **로딩**: [스켈레톤 또는 스피너]
- **오류**: [오류 상태 표시]
### 애니메이션 / 모션
| 요소 | 트리거 | 애니메이션 | 지속 시간 | 이징 |
|---------|---------|-----------|----------|--------|
| [요소] | [트리거] | [설명] | [ms] | [이징] |
### 접근성 참고 사항
- [포커스 순서]
- [필요한 ARIA 레이블]
- [키보드 상호작용]
커넥터 사용 가능 시
~~디자인 도구가 연결된 경우:
- Figma에서 정확한 측정값, 토큰 및 컴포넌트 사양 가져오기
- 에셋 내보내기 및 완전한 스펙 시트 생성
~~프로젝트 트래커가 연결된 경우:
- 핸드오프를 구현 티켓에 연결
- 스펙의 각 섹션에 대한 하위 작업 생성
팁
- Figma 링크를 공유하세요: 정확한 측정값, 토큰 및 컴포넌트 정보를 가져올 수 있습니다.
- 엣지 케이스를 언급하세요: "100개 항목이 있으면 어떻게 되나요?"와 같은 내용이 경계 조건을 명세하는 데 도움이 됩니다.
- 기술 스택을 명시하세요: "React + Tailwind를 사용합니다"라고 알려주면 관련 구현 노트를 제공하는 데 도움이 됩니다.