菜单
핀메이트 카탈로그에 새 부품(또는 보드/빵판 픽스처)을 누락 조인 없이 추가하는 스킬. "부품 추가", "부품 하나 넣어줘", "센서 추가", "카탈로그에 ~ 추가", "GLB 부품 등록", "팔레트에 부품 넣기" 같은 요청에 발동. DEC-030 "Add = one entry" 철학을 강제하되, 실제로는 parts(도메인)·render 전략(절차 빌더 또는 GLB)·assetCredits(라이선스)·CREDITS.md(정본)·CATEGORIES(분류)가 조인돼야 하므로 그 체크리스트와 무라이선스 금지 가드를 닫는다.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
핀메이트(PinMate) 카카오 MCP 서버의 빌드·로컬 검증·컨테이너·대회 등록을 한 절차로 몬다. server/mcp.ts(Streamable HTTP·stateless·도구 5종)를 건드린 뒤 호출하면 `pnpm mcp:smoke`로 14항목(도구·체인·딥링크·SLA·동시성)을 실호출 검증하고, Docker(amd64)·카카오 PlayMCP 등록 체크리스트까지 안내한다. 트리거 — "MCP 테스트", "MCP 배포", "대회 신청/등록", "스모크", server/ 수정 후, "/pinmate-mcp".
핀메이트(PinMate) 추천 스케치(.ino)를 개발 단계에서 실물 아두이노 보드에 arduino-cli 로 컴파일→업로드→검증한다. 보드 자동 감지(FQBN·포트)·스케치 폴더 규칙·avrdude 성공 판정까지 한 호흡. 트리거 — "보드에 올려줘", "아두이노 업로드", "이 코드 올려줘", "flash 해줘", "스케치 업로드", 추천 코드를 실물에서 돌려볼 때. ★ 이건 개발용 CLI 업로드(arduino-cli)지, 앱 내 WebSerial 펌웨어 브리지(DEC-045)가 아니다.
핀메이트(PinMate) 정본 문서 동기화. 코드·결정·계획이 바뀐 직후 호출하면 PROJECT-STATUS·WORK-BOARD·DECISION-LOG 등 정본을 일관되게 갱신하고 같은 사실이 여러 곳에 어긋나게 적힌 드리프트를 점검한다. "정본 1곳 원칙"을 강제한다. 트리거 — 변경 작업을 끝낸 뒤, "문서 갱신", "드리프트 점검", "상태 업데이트", "/docsync" 요청 시.
핀메이트(PinMate) free 부품(서보 등 보드밖 GLB)의 리드선(피그테일)을 본체에 정확히 붙이고 보정한다. GLB 변환(seatModel 오프셋 포함)을 리드가 1:1로 복제해야 회전·이동·빵판 pose 에 무관하게 커넥터에 붙는다 — 이 계약을 어기면 "배치 땐 붙는데 회전하면 어긋남" 버그가 난다. 트리거 — 서보 같은 free 부품 리드가 본체에서 떨어지거나/엉뚱한 데 붙을 때, free 부품 추가·리드 보정·회전 정합, "선이 안 붙어", "회전하면 위치 변함", "리드 보정" 요청 시.
핀메이트(PinMate) GLB 모델의 핀/단자 좌표를 재사용 가능하게 보정한다. GLB는 고정이라 코드로 핀 구멍 좌표를 알 수 없으므로 /calibrate 드래그드랍 도구로 한 번 찍어 calibration-data 에 저장하고 배선·net 에 쓴다. 트리거 — 새 GLB 부품(보드/ 센서/서보 등)을 빵판과 배선해야 할 때, "모델 보정", "핀 좌표 찍기", "새 모델 배선", "calibrate", "보정 도구" 요청 시.
핀메이트(PinMate)용 에디토리얼-안전 이미지 자산을 gpt-image-2로 생성한다. 브랜드 마크/favicon, OG 공유이미지, empty/success 스팟 일러스트, 빵판·PCB 텍스처 등 미리 정의된 템플릿 + 커스텀 프롬프트 지원. 모든 프롬프트에 에디토리얼 아카데믹 제약(모노크롬·직각·타이포, 네온·캐릭터·마스코트 금지)이 자동 부착된다. 트리거 — "핀메이트 자산 생성", "OG 이미지 만들어", "favicon 생성", "브랜드 마크", "스팟 일러스트", "빵판 텍스처 생성", "이미지 자산 만들어줘". 기본은 드라이런(과금 0), 실제 생성은 --go 필요(~$1/장).
| name | pinmate-add-part |
| description | 핀메이트 카탈로그에 새 부품(또는 보드/빵판 픽스처)을 누락 조인 없이 추가하는 스킬. "부품 추가", "부품 하나 넣어줘", "센서 추가", "카탈로그에 ~ 추가", "GLB 부품 등록", "팔레트에 부품 넣기" 같은 요청에 발동. DEC-030 "Add = one entry" 철학을 강제하되, 실제로는 parts(도메인)·render 전략(절차 빌더 또는 GLB)·assetCredits(라이선스)·CREDITS.md(정본)·CATEGORIES(분류)가 조인돼야 하므로 그 체크리스트와 무라이선스 금지 가드를 닫는다. |
| user_invocable | true |
| tags | ["pinmate","catalog","part","glb","license-guard","ssot","extensibility"] |
| trigger | 새 부품/센서/액추에이터/보드/빵판을 카탈로그에 추가할 때 / GLB 모델을 씬에 등록할 때 |
| version | 1 |
새 부품을 한 흐름으로 추가한다. DEC-030 SSOT 철학은 "한 항목 추가"지만, 누락 시 조용히 깨지는 조인이 여럿이라(라이선스 누락=법적 리스크, 빌더/스펙 누락=렌더 실패) 이 스킬이 전부를 강제한다.
| 무엇 | 파일 | 비고 |
|---|---|---|
| 부품 정의 | src/features/circuit/parts.ts PARTS | 여기 한 항목 → PART_LIST→CATALOG 자동 파생 |
| 픽스처(보드/빵판) | src/features/circuit/catalog.ts FIXTURES | 부품 아닌 작업대 종류 |
| 카테고리 | src/features/circuit/catalog.ts CATEGORIES | 없는 카테고리면 여기 먼저 추가. 빈 카테고리는 팔레트가 자동 숨김 |
| 상태 타입 | src/features/circuit/types.ts ComponentStatus | ready(배치가능)·active(현재적용)·staged(보유·미배포)·glb-pending |
| 렌더 전략 | types.ts RenderStrategy | {kind:"procedural", builder} | {kind:"glb", assetId} |
| 절차 빌더 | src/features/breadboard-3d/three/parts.ts BUILDERS | render.builder 문자열 = 이 맵의 키여야 함 |
| GLB 변환 스펙 | src/features/breadboard-3d/three/glbParts.ts GLB_PART_SPECS | assetId별 scaleLen/yLift/rotationY. 없으면 DEFAULT_SPEC |
| 라이선스 레지스트리 | src/lib/assetCredits.ts ASSET_CREDITS | GLB의 assetId·경로·라이선스·rendered |
| 라이선스 정본 문서 | docs/ref/CREDITS.md | ASSET_CREDITS와 항상 일치 |
| 보드 핀 좌표(조건부) | src/features/circuit/calibration-data.ts CALIBRATIONS | 보드/헤더 핀의 월드좌표 보정용. 일반 빵판 부품은 홀 스냅이라 보통 불필요 |
CATEGORIES)에 속하나, 없으면 카테고리부터.assets/3d/_harvest/_QUARANTINE-no-license/(무라이선스 37종)이면 중단. 저작권은 대회 규정과 무관한 법적 의무.parts.ts에 entry: id·label·category·status·render·pins(role+label)·span·conducts + 전기 메타(operatingV·protocol·needsResistor·polarity·needsPullup 등 해당 시). 진단 규칙(DEC-016)이 이 메타를 읽으므로 정확히.render.builder 문자열이 BUILDERS에 있나? 없으면 빌더 함수 추가.ASSET_CREDITS에 항목(경로·author·license·rendered:true) ② CREDITS.md 표에 같은 행 ③ GLB_PART_SPECS에 스케일/오프셋(없으면 DEFAULT로 뜨나 크기 안 맞을 수 있음 → DEC-031 조작기 또는 코드 튜닝).staged("준비 중" 칩, 팔레트 비활성). 배치 가능이면 ready.pnpm typecheck && pnpm lint && pnpm test && pnpm build. 그 뒤 pnpm dev→/build 하드 새로고침: 팔레트에 카드+썸네일 뜨나 · 드래그 고스트 · 홀에 배치 · (GLB) 모델 실제 렌더·스케일·방향.ASSET_CREDITS/CREDITS.md에 없는 GLB를 씬에 올리지 않는다.render.kind:glb의 assetId는 ASSET_CREDITS 엔트리 **+ 디스크 실파일(경로 글자까지 일치, 예 .opt.glb)**로 해소돼야 한다. 미해소 시 에러 없이 조용히 "3D" 썸네일 폴백 + 씬 프록시 박스라 놓치기 쉽다. 자산이 없으면 glb로 두지 말고 절차 메시(DEC-002)로 전환.three/thumbnails.ts)는 CATALOG(부품+픽스처) 순회. 핀 없는 픽스처(보드·빵판) 절차 빌더는 BUILDERS가 아니라 thumbnails.ts FIXTURE_MESH에 등록해야 카드에 미리보기가 뜬다.PARTS/CATALOG에서 파생. 새 부품 = 레지스트리 항목 추가일 뿐.span은 홀 간격 단위. 스냅 로직(round(v/2.54)*2.54)은 건드리지 않는다.ASSET_CREDITS와 CREDITS.md는 항상 일치. 결정이 생기면 DECISION-LOG, 상태는 PROJECT-STATUS.PARTS(또는 FIXTURES)에 항목 1개 추가, CATALOG 자동 반영ASSET_CREDITS+CREDITS.md+GLB_PART_SPECS 3곳 조인ASSET_CREDITS 엔트리 + 디스크 실파일로 해소(경로 글자 일치). 죽은 assetId면 "3D" 폴백으로 조용히 깨짐GLB_PART_SPECS 튜닝(코드) 또는 DEC-031 인앱 조작기 구현 대기.RenderStrategy union 확장은 설계 변경 → DECISION-LOG에 결정 먼저.