3d-builder은(는) 무엇을 하나요?
3D 모델을 추측하지 마세요. 무엇을 만들지 기록하고, 사용자와 모호한 점을 명확히 하고, 모든 가정을 기록한 후에야 모델링하세요. 추측한 치수로 만든 모델은 계속 수정하게 됩니다. 명세는 추측이 지오메트리가 되기 전에 잡아냅니다.
워크플로우는 항상 이 순서로 진행됩니다: 명세 → 질문 → 평면도(건물만 해당) → 모델. 명세가 존재하고 질문이 끝나기 전에는 Blender나 FreeCAD를 열거나 모델링 코드를 작성하지 마세요. 건물의 경우 사용자가 먼저 평면도를 승인해야 합니다.
프로젝트 레이아웃
프로젝트는 여러 모델을 보유할 수 있으므로, 한 모델에 속한 모든 것은 자체 폴더에 저장됩니다:
models/
<name>/
specs/
<yyyy-mm-dd-hhmmss>-<request>.md # 요청당 하나의 명세
plans/ # 건물만 해당
layout.json
floor-<id>.svg
<name>.blend | <name>.FCStd # 모델
<name>.py # 스크립트 폴백만 해당
<name>.glb | <name>.fbx # 게임/웹 내보내기만 해당
.3d-builder.json # 기억된 도구 선택 (전체 프로젝트)
<name>은 객체의 짧은 케밥-케이스 이름입니다(phone-holder, router-wall-mount). 폴더와 모델 파일의 이름을 지정합니다. 아래의 모든 경로는 별도로 명시되지 않는 한 models/<name>/을 기준으로 합니다.
이전 프로젝트는 여전히 이전 평면 레이아웃(specs/ 및 plans/가 프로젝트 루트에 있고, models/<name>.blend)을 사용할 수 있습니다. 발견하면 그대로 작업하고, 한 번 파일을 이 구조로 이동할 것을 제안하세요. 묻지 않고 이동하지 마세요.
1단계: 명세 작성
- 모델의
<name>을 선택하세요. 새 모델의 경우models/<name>/이 아직 존재하지 않는지 확인한 후 생성하고specs/폴더도 생성하세요. - 시스템 시계에서 타임스탬프를 가져옵니다(예:
date +%Y-%m-%d-%H%M%S). 임의로 만들지 마세요. - references/spec-template.md의 템플릿을 사용하여
specs/<yyyy-mm-dd-hhmmss>-<request>.md를 생성하세요.<request>는 이 요청에 대한 짧은 케밥-케이스 레이블입니다. 새 모델의 경우initial, 편집의 경우 변경 사항(thicker-hook,move-kitchen-wall).
요청에 이미 명시된 내용을 채운 후, 열린 포인트를 나열하세요: 지오메트리에 영향을 주지만 명시되지 않은 모든 것. 일반적인 열린 포인트:
- 전체 치수 및 단위, 그리고 고정 치수 대 자유 치수
- 실제 객체에 대한 맞춤 및 간격(60mm 전화기에는 60mm보다 약간 더 넓은 슬롯이 필요함, 얼마나 더 넓어야 할까?)
- 벽 두께, 필렛/모따기, 구멍 크기, 나사 유형
- 장착 방법, 방향, 하중
- 목적 및 제조(3D 프린팅 → 오버행, 최소 벽 두께, 평평한 베이스; CNC; 렌더 전용; 게임/웹 에셋)
- 게임/웹 에셋의 경우: 대상 엔진, 폴리곤 예산, 엔진 단위의 스케일, 피벗 위치, UV 및 텍스처 대 단색, LOD, 충돌 메시
- 세부 수준, 재질(Blender), 파라메트릭 요구 사항(FreeCAD)
- 건물의 경우: 층, 평면도, 방과 크기, 계단, 문 및 창문. 이는 3단계에서 평면도와 함께 결정되므로 여기서 나열하지 말고 거기서 처리하세요.
기존 모델 편집: 먼저 models/에서 객체의 폴더를 찾으세요. 변경 사항에 대한 새 명세를 작성하고(각 요청은 자체 파일을 가지므로 기록이 읽기 쉽게 유지됨), 이전 명세에 링크하고, 무엇이 변경되고 무엇이 동일하게 유지되어야 하는지 명시하세요. 편집하기 전에 기존 모델을 읽고(MCP 또는 모델을 빌드한 스크립트를 통해) 실제로 있는 내용부터 편집을 시작하세요. plans/ 폴더가 있는 건물의 경우 레이아웃 변경은 먼저 평면도를 거쳐야 합니다(3단계, "건물 편집" 참조).
2단계: 명확화 질문
요청에 열린 포인트가 남아 있으면 모델링하기 전에 질문하세요. 사용자는 당신이 추론할 수 없는 것을 알고 있으며(실제 전화기 너비, 벽 나사 위치), 지금 하나의 질문이 나중에 재구축을 절약합니다.
규칙:
- 한 번에 하나의 질문. 답변을 기다린 후 다음 질문을 하세요. 지오메트리에 미치는 영향이 큰 순서대로 질문하세요: 전체 크기와 목적을 먼저, 미적 세부 사항은 마지막에.
- 가능하면 예/아니오. "케이블 슬롯이 중앙에 있어야 합니까?"가 "케이블 슬롯은 어디에 있어야 합니까?"보다 낫습니다.
- 그렇지 않으면 객관식: 권장 옵션을 먼저 표시하고 "(권장)"이라고 표시한 다음 대안, 마지막으로 자유 텍스트 답변을 표시하세요. 에이전트의 질문 도구(예: AskUserQuestion)가 있으면 사용하세요. 보통 자유 텍스트 옵션을 자동으로 추가합니다.
- 5개 배치. 5개 질문마다 최대 5개 더 계속할지 물어보고, 남은 열린 포인트 수를 대략적으로 알려주세요. 사용자가 아니오라고 하면 질문을 중단하세요.
- 이 모델에 중요하지 않은 것에 대해 묻지 말고, 사용자가 이미 말한 것을 묻지 마세요.
- 각 답변을 명세의 결정 섹션에 즉시 기록하여 명세가 항상 최신 상태를 유지하도록 하세요.
중요한 것이 불명확하지 않거나 사용자가 답변을 중단하면 중단하세요. 남아 있는 각 열린 포인트에 대해, 명시된 목적에 맞는 합리적인 기본값을 선택하여 스스로 결정하고, 한 줄 이유와 함께 가정에 기록하세요. 사용자는 명세를 읽고 자신을 대신하여 내려진 모든 선택을 볼 수 있어야 합니다.
요청이 이미 완전히 명시된 경우 질문을 건너뛰고 한 줄로 말하세요.
3단계: 평면도(건물만 해당)
모델이 건물이거나 방이 있는 경우 모델링하기 전에 종이에 레이아웃을 결정하세요. references/floorplans.md를 읽고 따르세요:
- 사용자와 평면도를 논의하고 위의 질문 규칙을 사용하세요: 층, 평면도, 방, 인접성, 계단, 문 및 창문.
- 각 층에 대한 벡터 평면도를 그립니다.
plans/layout.json을 작성하고 번들된 scripts/draw_plans.py로plans/floor-<id>.svg를 생성하세요. - 사용자와 평면도를 검토하고 사용자가 승인할 때까지 수정하세요. 승인을 결정에 기록하세요.
승인된 layout.json은 모델의 벽, 개구부, 방 및 계단에 대한 진실의 원천입니다. 건물이 아닌 경우 이 단계를 건너뛰세요.
4단계: 모델
결과를 모델 폴더의 <name>.blend(Blender) 또는 <name>.FCStd(FreeCAD)에 저장하세요. 게임 또는 웹 에셋의 경우 소스 파일 옆에도 내보냅니다(엔진용 내보내기 참조).
도구 선택
어떤 MCP 서버가 구성되었는지 확인하세요: 사용 가능한 도구에서 Blender 또는 FreeCAD MCP 도구(이름에 보통 blender 또는 freecad 포함)를 찾으세요.
- 기억된 선택: 프로젝트 루트에
.3d-builder.json이 있으면 사용자가 다른 것을 요청하지 않는 한"tool"("blender"또는"freecad")을 사용하세요. - 정확히 하나의 MCP 서버가 구성됨: 해당 도구를 사용하세요.
- 둘 다 또는 둘 다 구성되지 않음: 사용자에게 사용할 도구를 물어보세요(한 번의 객관식 질문). 정밀 치수가 필요한 기능 부품(브래킷, 인클로저, 인쇄되거나 가공되는 모든 것)에는 FreeCAD를 권장하고, 유기적 형태, 조각 또는 장식 객체, 렌더링용, 게임 또는 웹 에셋에는 Blender를 권장하세요(FreeCAD의 테셀레이션 메시는 실시간 사용에 적합하지 않음).
{"tool": "blender"}또는{"tool": "freecad"}를.3d-builder.json에 기록하여 선택을 기억하세요. 도구를 명세에도 기록하세요.
MCP를 통한 빌드(선호)
- 먼저 저렴한 호출을 한 번 하세요(예: 씬/문서 정보 가져오기). 오류가 발생하거나 10초 내에 응답하지 않으면 서버를 사용할 수 없는 것으로 간주하고 스크립트 폴백으로 전환하세요. 한 줄로 이유를 사용자에게 알리세요.
- 명세에서 단계별로 모델을 빌드하세요. 코드가 의도한 대로 작동했다고 믿지 말고, 진행하면서 치수를 확인하세요(경계 상자 또는 객체 속성 쿼리).
- 위의 경로에 저장하세요.
스크립트 폴백
사용 가능한 MCP 서버가 없으면 모델 폴더에 독립형 Python 스크립트 <name>.py를 작성하세요. 이 스크립트는 처음부터 모델을 빌드하고 <name>.blend 또는 <name>.FCStd를 자체 옆에 저장합니다. 주요 치수를 맨 위에 명명된 상수로 배치하여 사용자가 조정할 수 있게 하세요. 건물의 경우 스크립트는 plans/layout.json을 읽고 좌표를 코드에 복사하지 않습니다(references/floorplans.md, "레이아웃에서 모델 빌드" 참조).
그런 다음 도구가 설치되어 있으면 헤드리스로 실행해 보세요:
- Blender:
blender --background --python models/<name>/<name>.py - FreeCAD:
freecadcmd models/<name>/<name>.py(일부 시스템에서는FreeCADCmd또는freecad.cmd)
실행되면 출력을 확인하세요(파일 존재, 인쇄된 경계 상자가 명세와 일치). 실패하면 스크립트를 수정하고 다시 실행하세요. 도구가 PATH에 없으면 사용자에게 정확한 명령을 알려주세요.
도구별 함정 및 스크립트 스켈레톤: references/blender.md, references/freecad.md. 코드를 작성하기 전에 선택한 도구에 해당하는 것을 읽으세요.
엔진용 내보내기
게임 또는 웹 에셋에만 해당합니다. .blend를 편집 가능한 소스로 유지하고 그 옆에 내보냅니다:
| 대상 | 형식 | 파일 |
|---|---|---|
| 웹(three.js, Babylon.js), Godot, 일반 사용 | glTF 바이너리 | <name>.glb |
| Unity, Unreal | FBX (또는 사용자 파이프라인이 glTF를 가져오는 경우 .glb) | <name>.fbx |
엔진은 실시간이므로 에셋은 명세의 예산을 준수해야 합니다: 삼각형 수를 확인하고, 변환을 적용하고, 피벗을 명세가 지정한 위치에 두고, 엔진의 스케일 및 축과 일치시켜야 합니다. 내보내기 설정 및 함정: references/blender.md의 "게임 및 웹 에셋" 섹션을 참조하세요.
이 스킬은 에셋 파일을 제공합니다. 씬에 로드하거나, 엔진 스크립트를 작성하거나, three.js 페이지를 빌드하는 것은 범위를 벗어납니다. 사용자가 원한다면 이 워크플로우가 완료된 후 별도의 단계로 수행하세요.
완료
- 명세에 대해 모델을 검증하세요: 전체 치수, 나열된 모든 기능이 존재하는지, 맞춤 또는 간격 요구 사항. 게임/웹 에셋의 경우 예산 대비 삼각형 수와 엔진 단위로 내보낸 파일의 경계 상자도 확인하세요. 건물의 경우 승인된 평면도에 대해 확인하세요: 전체 치수, 벽 위치, 모든 문과 창문, 바닥 레벨.
- 명세를 업데이트하세요: 상태를
done으로 설정하고, 출력을 채우고(내보내기 및 평면도를 포함한 파일 경로, 도구, MCP 또는 스크립트), 계획과 다르게 나온 점을 메모하세요. - 사용자에게 간단히 보고하세요: 무엇이 빌드되었는지, 파일 위치, 재검토할 수 있는 주요 가정(나머지는 명세 참조).
이후 사용자가 변경을 요청하면 새 편집 요청으로 처리하세요(1단계, "기존 모델 편집"). 동일한 대화에서 작은 후속 작업("약간 더 두껍게")은 동일한 명세의 개정 아래에 넣을 수 있습니다.