Claude Code와 Codex의 PCB Skill로 주문 가능한 PCB 제작하기

PCB Skill의 기능

PCB Skill은 하드웨어 아이디어를 초기 구상부터 주문, 납땜, 작동 확인이 가능한 PCB로 발전시키는 에이전트 스킬입니다. Claude Code 데스크톱 또는 Codex 데스크톱에서 실행되며, MCP 브리지를 통해 EasyEDA Pro를 제어하고, PCB 제조업체와 부품 공급업체에 이미 로그인되어 있는 브라우저를 사용합니다.

이 프로젝트는 일반적인 PCB 이론 강좌가 아닙니다. 대신 회전된 소켓, 모듈 본체 아래에 가려진 부품, 제대로 작동하지 않는 배치 금지 영역, 잘못된 기하학적 변환, 오래된 검증 입력, 조용히 실패하는 모니터링 스크립트와 같은 실무 결함을 발견하도록 설계된 단계별 엔지니어링 프로세스를 제공합니다.

에이전트는 장바구니를 준비하고 결제 직전 페이지까지 이동할 수 있지만, 주문을 확정하거나 결제하지는 않습니다. 최종 구매 작업은 항상 수동으로 진행합니다.

설계 원칙

워크플로는 세 가지 우선순위를 중심으로 구성됩니다.

• 비용 효율성: 각 부품의 가격은 실제 공급업체 페이지에서 확인하거나 명시적으로 견적값으로 표시해야 합니다. 이미 보유한 부품도 반영하도록 부품 명세를 조정합니다.
• 수작업 조립: 사용자가 직접 조립할 수 있도록 보드를 설계합니다. 보드 하단에 단자가 있는 패키지는 피하고, 패드에 접근할 수 있도록 하며, 납땜 접합부가 가려지지 않는 조립 순서를 고려합니다.
• 무료 프로토타이핑: 초기 스케치 단계부터 선택한 무료 프로토타입 조건 안에 보드를 유지하며, 마지막에 크기를 조정하거나 단순화하지 않습니다.

사전 요구 사항

스킬을 사용하기 전에 필요한 데스크톱 애플리케이션과 계정을 준비하세요.

• Claude Code 데스크톱 또는 Codex 데스크톱.
• 필수 MCP 브리지가 구성된 EasyEDA Pro.
• 에이전트 확장 프로그램이 설치된 호환 브라우저.
• PCB 제조업체 및 부품 공급업체의 활성 브라우저 세션.
• 선택 사항: 운영체제에서 모든 브라우저 작업마다 권한 프롬프트를 표시하는 경우 사용할 승인 감시기.

전체 환경 체크리스트는 저장소의 설정 가이드를 따르세요. 플랫폼별 승인 감시기 지침은 macOS 및 Windows에 제공됩니다.

승인 감시기의 기능은 의도적으로 제한되어 있습니다. 반복되는 권한 프롬프트를 줄일 수는 있지만, 장바구니나 결제 제어 기능과 상호작용하지는 않습니다.

PCB Skill 설치

1. 저장소 복제

git clone https://github.com/daishuge/pcb-skill.git

2. 에이전트에 설치

Claude Code의 경우 스킬을 Claude 스킬 디렉터리에 복사합니다.

cp -r pcb-skill/skills/pcb ~/.claude/skills/pcb

Codex의 경우 Codex 스킬 디렉터리를 사용합니다.

cp -r pcb-skill/skills/pcb ~/.codex/skills/pcb

3. EasyEDA Pro 및 MCP 구성

EasyEDA MCP 설정을 완료하세요. PCB Skill은 EasyEDA Pro를 제어하기 위해 이 브리지에 의존하므로, 보드 작업을 시작하기 전에 연결을 확인하세요.

4. 브라우저 세션 준비

필수 에이전트 확장 프로그램이 설치된 브라우저를 열고, 사용할 PCB 제조 서비스와 부품 공급업체에 로그인하세요. 에이전트는 자격 증명을 직접 처리하지 않고 이러한 기존 세션을 통해 구매 작업을 진행합니다. 자세한 내용은 브라우저 로그인 지침을 참조하세요.

