시안 내부 이미지 아이템 분할 강화

[Hanjo92]

시안 제공 시 각 아이템 별 ui rect 지정을 통한 크기일치율 상향

[Hanjo92]

사전 점검 결과입니다. 아직 구현은 하지 않았습니다.

핵심 판단:

• #60에서 레이어/트리 구조 분해는 강화됐지만, #59의 핵심인 시안 내부 이미지/아이템별 UI rect 산출과 크기 일치 검증 계약은 아직 약합니다.
• 단순히 더 많이 쪼개는 방향은 위험합니다. 기존 single-image 유지 원칙을 보존하고, split하기로 결정한 runtime/repeated item에만 source rect -> normalized rect -> Unity RectTransform intent를 명시하게 하는 편이 안전합니다.

현재 이미 커버되는 것:

• mockup/image 기반 layer-to-Transform tree pass
• repeated card/slot/row의 reusable prefab/layout block 후보화
• decorative/baked/single-image region 과분할 방지
• mockup native resolution과 target resolution 분리

누락된 것:

• 분해된 각 item별 ui_rect 산출 강제 스키마
• raw mockup rect와 normalized rect를 Unity anchor/offset/size로 매핑하는 계약
• crop/asset 사용계획: existing sprite 재사용, mockup-derived crop, 9-slice 후보, keep-whole 사유
• 완료 전 item rect drift/size match 검증 체크

추천 설계 방향:

1. image-to-layout.md에 Item Rect Mapping pass 추가
   • item id/path, source rect x/y/w/h, normalized rect, parent-local rect, fit mode, anchor/pivot intent, split/keep reason, asset/crop plan
2. mockup-decomposition.md는 split/keep 판단과 item rect 산출을 연결
   • runtime leaf/repeated item으로 분해한 대상만 item rect contract 적용
   • decorative single-image는 rect만 기록하되 내부 sub-item으로 강제 분해하지 않음
3. review-checks.md와 layout-checklist.md에 item rect/size match 검증 추가
   • 주요 item이 source rect 비율과 Unity rect 의도를 유지했는지
   • crop/clip/overlap/text overflow가 없는지
4. prompt-patterns.md, 예제, 플랫폼 문서에 시안 기반 prefab 생성 시 item rect plan을 요구
5. tests/layer_tree_keywords.sh 또는 신규 테스트로 item-rect 계약 문구 회귀 방지

수용 기준 초안:

• 시안 기반 작업에서 분해된 주요 UI item 또는 repeated item unit마다 parent owner, role, split/keep reason, source ui_rect, normalized rect, Unity fit/anchor intent, asset/crop plan이 남는다.
• repeated item은 수동 복제가 아니라 하나의 reusable prefab/layout block 후보로 표현된다.
• decorative/single-image 영역은 runtime 이유 없이 내부 item으로 강제 분해하지 않는다.
• 완료 체크에 item rect drift/size mismatch 검증이 포함된다.

[Hanjo92]

PR 올렸습니다: #64

반영 내용:

• 2번 방향인 계약 기반 보강으로 진행했습니다.
• 시안 기반 작업에서 split runtime/repeated item마다 source rect, normalized rect, parent-local rect 또는 fit mode, split/keep reason, asset/crop plan을 기록하도록 스킬/레퍼런스/프롬프트를 보강했습니다.
• #60의 layer/tree 가드와 충돌하지 않도록 parent ownership과 split/keep reason이 item rect mapping보다 먼저 오도록 명시했습니다.
• item rect drift, size mismatch, mockup-derived crop, Unity fit intent 검증 항목을 추가했습니다.
• 회귀 테스트 tests/item_rect_keywords.sh를 추가했습니다.

분리:

• 3번 자동 이미지 아이템 분석/크롭 알고리즘은 피처 이슈 #63으로 등록했습니다: 시안 이미지 자동 아이템 분석 및 크롭 알고리즘 도입 #63

검증:

• bash -n tests/item_rect_keywords.sh && bash tests/item_rect_keywords.sh
• bash -n tests/layer_tree_keywords.sh && bash tests/layer_tree_keywords.sh
• bash -n tests/trigger_keywords.sh && bash tests/trigger_keywords.sh
• python /Users/song/.codex/skills/.system/skill-creator/scripts/quick_validate.py unity-mcp-ui-layout
• ruby -e 'require "yaml"; YAML.load_file("unity-mcp-ui-layout/agents/openai.yaml"); puts "ok"'
• git diff --check HEAD~1 HEAD