菜单
핀메이트(PinMate) 추천 스케치(.ino)를 개발 단계에서 실물 아두이노 보드에 arduino-cli 로 컴파일→업로드→검증한다. 보드 자동 감지(FQBN·포트)·스케치 폴더 규칙·avrdude 성공 판정까지 한 호흡. 트리거 — "보드에 올려줘", "아두이노 업로드", "이 코드 올려줘", "flash 해줘", "스케치 업로드", 추천 코드를 실물에서 돌려볼 때. ★ 이건 개발용 CLI 업로드(arduino-cli)지, 앱 내 WebSerial 펌웨어 브리지(DEC-045)가 아니다.
用 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) 정본 문서 동기화. 코드·결정·계획이 바뀐 직후 호출하면 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", "보정 도구" 요청 시.
핀메이트 카탈로그에 새 부품(또는 보드/빵판 픽스처)을 누락 조인 없이 추가하는 스킬. "부품 추가", "부품 하나 넣어줘", "센서 추가", "카탈로그에 ~ 추가", "GLB 부품 등록", "팔레트에 부품 넣기" 같은 요청에 발동. DEC-030 "Add = one entry" 철학을 강제하되, 실제로는 parts(도메인)·render 전략(절차 빌더 또는 GLB)·assetCredits(라이선스)·CREDITS.md(정본)·CATEGORIES(분류)가 조인돼야 하므로 그 체크리스트와 무라이선스 금지 가드를 닫는다.
핀메이트(PinMate)용 에디토리얼-안전 이미지 자산을 gpt-image-2로 생성한다. 브랜드 마크/favicon, OG 공유이미지, empty/success 스팟 일러스트, 빵판·PCB 텍스처 등 미리 정의된 템플릿 + 커스텀 프롬프트 지원. 모든 프롬프트에 에디토리얼 아카데믹 제약(모노크롬·직각·타이포, 네온·캐릭터·마스코트 금지)이 자동 부착된다. 트리거 — "핀메이트 자산 생성", "OG 이미지 만들어", "favicon 생성", "브랜드 마크", "스팟 일러스트", "빵판 텍스처 생성", "이미지 자산 만들어줘". 기본은 드라이런(과금 0), 실제 생성은 --go 필요(~$1/장).
| name | pinmate-upload |
| description | 핀메이트(PinMate) 추천 스케치(.ino)를 개발 단계에서 실물 아두이노 보드에 arduino-cli 로 컴파일→업로드→검증한다. 보드 자동 감지(FQBN·포트)·스케치 폴더 규칙·avrdude 성공 판정까지 한 호흡. 트리거 — "보드에 올려줘", "아두이노 업로드", "이 코드 올려줘", "flash 해줘", "스케치 업로드", 추천 코드를 실물에서 돌려볼 때. ★ 이건 개발용 CLI 업로드(arduino-cli)지, 앱 내 WebSerial 펌웨어 브리지(DEC-045)가 아니다. |
codegen(buildSketch)이 뽑은 .ino나 손수정본을 실물 보드에서 돌려볼 때.
앱 사용자용 인-앱 업로드(브라우저)는 범위 밖 → 그건 DEC-045 펌웨어 브리지(Phase B).
arduino-cli 설치 + 보드 코어 설치 여부:
arduino-cli version
arduino-cli core list # UNO=arduino:avr 있어야 함. 없으면 core install arduino:avr
arduino-cli board list
Board Name·FQBN·포트를 읽는다(예: Arduino UNO / arduino:avr:uno / /dev/cu.usbmodem1101).
Board Name이 Unknown이면 무작정 FQBN을 찍지 말고 VID/PID로 정체부터 확인:
arduino-cli board list --format json | grep -iE '"vid"|"pid"|"address"'
vid 가 0x2341(정품 Arduino)·0x1A86(CH340 클론)·0x10C4/0x0403(USB-시리얼) 면 보드일 가능성.
0x04E8(삼성)·0x05AC(애플) 등은 폰·주변기기 → 절대 업로드 금지(usbmodem... 이름이 보드처럼 보여도 폰일 수 있음 — 실제로 갤럭시를 UNO로 착각해 쏠 뻔한 사례).usbmodem* 포트가 보이면 VID로 진짜 보드를 골라 그 포트로만 업로드./tmp 에:
# /tmp/<name>/<name>.ino 형태로 Write
arduino-cli compile --fqbn <FQBN> /tmp/<name>
arduino-cli upload -p <PORT> --fqbn <FQBN> /tmp/<name>
-v 로 재확인:
arduino-cli upload -p <PORT> --fqbn <FQBN> -v /tmp/<name> 2>&1 \
| grep -iE "bytes written|Avrdude done|error"; echo "exit=$?"
N bytes of flash written + Avrdude done. Thank you. + exit=0 이면 성공./tmp/<name>/ 에 — repo·src 에 .ino 만들지 않는다(칩 위 C++는 src/ 금지, firmware 외).board list 로 확정하고 하드코딩하지 않는다(포트 번호·시리얼은 재연결마다 바뀜).Unknown 보드엔 VID/PID 확인 전 업로드 금지 — 폰·버즈 같은 비-아두이노 USB 기기에 펌웨어를 쏘면 안 된다(VID 0x2341/0x1A86 등 아두이노 계열만). 동기 실패(not in sync)는 대개 "그 포트가 보드가 아님" 신호.arduino-cli monitor 는 비대화형 stdin EOF로 즉시 종료됨 → 시리얼 확인은 OS 직접 read
(stty -f <port> 9600 raw 후 디바이스 read) 또는 앱 /serial-test WebSerial 로(DEC-037 참고).src/features/circuit/codegen.ts buildSketch(model)firmware/pinmate-probe/arduino:avr:uno, avrdude exit 0, OS 레벨 시리얼 수신)/docsync 로 정본 갱신.