PCB 프로젝트 시작

스킬과 통합 기능을 준비했으면 에이전트에 구체적인 하드웨어 아이디어를 전달하세요. 알고 있는 전기적, 기계적, 제조, 예산 및 재고 제약 조건을 포함하세요. 다음과 같이 요청할 수 있습니다.

내 디스플레이 모듈용 수작업 납땜 가능 컨트롤러 보드를 설계하세요.
가능하면 내 재고에 있는 부품을 사용하세요.
내 PCB 제조업체의 무료 프로토타입 조건 안에서 설계를 유지하세요.
답변에 따라 보드가 달라지는 요구 사항이 있으면 질문하세요.
부품 조달 및 제조 주문을 준비하되 결제 전에 중지하세요.

이는 특별한 명령어 문법이 아닙니다. 프로젝트 목표와 PCB Skill이 준수하도록 설계된 범위를 실용적으로 전달하는 방법입니다.

4단계 워크플로 따르기

1단계: 개념 정의

첫 번째 단계에서는 필수 제약 조건과 선호 사항을 구분합니다. 필수 제약 조건에는 커넥터 호환성, 인클로저 치수, 필요한 공급 전압 또는 제조 한도가 포함될 수 있습니다. 선호 사항에는 부품 브랜드, 커넥터 위치 또는 선택 기능이 포함될 수 있습니다.

에이전트가 답변에 따라 서로 다른 보드가 만들어지는 모든 질문을 빠짐없이 물어본 후에야 이 단계가 완료됩니다. 이 관문을 서두르지 마세요. 여기서 남은 불확실성은 나중에 비용이 큰 재작업으로 이어집니다.

2단계: 회로도 작성 및 부품 조달

에이전트는 회로도를 작성하고, 가격이 포함된 부품 명세를 만들며, 공급업체 장바구니를 준비합니다. 이 단계를 승인하기 전에 네트리스트 검증 조건을 통과해야 합니다.

조달 결과를 주의 깊게 검토하세요. 모든 가격은 실제 페이지에서 확인된 VERIFIED인지, 아니면 ESTIMATE인지 표시되어야 합니다. 또한 비용 계산에서는 모든 BOM 항목을 새로 구매한다고 처리하지 말고, 이미 보유한 재고 부품을 반영해야 합니다.

이 시점에는 전기적 값뿐 아니라 패키지 선택도 확인해야 합니다. 프로젝트의 조립 원칙은 접근하기 쉬운 패드를 가진 패키지를 선호하며, 의도한 수동 납땜 공정에 비현실적인 패키지는 배제합니다.

단계 3: 보드 배치, 배선 및 검토

레이아웃 단계에서는 부품이 배치되고 배선 및 구리 영역이 적용된 PCB가 완성됩니다. 배치는 EDA 도구에서 단순히 적법하다고 인정되는 것에 그치지 않고 배선 가능해야 합니다. 저장소에는 실제 패드에서 코트야드를 도출하고, 비아 레인을 식별하며, 모듈 본체 주변의 클리어런스를 확인하는 배치 유틸리티가 포함되어 있습니다.

이 단계에서는 설계 규칙 검사를 깨끗하게 통과하고 적대적 검토도 성공적으로 완료해야 합니다. 이 검토는 읽기 전용으로 수행되며, 기존 값이나 상태 표시기를 신뢰하지 않고 중요한 측정값을 다시 도출합니다.

단계 4: 제조 파일 검증 및 구매 준비

에이전트는 Gerber 패키지를 생성하고, 이를 생성한 EDA 소프트웨어와 독립적으로 검증합니다. 저장소의 검증 스크립트는 Gerber 구문 분석, 클리어런스 검사, 드릴 수, 네트리스트 어설션 및 3D 간섭 등의 영역을 다룹니다.

검증이 완료되면 에이전트는 제조 및 부품 구매를 준비하고 결제 전 페이지로 이동할 수 있습니다. 최종 가격, 수량, 배송 세부 정보, 제조 옵션 및 결제 컨트롤을 확인한 후 수동으로 주문을 제출하는 책임은 여전히 사용자에게 있습니다.

