PixelLab Pip은(는) 무엇을 하나요?
사용자의 에셋, API 또는 질문 의도를 먼저 분류한 후, 지원되는 PixelLab 표면을 선택합니다. 요청이 질문인 경우 직접 답변합니다.
워크플로우
- 요청 분류:
question | setup | create asset | edit/transform | animate | prompt_enhancement | integrate/code | check balance/status | troubleshoot docs/API | website/editor assistance명시적인 스킬 호출(/pixellab-pip setup또는@pixellab-pip setup) 뒤에 오는setup단어는 설정 의도로 처리합니다. 앱이 구조화된 인수를 제공하는 경우, 이를 자연어 의도를 읽는 또 다른 방법으로만 사용합니다. - 대상 에셋 또는 표면 분류:
general_image | background | character | object | effect_vfx | ui | whole_map | map_image | map_object | top_down_tileset | sidescroller_tileset | isometric_tile | tile_variants | animation | existing_image - 표면 선택:
관리형 코딩 에이전트 에셋에는 PixelLab MCP를, 직접 API/코드/배치 프리미티브에는 REST v2를, 웹사이트/Aseprite/Pixelorama는 휴먼/에디터 표면 전용으로, REST v1은 레거시 호환용으로만 사용합니다.
설정 의도의 경우
references/setup.md를 읽고 설정 마법사 계약을 실행합니다: MCP + API를 먼저 권장하고, MCP 전용/API 전용/수동 모드를 지원하며, 토큰 없는 미리보기 및 명시적 승인 후에만 설정을 변경합니다. - PixelLab MCP 도구를 사용할 수 있는 경우에만 MCP를 사용합니다(접두사 유무와 관계없이). MCP를 사용할 수 없는 경우, 문서화된 일치하는 REST v2 엔드포인트로 라우팅합니다. MCP와 REST v2를 모두 사용할 수 없거나 실패한 경우, 이유를 설명한 후에만 PixelLab 이외의 폴백을 사용합니다.
도구에
mcp__pixellab__create_character와 같은 접두사가 있는 경우 접미사로 일치시킵니다. - 필요한 도구/엔드포인트/필드가 없거나 불명확하거나, 인증, SDK 지원, 가격, 모델/모드 가용성 또는 최신 MCP 도구가 중요한 경우 현재 정보를 새로고침합니다.
- 일관성이 중요한 작업의 경우 사용자의 신원, 스타일, 팔레트, 뷰 및 참조 앵커를 요약합니다. 크레딧이 소모되는 호출 전에 최대 3개의 차단 질문을 합니다.
description,action,*_description,item_descriptions,text,color_palette와 같은 PixelLab 자연어 요청 매개변수의 경우, 사용자가 거부하지 않는 한 모호한 사용자 표현을 엔드포인트에 적합한 영어 매개변수 값으로 개선합니다. 문서화된 PixelLab enhance 엔드포인트는 선택한 경로에 적합한 경우에만 사용하고, 그렇지 않으면 요청 및 보이는 입력에서 직접 개선합니다. 비영어 또는 혼합 언어 요청의 경우references/localization.md를 읽습니다.- 라이브 생성 전에 사용자에게 채팅에 붙여넣도록 요청하지 않고 PixelLab Bearer 토큰이 구성되었는지 확인합니다.
- 실행하거나 답변합니다. 알려진 충돌에 대해서만 간단한 설명을 요청합니다.
표면 규칙
| 표면 | 사용 목적 | 주의 사항 |
|---|---|---|
| 호스티드 MCP | ID, 폴링, 다운로드, 목록/조회/삭제 헬퍼, 프로젝트/샌드박스/에이전트 헬퍼가 필요한 관리형 PixelLab 에셋이 있는 워크플로우 | MCP가 노출하지 않는 원시 이미지/편집/UI 프리미티브 또는 PixelLab MCP 도구를 사용할 수 없는 모든 MCP 호출 금지 |
| REST v2 | 스크립트, 배치 작업, 서버 통합, 정확한 엔드포인트 제어, 일반 이미지, 배경, UI, 인페인트/편집, 프롬프트 개선, 원시 애니메이션, 회전, 크기 조정, 배경 제거 및 API 패리티 검사 | 설치된 SDK 또는 현재 문서를 확인하지 않고 SDK 메서드 추측 금지 |
| 웹사이트 / 맵 워크숍 | 인간 제품 표면, 전체 맵 수동 작업, 풍부한 라이브러리, 가시적인 브라우저 지원 및 웹사이트 전용 흐름 | 복사된 브라우저 세션 토큰 또는 문서화되지 않은 루트 엔드포인트의 프로그래매틱 사용 금지 |
| Aseprite | 사용자가 Aseprite 내에서 적극적으로 작업할 때 로컬 인-에디터 플러그인 워크플로우 | 로컬 플러그인 경로를 공용 REST/MCP 계약으로 취급 금지 |
| Pixelorama / editor | 웹사이트 에디터 워크플로우(기존 에셋, 저장백 흐름 포함) 및 명시적 권한 후 웹사이트 전용 수동 흐름에 대한 가시적인 브라우저 지원 | 숨겨진 자동화, 문서화되지 않은 엔드포인트 호출, 공용 API 가정 또는 두 번째 확인 없는 생성/저장/다운로드/편집/삭제 작업 금지 |
| REST v1 | 기존 레거시 코드 및 이전 SDK 호환성 | 사용자가 명시적으로 v1을 요구하지 않는 한 새 작업 금지 |
호스티드 MCP 도구 이름은 REST 엔드포인트가 아닙니다. MCP 도구 이름을 /v2/... 경로로 curl하지 마십시오.
의도 라우터
| 사용자 의도 | 표면 규칙 후 기본 경로 | 코딩/정확한 제어가 필요할 때 REST v2 경로 |
|---|---|---|
| 캐릭터, 플레이어, NPC, 적, 크리처 | MCP create_character, 이후 create_character_state, animate_character, get_character, 목록/삭제 헬퍼 및 명시적 요청 시 delete_animation. 기존 다방향 캐릭터에 대한 후속 애니메이션의 경우 사용자가 방향을 지정하지 않으면 첫 번째 후보에 대해 기본적으로 남쪽/아래 방향을 사용하며, 모든 방향을 애니메이션화하기 전에 질문하거나 확인을 받습니다. | Character 엔드포인트: create-character-v3, create-character-with-4-directions, create-character-with-8-directions, create-character-pro, state, animation, tags, ZIP/list/get/delete 엔드포인트. |
| 객체, 소품, 아이템, 픽업, 무기, 가구 | MCP create_1_direction_object, create_8_direction_object, create_map_object, 객체 state/animation/review/tag 도구. | Object 엔드포인트: create-1-direction-object, create-8-direction-object, map-objects, 객체 state/animation/tags/list/get/delete 엔드포인트. |
| 탑다운 지형 타일셋, Wang/autotile/RPG 타일셋 | MCP create_topdown_tileset. | create-tileset, tilesets. |
| 사이드스크롤러/플랫포머 타일셋 | MCP create_sidescroller_tileset. | create-tileset-sidescroller, sidescroller 타일셋 엔드포인트. |
| 아이소메트릭 타일/블록/바닥 | MCP create_isometric_tile. | create-isometric-tile. |
| 타일 변형 / Tiles Pro | MCP create_tiles_pro (육각형, 팔각형, 사각형 탑다운, 아이소메트릭 타일 등 개별 타일 변형용). | create-tiles-pro, tiles-pro/{tile_id}. |
| 일반 이미지, 스프라이트, 아이콘형 독립 에셋 | REST v2. | create-image-pixen, generate-image-v2, create-image-pixflux, create-image-bitforge, generate-with-style-v2. |
| 배경, 장면, 환경, 배경화면 | REST v2 이미지 생성. 직접적인 호스티드 MCP 배경 도구는 문서화되지 않음. | 장면/배경 프롬프트와 함께 일반 이미지 생성 사용. create-image-pixflux-background가 현재 문서를 확인하지 않고 장면-배경 생성기라고 가정하지 마십시오. |
| UI, HUD, 버튼, 패널, 체력 바, 메뉴 | REST v2. | generate-ui-v2. 웹사이트 UI 라이브러리는 공용 수명주기 엔드포인트가 없는 한 휴먼/에디터 표면입니다. |
| 이미지 편집, 인페인트, 마스크, 변환, 크기 조정, 배경 제거 | REST v2. | inpaint, inpaint-v3, edit-image, edit-images-v2, image-to-pixelart, image-to-pixelart-pro, resize, remove-background. |
| 색상 감소 / 팔레트 양자화 | 웹사이트/에디터/로컬 이미지 도구. | 문서화된 공용 REST v2/MCP 색상 감소 엔드포인트는 없음. 경로를 발명하지 말고 웹사이트 문서 또는 로컬 도구를 사용하십시오. |
| 픽셀 아트 언줌 / 업스케일링 제거 | Aseprite 또는 Pixelorama 확장. | 웹사이트 문서는 에디터-확장 전용으로 나열합니다. 공식 문서가 엔드포인트를 추가하지 않는 한 REST/MCP로 라우팅하지 마십시오. |
| 캐릭터에 의류/아이템 착용 | 단일 이미지 실험적 출력용 웹사이트 Try on; 애니메이션 프레임 의류 전송 전용 REST transfer-outfit-v2. | Try on은 합성 이미지를 반환하며, 분리된 paperdoll 레이어를 반환하지 않습니다. |
| 다중 이미지 결합 참조 | 웹사이트 실험적 흐름 또는 문서 확인 후 가장 가까운 문서화된 REST image/edit 경로. | 문서화된 공용 REST v2/MCP "다중 이미지" 경로는 없음. |
| 캐릭터 비율 재조정 | 웹사이트 Reshape 또는 문서 확인 후 가장 가까운 문서화된 edit/character 경로. | 웹사이트 문서는 정확히 64x64 캔버스가 필요합니다. 문서화된 공용 REST v2/MCP reshape 엔드포인트는 없음. |
| 프롬프트 개선, 생성 프롬프트 향상 | 일치하지 않는 경로에 대한 에이전트 측 재작성 기본값; 문서화된 일치하는 enhance 엔드포인트에 대해서만 REST v2. | enhance-pixen-prompt, enhance-character-v3-prompt, 또는 enhance-animation-v3-prompt. 사용자가 명시적으로 요청하지 않는 한 불일치하는 enhance 엔드포인트를 일반 최적화 프로그램으로 사용하지 마십시오. |
| 원시 애니메이션, 골격, 보간, 의류 전송, 회전 | 관리형 MCP 캐릭터/객체를 애니메이션화하지 않는 한 REST v2. | animate-with-text*, animate-with-skeleton, estimate-skeleton, edit-animation-v2, interpolation-v2, transfer-outfit-v2, rotate, generate-8-rotations-v2/v3. |
| 맵 이미지, 생성된 레벨 이미지, 시각적 맵 개념 | REST v2 image/background 경로; 맵 확장/텍스처 워크플로우는 웹사이트. | 완전한 공용 REST/MCP 맵 CRUD, 맵 확장 또는 맵 텍스처 표면은 문서화되지 않음. |
| 맵 오브젝트 | MCP create_map_object + get_map_object 기본값. | POST /map-objects; MCP 맵 오브젝트는 8시간 후 자동 삭제됨. 코드를 작성하기 전에 OpenAPI에서 현재 REST 결과 및 폴링 동작을 확인하십시오. |
| 전체 맵, 맵 워크숍, 맵 CRUD/내보내기 | 웹사이트 수동 또는 MCP/REST로 구성 요소 생성. | 조사에서 완전한 공용 REST/MCP 맵 CRUD 표면은 문서화되지 않음. |
| 정적 효과 또는 VFX 스프라이트 | REST v2 image/edit 경로. 대상 스프라이트/이미지가 제공되고 사용자가 효과/트레일/오라/임팩트를 추가/그리기/오버레이/적용하도록 요청하는 경우, 제공된 이미지를 편집 대상으로 처리하고 REST 이미지 편집을 사용합니다. 사용자가 별도의 재사용 가능한 효과 에셋/레이어를 요청하거나 대상 이미지가 제공되지 않은 경우에만 객체/이미지 생성을 사용합니다. | 문서화된 독립형 공용 VFX 엔드포인트는 없음. PixelLab 편집 경로는 분리된 효과 레이어가 아닌 전체 편집된 이미지를 반환합니다. |
| 애니메이션 효과 또는 VFX | REST v2 원시 애니메이션 또는 관리형 객체가 되어야 하는 경우 MCP 객체 애니메이션. | animate-with-text-v3, animate-with-skeleton 또는 객체 애니메이션 엔드포인트; VFX를 별도의 엔드포인트가 아닌 설명으로 처리합니다. |
| 잔액, 크레딧, 계정 확인 | 가능한 경우 MCP get_balance. | GET /balance. |
| REST 비동기 작업 상태 | REST v2. | GET /background-jobs/{job_id}. MCP 관리형 에셋은 대신 리소스별 get_* 도구를 사용합니다. |
| PixelLab 프로젝트, 샌드박스, 배포된 에이전트 워크플로우, 채팅, MCP 도움말/피드백 | 가능한 경우 MCP list_projects, sandbox_*, chat_*, agent_help, agent_feedback, agent_list, agent_inspect, agent_talk 도구. | 문서화된 공용 REST v2 등가물 없음. |
충돌 시에만 명확화
- "타일": 사용자가 지형/autotile 타일셋, 플랫포머/사이드스크롤러 타일셋 또는 개별 타일 변형을 원하는지 질문합니다.
- "맵": 전체 맵, 맵 오브젝트, 맵 이미지, 타일셋, 아이소메트릭 타일 또는 타일 변형을 원하는지 질문합니다.
- "객체/캐릭터": 사람, NPC, 크리처, 바디 템플릿 또는 신원/상태 애니메이션에는 캐릭터로 추론하고, 소품/아이템/가구/무기에는 객체로 추론합니다. 불분명한 경우에만 질문합니다.
- "캐릭터 애니메이션 방향": 사용자가 기존 다방향 캐릭터에 애니메이션을 추가하도록 요청하고 방향을 지정하지 않은 경우, 하나의 미리보기 후보에 대해 기본적으로
south/아래를 사용합니다. 기본적으로 북서, 대각선 또는 모든 방향을 애니메이션화하지 마십시오.south를 사용할 수 없거나, 에셋의 방향을 알 수 없거나, 사용자가 다른 게임플레이 방향을 필요로 하는 경우에만 방향을 질문합니다. 사용자가 명시적으로 모든/8 방향, 완전한 방향 세트를 요청하거나 더 큰 배치를 승인하는 경우에만 모든 방향을 애니메이션화합니다. - "효과": 명확하지 않은 경우 정적 스프라이트 또는 애니메이션 효과를 질문합니다. 대상 스프라이트/이미지가 제공되고 사용자가 효과를 추가하도록 요청하는 경우 일회성 이미지 편집으로 추론합니다. 명확한 편집 대상이 없거나 사용자가 별도의 에셋을 요청하는 경우에만 재사용 가능한 객체/레이어와 일회성 스프라이트를 질문합니다.
- "아이소메트릭 타일셋": 공용 문서가 단일 아이소메트릭 타일 경로를 노출하므로, 하나의 아이소메트릭 타일이 필요한지 전체 타일셋이 필요한지 질문합니다.
- "Paperdoll": 베이스, 레이어, 방향, 애니메이션 및 격리된 vs 합성된 출력을 수집합니다.
references/paperdolling.md를 참조하십시오. - 제공된 이미지는 선택한 경로가 이미지 필드를 요구하는 경우에만 선택 사항입니다. 이미지가 제공되면 요청에서 각 파일의 엔드포인트별 역할을 추론합니다. 하나의 파일이 신원, 스타일, 개념, 편집 대상, 마스크, 팔레트, init/소스, 첫 번째 프레임 또는 마지막 프레임으로 합리적으로 해석될 수 있는 경우에만 질문합니다.
- 프롬프트 개선이 이미지 또는 사용자 약어에서 추론된 재료 세부 정보를 추가하는 경우, 크레딧이 소모되는 생성 또는 편집 전에 제안된 설명을 표시하고 확인을 받습니다.
관련 레퍼런스만 읽으십시오:
- Bearer-토큰 설정, PixelLab UI 명명 및 MCP 인증 재사용:
references/credentials.md. - 설치 후 MCP/API/인증을 위한 자연어 설정 모드:
references/setup.md. - 브라우저 폴백 및 웹사이트 자동화 경계:
references/browser-fallback.md. - Paperdolling 및 계층형 캐릭터 워크플로우:
references/paperdolling.md. - 타일셋 및 타일 변형 세부 정보:
references/tilesets.md. - 첨부 파일, 파일 경로, 제공된 이미지 역할, 엔드포인트 필드 또는 고정 크기 이미지-투-픽셀 아트:
references/image-inputs.md. - 비영어 또는 혼합 언어 사용자 요청 및 응답 언어 처리:
references/localization.md. - 공식 PixelLab 문서, MCP 문서, REST 문서 및 웹 새로고침 라우팅:
references/official-docs.md. - 사용량, 잔액, 작업 및 결과 보고:
references/usage-reporting.md. - 생성된 프레임에서 로컬 애니메이션 미리보기 GIF, 스프라이트시트 또는 ImageMagick/
magick어셈블리:references/local-asset-assembly.md.
선택적 광범위한 문서: 전체 플러그인/리포 설치에서 이러한 경로는 이 SKILL.md에 상대적으로 해석됩니다. 원시 스킬 설치는 이를 생략할 수 있습니다. 런타임 references/가 충분하지 않은 경우 존재하는 경우 최대 하나의 일치하는 파일을 읽습니다. 없으면 references/official-docs.md 및 현재 공식 PixelLab 문서로 계속 진행합니다. 세트를 검색하거나 로드하지 마십시오.
- 표면 경계 및 서비스 선택:
../../docs/pixellab/surfaces-and-services.md. - 일반 언어 에셋 라우팅:
../../docs/pixellab/asset-routing.md. - 제품/모델/모드 용어:
../../docs/pixellab/terminology.md.