등각 투영 (라인 스타일)
짧은 브리프("갤러리 등각 투영", "빈 받은 편지함 상태")를 하나의 그려지고 애니메이션화된 객체로 변환하여 완전한 상태로 제공합니다: 일러스트레이션, 제목, 한 줄의 텍스트 및 버튼. 모든 객체는 3D 프리미티브를 세계 좌표(world units)로 구성하고 실제 등각 투영으로 투영되므로, 이 스킬로 만들어진 모든 객체와 하나의 그리드, 하나의 아웃라인, 하나의 스타일을 공유합니다.
한 줄로 요약된 스타일: 평평하면 정면, 박스형이면 실제 등각 투영 각도로 배치된 하나의 객체, 종이처럼 흰 면 위의 1px 아웃라인, 하나의 작은 브랜드 색상 마크, 그림자나 광택 없음, 한 번의 움직임과 그 후 정지.
단계를 건너뛰지 않습니다. 체커가 통과하고 시트를 확인할 때까지 객체가 완료되었다고 말하지 않습니다.
내용
| 파일 | 읽을 시점 |
|---|---|
SKILL.md | 항상: 워크플로우와 규칙 |
references/brief-to-concept.md | 1-2단계: 모호한 브리프를 세 가지 컨셉으로 전환 |
references/motion.md | 4단계: 움직임 선택 및 타이밍 |
references/line-style.md | 3-5단계: 모든 드로잉 규칙, 해야 할 일과 하지 말아야 할 일, 이유 포함 |
references/engine-api.md | 빌드 중: 엔진 및 라인 키트 |
references/isometric-math.md | 엔진이 제공하지 않는 수학이 필요한 형태 |
examples/*.tsx | 빌드 전: 가장 가까운 예제부터 시작 |
engine/iso-core.tsx, engine/iso-line.tsx | 사용자 프로젝트에 한 번 복사됨 |
scripts/check.mjs | 5단계: 엄격한 렌더링 검사 |
설정 (프로젝트당 한 번)
객체는 Tailwind CSS 및 shadcn/ui (@/lib/utils cn 및 @/components/ui/button 사용)와 motion 패키지를 사용하는 프로젝트를 위한 React 클라이언트 컴포넌트입니다.
-
components/isometrics/iso-core.tsx가 있는지 확인하세요. 없으면 이 스킬에서engine/iso-core.tsx및engine/iso-line.tsx를components/isometrics/(또는 사용자가 선호하는 폴더; 객체는 상대적으로 임포트하므로 모두 한 폴더에 있음)로 복사하세요. -
프로젝트에
motion이 없으면 설치하세요 (npm i motion또는 프로젝트의 패키지 매니저 사용). shadcn Button이 없으면:npx shadcn@latest add button. -
체커를 위해 Playwright:
npm i -D playwright및npx playwright install chromium(또는 설치된 Chrome 사용). -
하나의 객체만 렌더링하는 페이지,
PlayOnHover로 감싸기 (체커가 호버링하여 재생), 예: Next.js의app/isometrics-preview/<name>/page.tsx또는 프로젝트 자체 라우터의 경로:import { PlayOnHover } from "@/components/isometrics/iso-line"; import { MapPin } from "@/components/isometrics/map-pin"; export default function Page() { return ( <main className="flex min-h-svh items-center justify-center p-10"> <PlayOnHover><MapPin /></PlayOnHover> </main> ); }객체별로 생성하고, 사용자에게 삭제 가능한 미리보기 페이지라고 알리세요.
하나의 객체를 작동시키기 위해 엔진을 절대 편집하지 마세요. 형태가 정말로 없으면 객체 자체 파일 내부에 3D로 구축된 헬퍼를 추가하고 사용자에게 알리세요.
워크플로우
1단계 · 브리프 읽기
요청을 다른 무엇보다 먼저 세 가지 답변으로 전환하세요:
- 주제: 사물 또는 주제 ("갤러리" → 사진, 앨범, 이미지).
- 용도: 제공할 상태: 비어 있음 (아직 아무것도 없음), 차단됨 (접근 불가, 꺼짐, 연결 안 됨, 찾을 수 없음), 찾을 수 없음 (검색, 필터), 성공 / 모두 정상, 또는 기능 카드의 스팟 일러스트레이션.
- 메시지: 상태가 말하는 한 문장 ("아직 사진이 없습니다").
용도가 명시되지 않은 경우, 브리프는 일반적으로 두 가지 이상에 해당합니다. 이것이 컨셉이 필요한 이유입니다. references/brief-to-concept.md를 참조하세요.
2단계 · 세 가지 컨셉, 그 다음 대기
브리프가 이미 하나의 객체와 하나의 상태를 명명하지 않은 한, 사용자에게 세 가지 컨셉을 표로 보여주고 멈추고 선택을 기다리세요:
| 객체 | 메시지 (제목) | 한 번의 움직임 | |
|---|---|---|---|
| A ★ | … | … | … |
| B | … | … | … |
| C | … | … | … |
각 컨셉은 네 가지 테스트를 모두 통과해야 합니다:
- 120px에서 아웃라인으로 읽힘. 색상 없이도 사람들이 아는 실루엣.
- 둥근 것이 박스형보다 나음. 둥근 객체는 라인에서 더 친근하게 읽힘; 평범한 상자는 소포나 와이어프레임으로 읽힘.
- 하나의 객체. 장면이 아니고, 쌓인 더미가 아님. 두 번째 작은 부분은 객체에 속하는 경우에만 괜찮음 (뚜껑, 깃발, 손).
- 움직임이 메시지를 전달함. 움직임은 문장의 동사임 (
references/motion.md참조). 움직임 이름을 지을 수 없으면 잘못된 객체임.
★로 추천을 표시하고 한 줄로 이유를 말하세요. 세 가지를 다양하게: 다른 객체, 다른 움직임. 브리프가 구체적이면 ("트레이가 있는 빈 받은 편지함 상태"), 표를 건너뛰고 선택과 움직임을 명시하고 계속 진행하세요.
3단계 · 객체를 부품으로 분해
코드 작성 전에 세계 좌표로 부품 표를 작성하세요: 각 부품, 구성된 프리미티브 (Extrude, Slice, Ring, FacePath, Box…), 0.5 그리드에서의 크기와 위치, 움직이는지 여부, 그리고 브랜드 마크가 될 부품 하나. 그런 다음 텍스트: 제목 (≤ 28자), 한두 문장, 버튼 레이블 (≤ 22자) 및 아이콘 (아이콘은 동사를 따름: 더하기는 액션이 추가하는 경우에만).
부품을 결정하는 규칙 (모두 references/line-style.md에 있음):
- 먼저 뷰를 선택하세요. 평평하거나 얇은 것 (페이지, 배지, 디스크)은
view="front"; 박스형이거나 깊은 것 (프린터, 상자, 서버, 트레이, 책상 위에 놓인 막대기)은view="isometric". 정면 상자는 두 배의 선이 있는 평평한 스티커로 읽힘. - +y 방향을 향하고 x ≈ 0에 대해, z = 0에 서서 구축하세요.
- 세 가지 세부 수준: 형태, 사람들이 인식하는 부품, 그리고 조용한 마크 (나사, 통풍구, 이음새, 라벨).
- 깔끔한 선: 정면 솔리드는 깊이가 없거나 명확한 깊이 (≥ ~4px 스트립)가 있음; 부품은 면과 같거나 ≥ 0.5만큼 돌출됨; 원형 스택은 하나의 반지름과 하나의 이음새 선을 공유함.
- 평평한 것 (종이, 라벨, 화면)은 면일 뿐, 솔리드가 아님.
- 둥근 솔리드는 수평 원 사이의 슬라이스이며, 아래에서 위로 칠해짐.
- 볼록하지 않은 아웃라인은 먼 가장자리를 그려야 함.
- 하우징에서 밀려나오는 부품은 하우징에서 잘리며, 떠 있지 않음.
- 하나의 브랜드 마크 (팔레트
main); 나머지는 모두 종이 (surface).
4단계 · 움직임 선택 및 작성
메시지에서 동작을 선택하고 (references/motion.md), 드로잉 코드 전에 파일 상단에 스토리보드 주석을 작성하세요: 시간, 움직이는 것, 거리, 이유. 모든 값은 명명된 상수로. 움직임은 아트가 화면에 스크롤된 후 400ms를 기다리고, 1.2–2.4초 동안 지속되며, 한 번 재생됩니다. 사용자 코드가 active를 전달하면, active가 true가 될 때마다 대신 재생됩니다 (80ms 지연), 자체적으로는 절대 재생되지 않음. 축소된 움직임은 정지 포즈를 보여줍니다.
5단계 · 빌드, 렌더링, 검사, 확인, 수정
-
examples/에서 가장 가까운 예제부터 시작하세요 (아래 표). 구조 유지: 스토리보드, TIMING, 지오메트리, 트랙, 포즈, 조각,LineState. -
미리보기 페이지에서 렌더링하고 체커 실행:
node <skill>/scripts/check.mjs http://localhost:3000/<preview-path>/<name> --duration <wait+beat ms>라이트와 다크를 렌더링하고, 가짜 시계로 아트에 호버링하여 움직임을 재생 (미리보기 페이지가 객체를
<PlayOnHover>로 감싸야 함), 0, 25, 50, 75, 100 % 및 이후 프레임 저장 후 확인:- 라이트, 다크 및 축소된 움직임에서 하이드레이션 또는 콘솔 오류 없음;
- 활성화 시 재생되고 아트 내부에 버튼이 없음;
- 움직임이 정확히 정지 포즈로 돌아옴;
- 축소된 움직임은 정지 상태, 정지 포즈 표시,
active무시; - 모든 아웃라인이 약 1px; 필터, 광택, 그림자 또는 그라데이션 페인트 없음;
- 정지 드로잉이 프레임에 맞음;
- 드로잉이 제목과 2px 이내로 중앙 정렬됨;
- 깔끔한 선: 아웃라인의 최대 6%가 지속적인 이중선 (실제 길이를 따라 0.5–2px 떨어진 두 선; 선이 만나는 작은 점은 계산 안 함), 다크에서 4배 (
lines.png, 빨간색 이중선lines-marked.png); - 광학 크기가 세트와 일치 (√(w×h) 140–175 px).
-
sheet.png및lines.png보기 (둘 다 열기) 및 아래 체크리스트 검토. 체커는 디자인을 볼 수 없음; 당신이 볼 수 있음. -
수정하고 다시 실행. 최대 세 번. 세 번 후에도 여전히 부족하면 중단하고 시트와 함께 정확히 무엇이 부족한지 사용자에게 알리세요.
-
보고: 컨셉, 스토리보드, 체커 결과, 확인 후 수정한 사항, 여전히 부족한 사항, 시트 경로.
시트 확인: 체크리스트
읽힘
- 제목 없이도 낯선 사람이 썸네일 크기에서 객체 이름을 지을 수 있는가?
- 우연히 얼굴로 읽히는 것이 없는가 (곡선 위의 둥근 부품 두 개 등).
- 브랜드 마크는 하나의 작은 부품이며, 눈이 가장 먼저 가야 할 부품인가?
똑바로 정지
- 정지 시 모든 직립부는 수직이고 모든 가장자리는 수평이며; 기울어지거나 비뚤어진 것이 없고, 두 번째 시트는 회전되지 않고 오프셋됨.
- 정지 포즈가 축소된 움직임 포즈와 동일함 (체커는 픽셀을 비교; 당신은 의도적으로 보이는지 확인).
선 (lines.png 확인: 다크, 4배)
- 모든 곳에서 하나의 아웃라인 두께; 이중 가장자리 없음, 채우기 사이의 실선 이음새 없음, 곡선 아웃라인의 먼 가장자리 누락 없음, 채우기가 아웃라인 밖으로 나오지 않음, 공중에서 끝나는 선 없음.
- 모든 부품은 면과 같거나 명확히 돌출됨 (≥ 0.5); 얇은 스트립 없음.
현실감
- 올바른 뷰: 평평한 것은 정면, 박스형 것은 등각.
- 세 가지 수준: 형태, 인식 가능한 부품, 조용한 마크. 실제로 가지고 있는 사람이 "네, 그건 프린터예요"라고 말할까?
- 상단 스트립 (30° 위에서 보이는 두께)이 솔리드에는 있고 얇은 면에는 없음.
움직임
- 움직임이 메시지를 전달함; 각 움직임은 이전 움직임에 의해 발생 (지연, 후속 동작, 안정).
- 힌지 부품이 하우징을 통해 흔들리지 않음; 끝이 정지를 넘지 않음; 스윙이 작게 유지됨 (매달린 부품 ≤ 6°, 플랩 ≤ 25°).
- 페이드 인/아웃 없음; 나타나는 것은 크기로 성장.
페이지에 맞음
- 텍스트에 중앙 정렬됨; 프레임이 데드 스페이스로 패딩되지 않음.
- 다크에서 올바르게 보임: 종이 면은 어두운 종이가 되고, 브랜드 마크는 브랜드로 유지됨.
다시는 하지 않음: 이 스킬이 저지른 실수
각각은 한 번 출시되었고, 리뷰에서 발견되었으며, 이제 규칙이 되었습니다. 객체를 보고하기 전에 모든 라인과 대조하여 확인하세요.
| 실수 | 현재 규칙 |
|---|---|
| 정면으로 그려진 상자가 평평한 스티커처럼 보임 | 먼저 뷰 선택: 평평한 것은 정면, 박스형은 view="isometric" (line-style.md) |
| 얇은 상단 스트립, 거의 돌출되지 않은 부품 및 계단식 링이 이중 더러운 선을 그림 | 얇은 스트립 없음; 면과 같거나 ≥ 0.5 돌출; 둥근 스택은 하나의 반지름; 체커의 깔끔한 선 테스트 통과 필수, lines.png 확인 (다크, 4배) |
| 객체가 단지 아웃라인일 뿐 ("현실적이지 않음") | 세 가지 세부 수준: 형태, 인식 가능한 부품, 조용한 마크 |
| 세트 내 객체 간 크기 차이 | defaultArtClassName을 통한 광학 크기 140–175 px |
| 페이지가 프레임 밖으로 3 단위 날아감 | 움직임은 아트의 공기 내에 유지; 기껏해야 프레임 가장자리를 약간 벗어남 |
| 두 개의 래치, 전체 너비 스트라이프를 "하나의 브랜드 마크"로 사용 | 진짜 하나의 작은 마크 |
| 점 위의 슬롯, 이음새 위의 두 래치가 얼굴로 읽힘 | 썸네일 크기에서 우연한 얼굴 확인 |
| 시청자를 향한 모서리 플립이 정면에서 보이지 않음 | 시청자를 향한 움직임은 각도의 일부만 읽힘; 그림 평면에서의 움직임 선호 또는 크게 움직임 (motion.md) |
| 페이지가 평면에서 기울어져 등각 각도로 전단됨 | 등각 뷰에서 부품 자체 법선 또는 가장자리의 힌지에 대해서만 회전 (motion.md) |
| 부품이 첫 번째 재생에서 시작 포즈를 한 프레임 플래시 | 시계 상태에 의해 구동되는 부품은 클립이 변경될 때 재설정되고 유지될 때 정지에서 시작 (engine-api.md) |
| 얇은 트레이 벽이 얇은 플라스틱으로 읽힘 | 튼튼한 벽은 두께를 가짐 (≥ 0.5); 얇은 면은 종이용 |
| 각 객체는 단독으로는 괜찮았지만 세트는 일관되지 않음 | 보고 전에 전체 배치를 나란히, 라이트 및 다크로 검토 |
| 종 몸체, 족쇄, 바늘 손이 곡선을 따라 이중 아웃라인을 그림 | 정면에서 곡선 부품은 평평한 면 (또는 명확히 깊은 면); 손에는 평행한 변을 주고 테이퍼 절대 금지 |
| 유리 아웃라인에 그려진 모래가 하나의 두꺼운 얼룩을 만듦 | 내용물은 내부 벽 안쪽에 위치하며 컨테이너 아웃라인 위에 절대 놓지 않음 |
| 상자에서 0.25 돌출된 문이 아치를 두 배로 만듦 | 열림 모양의 문은 정지 시 하나의 아웃라인 공유 |
| 등각에서 32°의 금고 문이 가장자리로 보임 | 등각 문과 뚜껑은 약 24–26° 열려서 면이 여전히 읽힘 |
| 열쇠 고리가 구멍을 통과하는 대신 열쇠 위에 놓임 ("고리가 열쇠 고리 안에 있지 않음") | 나사산 부품은 서로 엮임: 고리는 각 부품의 구멍 한쪽 뒤, 다른 쪽 앞을 통과 (line-style.md) |
| 객체를 크기에 맞게 축소하면 이중선이 다시 나타남 | 먼저 기본 너비를 설정한 다음 작게 그려진 객체에 대해 스트립 ≥ 0.5로 만듦 |
| "!!!" 배지가 선 검사 실패 | 명확한 간격이 있는 형태로 마크를 그림; 텍스트에서 간격 글리프 사용 금지 |
양보 불가 규칙
- 진짜 등각만. 축은 수평에서 30°, 120° 간격, 동일한 축척. 절대 2:1 "게임" 투영 (26.565°) 사용 금지.
- 지오메트리 우선. 프리미티브를 세계 좌표로 배치. 투영된 화면 경로를 수동으로 작성하지 마세요.
- 하나의 그리드. 위치 및 크기는 0.5 세계 단위; 면 세부 사항은 0.25.
- 하나의 스타일.
variant="ink"(기본값) 또는"line"; 하나의 객체에서 스타일을 혼합하지 마세요. 1px 아웃라인, 종이 벽, 그림자 없음, 광택 없음, 그라데이션 없음. - 토큰의 테마. 색상은
--iso-*변수를 통한 사용자의 shadcn 테마에서만 옴. 객체 파일에 16진수 또는 oklch 사용 금지. 브랜드 마크는tone(기본값primary)을 따름. - 소품, 포크 금지. 텍스트, 톤, 변형, 선 두께, 움직임 스위치는 문서 주석이 있는 소품 (
LineStateProps). 콘텐츠 소품을title로 명명하지 마세요: 접근 가능한 이름입니다. - 접근 가능하고 삽입 가능. 아트는
title이 제공되지 않으면 장식적입니다.