@su-record/vibe 2.8.38 → 2.8.40
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/skills/vibe.figma/SKILL.md +98 -85
- package/skills/vibe.figma/templates/figma-handoff.md +37 -33
- package/skills/vibe.figma.convert/SKILL.md +65 -34
- package/skills/vibe.figma.convert/rubrics/conversion-rules.md +14 -5
- package/skills/vibe.figma.convert/templates/component.md +14 -16
- package/skills/vibe.figma.extract/SKILL.md +78 -26
- package/skills/vibe.figma.extract/rubrics/image-rules.md +69 -47
- package/skills/vibe.figma.analyze/SKILL.md +0 -10
- package/skills/vibe.figma.analyze/rubrics/analysis-dimensions.md +0 -53
- package/skills/vibe.figma.codegen/SKILL.md +0 -10
- package/skills/vibe.figma.codegen/rubrics/code-quality.md +0 -54
- package/skills/vibe.figma.consolidate/SKILL.md +0 -10
- package/skills/vibe.figma.consolidate/templates/consolidation-report.md +0 -95
- package/skills/vibe.figma.frame/SKILL.md +0 -10
- package/skills/vibe.figma.frame/rubrics/frame-selection.md +0 -55
- package/skills/vibe.figma.pipeline/SKILL.md +0 -11
- package/skills/vibe.figma.pipeline/rubrics/pipeline-stages.md +0 -96
- package/skills/vibe.figma.rules/SKILL.md +0 -10
- package/skills/vibe.figma.rules/rubrics/naming-conventions.md +0 -70
- package/skills/vibe.figma.style/SKILL.md +0 -10
- package/skills/vibe.figma.style/rubrics/style-mapping.md +0 -100
|
@@ -42,7 +42,7 @@ Bash:
|
|
|
42
42
|
|
|
43
43
|
트리 데이터의 용도 (vibe.figma.convert에서 직접 매핑):
|
|
44
44
|
- Auto Layout → CSS Flexbox (direction, gap, padding, align 1:1)
|
|
45
|
-
- absoluteBoundingBox → width, height (
|
|
45
|
+
- absoluteBoundingBox → width, height (→ vw 변환)
|
|
46
46
|
- fills/strokes/effects → background, border, shadow 등
|
|
47
47
|
- TEXT 노드 → 텍스트 콘텐츠 + 타이포그래피 CSS
|
|
48
48
|
- imageRef → 이미지 에셋 매핑
|
|
@@ -53,7 +53,7 @@ Bash:
|
|
|
53
53
|
|
|
54
54
|
트리 추출 도구가 자동 변환하는 속성. **이 값들이 SCSS에 직접 매핑된다:**
|
|
55
55
|
|
|
56
|
-
| Figma 속성 | CSS |
|
|
56
|
+
| Figma 속성 | CSS | vw 변환 |
|
|
57
57
|
|-----------|-----|-----------------|
|
|
58
58
|
| `layoutMode=VERTICAL` | `display:flex; flex-direction:column` | ❌ |
|
|
59
59
|
| `layoutMode=HORIZONTAL` | `display:flex; flex-direction:row` | ❌ |
|
|
@@ -84,36 +84,80 @@ Bash:
|
|
|
84
84
|
|
|
85
85
|
---
|
|
86
86
|
|
|
87
|
-
## 2. 이미지 에셋
|
|
87
|
+
## 2. 이미지 에셋 — 노드 렌더링 기반 (imageRef 개별 다운로드 금지)
|
|
88
88
|
|
|
89
|
-
|
|
89
|
+
```
|
|
90
|
+
❌ imageRef 개별 다운로드 금지
|
|
91
|
+
→ 텍스처 fill을 공유하는 경우 원본 텍스처(22.7MB)가 다운됨
|
|
92
|
+
→ 노드 렌더링하면 해당 노드에 적용된 최종 결과물(364KB)이 나옴
|
|
90
93
|
|
|
94
|
+
✅ 모든 이미지는 Figma screenshot API로 노드 렌더링
|
|
91
95
|
```
|
|
92
|
-
트리에서 imageRef 수집 → Figma API로 다운로드:
|
|
93
96
|
|
|
94
|
-
|
|
95
|
-
|
|
97
|
+
### 2-1. BG 프레임 렌더링 (섹션 배경)
|
|
98
|
+
|
|
99
|
+
```
|
|
100
|
+
각 섹션의 BG 프레임을 식별 → 합성된 배경 1장으로 렌더링:
|
|
101
|
+
|
|
102
|
+
BG 프레임 판별 기준:
|
|
103
|
+
- name에 "BG", "bg" 포함
|
|
104
|
+
- 또는 부모와 크기 동일(±10%) + 자식 이미지 3개 이상
|
|
105
|
+
- 또는 1depth 첫 번째 자식이면서 이미지 노드 다수 보유
|
|
96
106
|
|
|
97
|
-
|
|
107
|
+
렌더링:
|
|
108
|
+
node "[FIGMA_SCRIPT]" screenshot {fileKey} {bg.nodeId} --out=/tmp/{feature}/bg/{section}-bg.png
|
|
98
109
|
|
|
99
|
-
|
|
110
|
+
→ BG 하위 20+ 레이어가 합성된 1장
|
|
111
|
+
→ CSS background-image로 처리
|
|
112
|
+
→ 개별 레이어(눈, 나무, 파티클 등) 다운로드하지 않음
|
|
100
113
|
```
|
|
101
114
|
|
|
102
|
-
### 2-2.
|
|
115
|
+
### 2-2. 콘텐츠 노드 렌더링
|
|
103
116
|
|
|
104
117
|
```
|
|
105
|
-
|
|
118
|
+
BG가 아닌 콘텐츠 이미지를 개별 노드 렌더링:
|
|
106
119
|
|
|
107
120
|
대상 식별 (tree.json에서):
|
|
108
|
-
-
|
|
109
|
-
- name에 "
|
|
110
|
-
- VECTOR/GROUP
|
|
121
|
+
- 타이틀/서브타이틀 이미지 (name에 "title", "sub title")
|
|
122
|
+
- 버튼 이미지 (name에 "btn", "button")
|
|
123
|
+
- 아이콘 (VECTOR/GROUP 크기 ≤ 64px)
|
|
124
|
+
- 아이템/보상 이미지 (name에 "item", "reward", "token", "coin")
|
|
125
|
+
|
|
126
|
+
렌더링 (imageRef 다운로드 아님!):
|
|
127
|
+
node "[FIGMA_SCRIPT]" screenshot {fileKey} {node.nodeId} --out=/tmp/{feature}/content/{name}.png
|
|
128
|
+
|
|
129
|
+
→ 텍스처 fill이 적용된 최종 결과물이 나옴
|
|
130
|
+
→ 22.7MB 텍스처 대신 364KB 렌더링 이미지
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
### 2-3. 벡터 글자 그룹 렌더링
|
|
134
|
+
|
|
135
|
+
```
|
|
136
|
+
커스텀 폰트 텍스트가 글자별 벡터로 분리된 경우:
|
|
137
|
+
|
|
138
|
+
판별:
|
|
139
|
+
- 부모 GROUP/FRAME 아래 VECTOR 타입 3개 이상
|
|
140
|
+
- 각 VECTOR 크기 < 60x60
|
|
141
|
+
- 같은 imageRef를 공유 (텍스처 fill)
|
|
111
142
|
|
|
112
143
|
렌더링:
|
|
113
|
-
|
|
144
|
+
부모 GROUP을 통째로 렌더링 (개별 글자 다운로드 금지)
|
|
145
|
+
node "[FIGMA_SCRIPT]" screenshot {fileKey} {group.nodeId} --out=/tmp/{feature}/content/{name}.png
|
|
114
146
|
|
|
115
|
-
|
|
116
|
-
|
|
147
|
+
예시:
|
|
148
|
+
"MISSION 01" GROUP (174x42, 벡터 9개) → 렌더링 1장 (58KB)
|
|
149
|
+
"일일/누적 출석" GROUP (327x51, 벡터 7개) → 렌더링 1장 (93KB)
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
### 2-4. imageRef 다운로드를 사용하는 유일한 경우
|
|
153
|
+
|
|
154
|
+
```
|
|
155
|
+
노드 렌더링이 불가능한 경우에만 imageRef 다운로드 폴백:
|
|
156
|
+
- Figma screenshot API 실패 (rate limit, 권한 등)
|
|
157
|
+
- 노드가 DOCUMENT 레벨이라 렌더링 불가
|
|
158
|
+
|
|
159
|
+
이 경우에도 파일 크기 확인:
|
|
160
|
+
- 5MB 초과 → 텍스처 fill 가능성 높음 → 경고 로그
|
|
117
161
|
```
|
|
118
162
|
|
|
119
163
|
---
|
|
@@ -144,21 +188,29 @@ fill 이미지가 없지만 시각적으로 의미 있는 노드를 PNG로 렌
|
|
|
144
188
|
|
|
145
189
|
/tmp/{feature}/
|
|
146
190
|
├── tree.json ← 코드 생성의 PRIMARY 소스
|
|
147
|
-
├──
|
|
148
|
-
│ ├──
|
|
149
|
-
│ ├──
|
|
191
|
+
├── bg/ ← BG 프레임 렌더링 (섹션당 1장)
|
|
192
|
+
│ ├── hero-bg.png
|
|
193
|
+
│ ├── daily-bg.png
|
|
194
|
+
│ └── ...
|
|
195
|
+
├── content/ ← 콘텐츠 노드 렌더링
|
|
196
|
+
│ ├── hero-title.png
|
|
197
|
+
│ ├── hero-subtitle.png
|
|
198
|
+
│ ├── mission-01.png ← 벡터 글자 그룹 렌더링
|
|
199
|
+
│ ├── btn-login.png
|
|
150
200
|
│ └── ...
|
|
151
201
|
├── full-screenshot.png ← Phase 4 검증용
|
|
152
202
|
└── sections/ ← Phase 4 섹션별 검증용
|
|
153
203
|
├── hero.png
|
|
154
204
|
└── ...
|
|
155
205
|
|
|
156
|
-
이미지
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
206
|
+
이미지 분류 (실제 테스트 기준):
|
|
207
|
+
| 분류 | 처리 | 예시 |
|
|
208
|
+
|------|------|------|
|
|
209
|
+
| BG 프레임 (89개) | 프레임 렌더링 → bg/ | hero-bg.png (4.2MB) |
|
|
210
|
+
| 벡터 글자 (33개) | GROUP 렌더링 → content/ | mission-01.png (58KB) |
|
|
211
|
+
| 콘텐츠 (8개) | 노드 렌더링 → content/ | hero-title.png (364KB) |
|
|
212
|
+
| 장식 (29개) | BG 렌더링에 포함 | — |
|
|
213
|
+
→ 전체 159개 → 실제 파일 약 18장
|
|
162
214
|
|
|
163
215
|
색상 팔레트 (tree.json의 backgroundColor/color 고유값):
|
|
164
216
|
#0a1628, #00264a, #ffffff, ...
|
|
@@ -1,67 +1,89 @@
|
|
|
1
|
-
# Image Extraction Rules
|
|
1
|
+
# Image Extraction Rules — Node Rendering Based
|
|
2
2
|
|
|
3
|
-
##
|
|
4
|
-
|
|
5
|
-
- Output format: `.webp` always — never `.png`, `.jpg`, `.svg` from MCP asset URLs
|
|
6
|
-
- Exception: SVG icons referenced as inline code (not MCP URLs) stay as `.svg`
|
|
7
|
-
- Do not convert or re-encode after download — use the raw bytes from `curl`
|
|
3
|
+
## Core Principle
|
|
8
4
|
|
|
9
|
-
|
|
5
|
+
```
|
|
6
|
+
❌ imageRef 개별 다운로드 금지 (텍스처 fill 공유 문제)
|
|
7
|
+
✅ 모든 이미지는 Figma screenshot API로 노드 렌더링
|
|
8
|
+
```
|
|
10
9
|
|
|
11
|
-
|
|
10
|
+
## Render Methods
|
|
12
11
|
|
|
13
|
-
|
|
|
14
|
-
|
|
15
|
-
| `
|
|
16
|
-
|
|
|
17
|
-
| `
|
|
18
|
-
| `imgImgBannerStatic` | `banner-static.webp` (collapse double `img`) |
|
|
19
|
-
| `imgBtnShare` | `btn-share.webp` |
|
|
12
|
+
| 이미지 유형 | 렌더링 방법 | 출력 위치 |
|
|
13
|
+
|-----------|-----------|---------|
|
|
14
|
+
| BG 프레임 (합성 배경) | `screenshot {fileKey} {bg.nodeId}` | `bg/{section}-bg.png` |
|
|
15
|
+
| 콘텐츠 (타이틀, 버튼) | `screenshot {fileKey} {node.nodeId}` | `content/{name}.png` |
|
|
16
|
+
| 벡터 글자 그룹 | `screenshot {fileKey} {group.nodeId}` | `content/{name}.png` |
|
|
20
17
|
|
|
21
|
-
|
|
22
|
-
- Strip leading `img` prefix before converting to kebab-case
|
|
23
|
-
- Numbers stay as-is: `item11` → `item-11`
|
|
24
|
-
- Acronyms lowercased: `BTN` → `btn`, `BG` → `bg`
|
|
18
|
+
## BG 프레임 판별
|
|
25
19
|
|
|
26
|
-
|
|
20
|
+
```
|
|
21
|
+
BG 프레임 = 다음 중 하나:
|
|
22
|
+
- name에 "BG", "bg" 포함
|
|
23
|
+
- 부모와 크기 동일(±10%) + 자식 이미지 3개 이상
|
|
24
|
+
- 1depth 첫 번째 자식이면서 이미지 노드 다수 보유
|
|
27
25
|
|
|
26
|
+
→ 프레임 렌더링 1장 → CSS background-image
|
|
27
|
+
→ 하위 개별 레이어 다운로드하지 않음
|
|
28
28
|
```
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
29
|
+
|
|
30
|
+
## 벡터 글자 판별
|
|
31
|
+
|
|
32
32
|
```
|
|
33
|
+
벡터 글자 그룹 = 다음 모두 충족:
|
|
34
|
+
- 부모 GROUP/FRAME 아래 VECTOR 타입 3개 이상
|
|
35
|
+
- 각 VECTOR 크기 < 60x60
|
|
36
|
+
- 같은 imageRef 공유 (텍스처 fill)
|
|
33
37
|
|
|
34
|
-
|
|
38
|
+
→ 부모 GROUP 통째로 렌더링 (개별 글자 다운로드 금지)
|
|
39
|
+
→ 커스텀 폰트 텍스트 = 웹폰트 없음 → 이미지로 사용
|
|
40
|
+
```
|
|
35
41
|
|
|
36
|
-
##
|
|
42
|
+
## Format
|
|
37
43
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
| Background image | 500 KB | 2 MB |
|
|
41
|
-
| Content image | 200 KB | 1 MB |
|
|
42
|
-
| Decorative image | 100 KB | 500 KB |
|
|
43
|
-
| Total per section | 3 MB | 10 MB |
|
|
44
|
+
- Output format: `.png` (Figma screenshot API 기본)
|
|
45
|
+
- 최적화 필요 시 빌드 단계에서 webp 변환 (추출 단계에서는 png)
|
|
44
46
|
|
|
45
|
-
|
|
47
|
+
## Naming
|
|
46
48
|
|
|
47
|
-
|
|
49
|
+
렌더링된 이미지의 파일명 = Figma 노드 name을 kebab-case로:
|
|
50
|
+
- `"Hero"` BG frame → `hero-bg.png`
|
|
51
|
+
- `"Mission 01"` vector group → `mission-01.png`
|
|
52
|
+
- `"Title"` content → `hero-title.png` (섹션명 prefix)
|
|
53
|
+
- `"Btn_Login"` → `btn-login.png`
|
|
48
54
|
|
|
49
|
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
55
|
+
Rules:
|
|
56
|
+
- 공백 → 하이픈
|
|
57
|
+
- 언더스코어 → 하이픈
|
|
58
|
+
- 숫자 유지: `item11` → `item-11`
|
|
59
|
+
- 대문자 → 소문자
|
|
54
60
|
|
|
55
|
-
##
|
|
61
|
+
## Destination
|
|
56
62
|
|
|
57
|
-
|
|
63
|
+
```
|
|
64
|
+
/tmp/{feature}/{bp-folder}/
|
|
65
|
+
bg/ ← BG 프레임 렌더링
|
|
66
|
+
content/ ← 콘텐츠 + 벡터 글자 렌더링
|
|
67
|
+
sections/ ← Phase 4 검증용 스크린샷
|
|
68
|
+
```
|
|
58
69
|
|
|
59
|
-
|
|
60
|
-
const imageMap = {
|
|
61
|
-
imgTitle: '/images/{feature}/title.webp',
|
|
62
|
-
img21: '/images/{feature}/img-21.webp',
|
|
63
|
-
// ...every variable
|
|
64
|
-
}
|
|
70
|
+
최종 배치 (Phase 5):
|
|
65
71
|
```
|
|
72
|
+
static/images/{feature}/ ← Nuxt 2
|
|
73
|
+
public/images/{feature}/ ← Vue/Nuxt 3
|
|
74
|
+
public/{feature}/ ← Next.js
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## Size Limits
|
|
78
|
+
|
|
79
|
+
| Type | Warn threshold | Action |
|
|
80
|
+
|------|---------------|--------|
|
|
81
|
+
| BG 렌더링 | 5 MB | 정상 (합성 이미지라 큰 게 정상) |
|
|
82
|
+
| 콘텐츠 렌더링 | 1 MB | 경고 |
|
|
83
|
+
| 단일 이미지 > 5 MB | — | ⚠️ 텍스처 fill 의심 → imageRef 다운로드 실수 확인 |
|
|
84
|
+
|
|
85
|
+
## Fallback
|
|
66
86
|
|
|
67
|
-
|
|
87
|
+
노드 렌더링 불가 시에만 imageRef 다운로드:
|
|
88
|
+
- Figma screenshot API 실패 (rate limit, 권한)
|
|
89
|
+
- 다운로드 후 파일 크기 5MB 초과 → 텍스처 fill 가능성 → 경고 로그
|
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
# Analysis Dimensions — Figma Design Analysis
|
|
2
|
-
|
|
3
|
-
> This skill is merged into vibe.figma (Phase 1: Storyboard). These dimensions guide what to extract and evaluate when reading Figma frames.
|
|
4
|
-
|
|
5
|
-
## Layout
|
|
6
|
-
|
|
7
|
-
- [ ] Overall page structure — single column, multi-column, grid, or free-form absolute
|
|
8
|
-
- [ ] Section boundaries — identify where each distinct section starts/ends by visual grouping
|
|
9
|
-
- [ ] Container width — fixed px vs fluid (100%)
|
|
10
|
-
- [ ] Alignment system — centered, left-aligned, or asymmetric
|
|
11
|
-
- [ ] Z-layering — how many stacked layers exist (BG/content/overlay count)
|
|
12
|
-
- [ ] Overflow behavior — clip, hidden, visible, scroll
|
|
13
|
-
|
|
14
|
-
## Spacing Consistency
|
|
15
|
-
|
|
16
|
-
- [ ] Gap between sections — does a single spacing value repeat, or is each unique?
|
|
17
|
-
- [ ] Internal component padding — consistent across card variants?
|
|
18
|
-
- [ ] Icon-to-text gap — uniform within a component family?
|
|
19
|
-
- [ ] Recurring values — list values that appear 3+ times (these become spacing tokens)
|
|
20
|
-
- [ ] Irregular values — flag one-off spacings that may indicate design inconsistency
|
|
21
|
-
|
|
22
|
-
## Color Usage
|
|
23
|
-
|
|
24
|
-
- [ ] Background palette — how many distinct background colors exist?
|
|
25
|
-
- [ ] Text color roles — identify heading / body / label / disabled colors separately
|
|
26
|
-
- [ ] Accent/brand colors — primary CTA color, hover state color
|
|
27
|
-
- [ ] Transparency usage — rgba overlays, opacity layers
|
|
28
|
-
- [ ] Blend modes present — `mix-blend-lighten`, `multiply`, `hue` flag a literal-mode section
|
|
29
|
-
- [ ] Dark/light variants — does the design have both, requiring CSS variable tokens?
|
|
30
|
-
|
|
31
|
-
## Typography Hierarchy
|
|
32
|
-
|
|
33
|
-
- [ ] H1 equivalent — largest display text, font-size + weight + role
|
|
34
|
-
- [ ] H2 / section heading — size, weight, color
|
|
35
|
-
- [ ] Body text — base size, line-height, color
|
|
36
|
-
- [ ] Caption / label text — smallest size, usage context
|
|
37
|
-
- [ ] Font families — how many distinct families? Any variable fonts?
|
|
38
|
-
- [ ] Responsive scaling — does font-size change across breakpoints?
|
|
39
|
-
|
|
40
|
-
## Component Inventory
|
|
41
|
-
|
|
42
|
-
- [ ] Repeating UI patterns — cards, list items, tabs (candidates for `v-for`)
|
|
43
|
-
- [ ] State variants — default, hover, active, disabled, selected (note which states exist)
|
|
44
|
-
- [ ] Shared components — GNB, Footer, Popup (already in project or needs creation?)
|
|
45
|
-
- [ ] Interactive elements — buttons, links, inputs, toggles
|
|
46
|
-
- [ ] Decorative elements — particles, background shapes, overlay effects
|
|
47
|
-
|
|
48
|
-
## Storyboard-Specific Dimensions
|
|
49
|
-
|
|
50
|
-
- [ ] Frame classification — SPEC, CONFIG, SHARED, PAGE (by name pattern)
|
|
51
|
-
- [ ] Interaction annotations — arrows, overlay connections, state transitions in Figma
|
|
52
|
-
- [ ] Section count — total PAGE frames that need components
|
|
53
|
-
- [ ] Tall frames (1500px+) — flag for split strategy before `get_design_context`
|
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
# Code Generation Quality Checklist
|
|
2
|
-
|
|
3
|
-
> This skill is merged into vibe.figma.convert. Use this checklist to validate generated component and style files before moving to the next section.
|
|
4
|
-
|
|
5
|
-
## Structure
|
|
6
|
-
|
|
7
|
-
- [ ] Component file exists at `components/{feature}/{ComponentName}.vue` (or `.tsx`)
|
|
8
|
-
- [ ] Template is not empty — at least one visible HTML element with content
|
|
9
|
-
- [ ] No `placeholder` text remaining in any attribute or text node
|
|
10
|
-
- [ ] No `src=""` or `href=""` empty attributes
|
|
11
|
-
|
|
12
|
-
## Assets
|
|
13
|
-
|
|
14
|
-
- [ ] All `const img...` variables from reference code are replaced with local `/images/{feature}/` paths
|
|
15
|
-
- [ ] No `figma.com/api` URLs in any generated file
|
|
16
|
-
- [ ] Every image path references a file that was actually downloaded (cross-check image map)
|
|
17
|
-
- [ ] Decorative images have `alt="" aria-hidden="true"`
|
|
18
|
-
- [ ] Content images have descriptive `alt` text
|
|
19
|
-
|
|
20
|
-
## Styles (Normal Mode)
|
|
21
|
-
|
|
22
|
-
- [ ] No `<style>` block inside the component file
|
|
23
|
-
- [ ] No inline `style=""` attribute (exception: dynamic `:style` for mask-image)
|
|
24
|
-
- [ ] External layout file exists at `styles/{feature}/layout/_{section}.scss`
|
|
25
|
-
- [ ] External components file exists at `styles/{feature}/components/_{section}.scss`
|
|
26
|
-
- [ ] `_tokens.scss` updated with any new unique color/spacing/typography values
|
|
27
|
-
|
|
28
|
-
## Styles (Literal Mode)
|
|
29
|
-
|
|
30
|
-
- [ ] `<style scoped>` block present in component
|
|
31
|
-
- [ ] No external SCSS files created for this section
|
|
32
|
-
- [ ] All `position: absolute` coordinates are scaled by scaleFactor
|
|
33
|
-
- [ ] `mix-blend-mode`, `rotate`, `blur`, `mask-image` values preserved verbatim
|
|
34
|
-
- [ ] `%` values not scaled (only `px` values are scaled)
|
|
35
|
-
|
|
36
|
-
## TypeScript / Script
|
|
37
|
-
|
|
38
|
-
- [ ] JSDoc comment present with `[기능 정의]`, `[인터랙션]`, `[상태]` sections
|
|
39
|
-
- [ ] No `any` type — use explicit interfaces or `unknown`
|
|
40
|
-
- [ ] Mock data arrays have 3–7 items (not empty `[]`)
|
|
41
|
-
- [ ] Event handler stubs exist with `// TODO:` body
|
|
42
|
-
- [ ] Explicit return types on all functions
|
|
43
|
-
|
|
44
|
-
## Responsive
|
|
45
|
-
|
|
46
|
-
- [ ] Base styles target the smallest viewport (mobile-first)
|
|
47
|
-
- [ ] Desktop overrides use `@media (min-width: {$bp-pc})` or the project mixin
|
|
48
|
-
- [ ] No existing base styles deleted when adding breakpoint overrides
|
|
49
|
-
|
|
50
|
-
## Build
|
|
51
|
-
|
|
52
|
-
- [ ] No TypeScript compile errors in the generated file
|
|
53
|
-
- [ ] No missing imports (components, composables, types)
|
|
54
|
-
- [ ] Template references only props/data/computed that are declared in `<script setup>`
|
|
@@ -1,95 +0,0 @@
|
|
|
1
|
-
# Consolidation Report — {{FEATURE_NAME}}
|
|
2
|
-
|
|
3
|
-
**Feature Key:** {{FEATURE_KEY}}
|
|
4
|
-
**Date:** {{DATE}}
|
|
5
|
-
**Phase:** Post-implementation verification
|
|
6
|
-
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## Summary
|
|
10
|
-
|
|
11
|
-
| Metric | Value |
|
|
12
|
-
|--------|-------|
|
|
13
|
-
| Total sections | {{SECTION_COUNT}} |
|
|
14
|
-
| Sections passing | {{PASS_COUNT}} |
|
|
15
|
-
| P1 issues found | {{P1_COUNT}} |
|
|
16
|
-
| P2 issues found | {{P2_COUNT}} |
|
|
17
|
-
| Assets downloaded | {{ASSET_COUNT}} |
|
|
18
|
-
| Build status | {{BUILD_STATUS}} |
|
|
19
|
-
|
|
20
|
-
---
|
|
21
|
-
|
|
22
|
-
## Automated Grep Results
|
|
23
|
-
|
|
24
|
-
| Check | Result | Details |
|
|
25
|
-
|-------|--------|---------|
|
|
26
|
-
| `figma.com/api` in generated files | {{PASS/FAIL}} | {{COUNT}} occurrences |
|
|
27
|
-
| `<style` in `components/{{FEATURE_KEY}}/` | {{PASS/FAIL}} | {{COUNT}} occurrences |
|
|
28
|
-
| `style="` in `components/{{FEATURE_KEY}}/` | {{PASS/FAIL}} | {{COUNT}} occurrences |
|
|
29
|
-
| `placeholder` in components | {{PASS/FAIL}} | {{COUNT}} occurrences |
|
|
30
|
-
| `src=""` in components | {{PASS/FAIL}} | {{COUNT}} occurrences |
|
|
31
|
-
| Images in `public/images/{{FEATURE_KEY}}/` | {{PASS/FAIL}} | {{COUNT}} files |
|
|
32
|
-
|
|
33
|
-
---
|
|
34
|
-
|
|
35
|
-
## Section Review
|
|
36
|
-
|
|
37
|
-
| # | Section | Component | Mode | Screenshot Match | P1 | P2 |
|
|
38
|
-
|---|---------|-----------|------|-----------------|----|----|
|
|
39
|
-
| 1 | {{SECTION_NAME}} | `{{ComponentName}}.vue` | {{normal/literal}} | {{match %}} | {{count}} | {{count}} |
|
|
40
|
-
|
|
41
|
-
---
|
|
42
|
-
|
|
43
|
-
## P1 Issues (Must Fix)
|
|
44
|
-
|
|
45
|
-
### {{SECTION_NAME}} — {{ISSUE_TITLE}}
|
|
46
|
-
|
|
47
|
-
**Type:** {{image-missing / layout-mismatch / text-unstyled / asset-wrong-path}}
|
|
48
|
-
**Description:** {{DESCRIPTION}}
|
|
49
|
-
**Fix:** {{FIX_INSTRUCTION}}
|
|
50
|
-
**Status:** {{open / fixed}}
|
|
51
|
-
|
|
52
|
-
---
|
|
53
|
-
|
|
54
|
-
## P2 Issues (Recommended)
|
|
55
|
-
|
|
56
|
-
### {{SECTION_NAME}} — {{ISSUE_TITLE}}
|
|
57
|
-
|
|
58
|
-
**Type:** {{spacing-delta / color-delta / font-size-delta}}
|
|
59
|
-
**Description:** {{DESCRIPTION}} (delta: {{DELTA}})
|
|
60
|
-
**Fix:** {{FIX_INSTRUCTION}}
|
|
61
|
-
**Status:** {{open / deferred}}
|
|
62
|
-
|
|
63
|
-
---
|
|
64
|
-
|
|
65
|
-
## File Manifest
|
|
66
|
-
|
|
67
|
-
### Components
|
|
68
|
-
|
|
69
|
-
```
|
|
70
|
-
components/{{FEATURE_KEY}}/
|
|
71
|
-
{{FILE_LIST}}
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
### Styles
|
|
75
|
-
|
|
76
|
-
```
|
|
77
|
-
styles/{{FEATURE_KEY}}/
|
|
78
|
-
{{FILE_LIST}}
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
### Assets
|
|
82
|
-
|
|
83
|
-
```
|
|
84
|
-
public/images/{{FEATURE_KEY}}/
|
|
85
|
-
{{FILE_LIST}}
|
|
86
|
-
```
|
|
87
|
-
|
|
88
|
-
---
|
|
89
|
-
|
|
90
|
-
## Next Steps
|
|
91
|
-
|
|
92
|
-
- [ ] P1 count = 0 (required before handoff)
|
|
93
|
-
- [ ] Run `/design-normalize` → `/design-audit --quick`
|
|
94
|
-
- [ ] Optional: `/design-critique` → `/design-polish` for thorough review
|
|
95
|
-
- [ ] Commit with feature key tag: `feat({{FEATURE_KEY}}): figma design implementation`
|
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
# Frame Selection Rubric
|
|
2
|
-
|
|
3
|
-
> This skill is merged into vibe.figma.extract. Use this rubric to select the right frames before calling `get_design_context`.
|
|
4
|
-
|
|
5
|
-
## Frame Classification by Name Pattern
|
|
6
|
-
|
|
7
|
-
| Pattern in Name | Class | Action |
|
|
8
|
-
|----------------|-------|--------|
|
|
9
|
-
| "기능 정의서", "정책", "spec", "policy" | SPEC | `get_design_context` — extract text requirements |
|
|
10
|
-
| "해상도", "브라우저", "config", "resolution" | CONFIG | `get_design_context` — extract scale factor |
|
|
11
|
-
| "공통", "GNB", "Footer", "Popup", "shared", "common" | SHARED | Read if referenced; skip if project already has them |
|
|
12
|
-
| "화면설계", "메인 -", "section", numbered frames | PAGE | Core implementation targets |
|
|
13
|
-
|
|
14
|
-
## Selection Priority
|
|
15
|
-
|
|
16
|
-
1. SPEC frame (1 frame) — read first, informs all feature requirements
|
|
17
|
-
2. CONFIG frame (1 frame) — establishes scale factors for both breakpoints
|
|
18
|
-
3. PAGE frames — top-level only (e.g. `3.1`, `3.2`, not `3.1.1`, `3.1.2`)
|
|
19
|
-
4. SHARED frames — only if component does not already exist in the project
|
|
20
|
-
|
|
21
|
-
Never read sub-case frames (e.g. `3.1.1`, `3.2.1`) during Phase 1. Read them in Phase 2 only if a sub-state is needed for a specific interaction.
|
|
22
|
-
|
|
23
|
-
## Tall Frame Decision Tree
|
|
24
|
-
|
|
25
|
-
```
|
|
26
|
-
Frame height > 1500px?
|
|
27
|
-
YES → Split before calling get_design_context
|
|
28
|
-
1. get_metadata(nodeId) → get child node list
|
|
29
|
-
2. Call get_design_context per child node
|
|
30
|
-
3. Merge results as one logical section
|
|
31
|
-
NO → Call get_design_context directly
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
Height thresholds from real data:
|
|
35
|
-
- Safe direct call: up to ~900px
|
|
36
|
-
- Risk zone: 900–1500px (attempt once, split on timeout)
|
|
37
|
-
- Always split: 1500px+
|
|
38
|
-
|
|
39
|
-
## Skipping Frames
|
|
40
|
-
|
|
41
|
-
Skip a frame entirely when:
|
|
42
|
-
- Name contains "OLD", "archive", "deprecated", "참고", "예시" (reference only)
|
|
43
|
-
- Frame is a copy/duplicate of another already processed frame
|
|
44
|
-
- Frame is a component definition (Figma component, not an instance) — use its instances instead
|
|
45
|
-
|
|
46
|
-
## Viewport Frames
|
|
47
|
-
|
|
48
|
-
When multiple frames represent the same section at different widths:
|
|
49
|
-
- Smallest width = mobile (Phase 2 base URL)
|
|
50
|
-
- Larger widths = desktop breakpoints (Phase 2 subsequent URLs)
|
|
51
|
-
- Process mobile first, then add desktop as responsive layer — never the reverse
|
|
52
|
-
|
|
53
|
-
## Frame Count Warning
|
|
54
|
-
|
|
55
|
-
If total PAGE frames > 10, confirm with the user before proceeding. Large frame counts may indicate the Figma file covers multiple pages that should be separate feature implementations.
|
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: vibe.figma.pipeline
|
|
3
|
-
description: "[Merged] → vibe.figma.consolidate D-4 참조"
|
|
4
|
-
triggers: []
|
|
5
|
-
tier: standard
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# vibe.figma.pipeline
|
|
9
|
-
|
|
10
|
-
이 스킬은 **vibe.figma.consolidate** D-4 섹션으로 병합되었습니다.
|
|
11
|
-
Design Quality Pipeline 안내는 `vibe.figma.consolidate` Step D-4를 참조하세요.
|