저장소 도구 이해하기

• skills/pcb/SKILL.md: 에이전트의 스킬과 핵심 동작을 정의합니다.
• skills/pcb/references/: 워크플로, 검토, 제조, 소싱, EDA-MCP 주의 사항, 기계 및 3D 검사, 초기 구동에 관한 필요 시 참고 자료를 포함합니다.
• scripts/placement/: 패드에서 도출한 코트야드, 배선 공간 및 모듈 본체 클리어런스와 관련된 배치 검사를 제공합니다.
• scripts/routing/: Specctra DSN 및 SES 자동 배선 체인, 4상태 워치독 및 속도 하한 모니터링을 포함합니다.
• scripts/verify/: EasyEDA와 독립적으로 Gerber, 클리어런스, 드릴, 네트리스트 및 간섭 검사를 포함한 검증을 수행합니다.
• scripts/notify/: 진행 상황을 전달하여 장시간 실행되는 작업이 무응답 상태로 남지 않도록 합니다.
• docs/case-study.md: 참조 보드에서 발견된 결함을 문서화하고 실제 비용을 보고합니다.

고급 신뢰성 팁

검토 전에 종료 조건 정의하기

녹색 보드 화면이나 깔끔해 보이는 레이아웃이 설계의 정확성을 증명하지는 않습니다. 각 단계는 한 번의 적대적 검토로 마무리해야 합니다. 검토가 시작되기 전에 종료 기준을 기록하세요. 그렇지 않으면 검토가 정의되지 않은 반복 작업으로 변할 수 있습니다.

의사 결정에 중요한 주장 측정하기

아마 지원되지 않을 것이다와 같은 진술이 작업 진행 여부를 결정해서는 안 됩니다. 단계를 차단하거나 승인하는 주장에는 근거를 요구하세요. 어떤 값이 직접 측정되었고 어떤 값이 해당 측정값으로부터 계산되었는지 기록합니다.

검증 도구 보정하기

검사기가 성공적으로 완료되었다는 이유만으로 올바르다고 가정하지 마세요. 알려진 비대칭 객체를 기준으로 기하학적 변환을 보정하세요. 대칭적인 테스트 객체는 회전, 반사 및 좌표계 오류를 감출 수 있습니다.

장시간 실행 작업을 관찰 가능하게 만들기

모든 대기 조건이나 로그 필터에 대해 그 순간 충돌이 발생하면 눈에 보이는 한 줄이 출력되는지 확인하세요. PCB Skill에는 워치독 및 알림 구성 요소가 포함되어 있습니다. 조용히 실행 중인 프로세스는 멈췄거나 실패한 프로세스와 구분하기 어렵기 때문입니다.

소스 설계뿐 아니라 최종 패키지 검사하기

업로드할 실제 Gerber 및 드릴 데이터에 대해 독립적인 검사를 실행하세요. 이를 통해 내보내기 문제, 오래된 파일, 검증 도구가 현재 보드가 아닌 이전 릴리스를 실수로 읽는 문제를 방지할 수 있습니다.

사례 연구를 검토 체크리스트로 활용하기

프로젝트 사례 연구에서는 이 워크플로를 만들게 된 실제 결함을 설명합니다. 첫 설계를 승인하기 전에 이를 검토하여 추상적인 게이트를 구체적인 고장 유형과 연결할 수 있도록 하세요.

결론

PCB Skill은 PCB 개발을 요구 사항, 회로도 작성, 소싱, 레이아웃, 배선, 제조 검증 및 구매 준비를 아우르는 명시적이고 테스트 가능한 게이트의 연속 과정으로 전환합니다. 핵심 가치는 단순한 자동 도면 작성이 아니라 도구와 단계 전반에 걸친 체계적인 검사에 있습니다. Claude Code 또는 Codex에 설치하고, EasyEDA MCP 및 브라우저 설정을 완료한 뒤, 모든 최종 구매에 대한 수동 통제권을 유지하세요.