wzyn20051216/solidworks-automation-skill

SolidWorks 자동화 스킬 – AI 기반 CAD 자동화

개요

• 대규모 언어 모델 에이전트(예: Codex, Claude, Cursor)가 자연어 명령을 통해 데스크톱 버전의 SolidWorks(및 기타 일부 CAD 패키지)를 제어할 수 있게 하는 툴킷입니다.
• 세 가지 교체 가능한 진입점으로 제공됩니다:
  1. Skill – 에이전트가 가져올 수 있는 소형 플러그인.
  2. MCP – Smithery MCP 프레임워크용 명령줄 클라이언트.
  3. CAD Studio – 프로젝트 관리, 결과 미리보기, 산출물 전달을 위한 Windows 데스크톱 앱.
• 세 가지 모두 동일한 기능 카탈로그(capabilities.yaml)와 동일한 실행 코어를 공유하므로, 하나만 설치하면 됩니다.

작동 방식

1. 사용자가 자연어 요청을 작성합니다(예: "M6×1 나사 구멍 생성").
2. LLM 에이전트가 구조화된 도구 호출을 통해 Skill/MCP를 호출합니다.
3. 실행 코어가 요청을 SolidWorks COM 또는 OCCT 작업 시퀀스로 변환하고, 실행하고, 추적을 기록합니다.
4. CAD 소프트웨어가 완료된 후, 코어는 결과를 검증하고(예: 생성된 지오메트리 읽기, 치수 확인) 증거(파일 + 검증 로그)를 생성합니다.
5. 검증이 실패하면 결정적 복구 결정이 이루어지며, 작업을 재시도하거나 CAPABILITY_GAP 응답과 함께 에이전트에 반환할 수 있습니다.

주요 기능

• 검증 우선: 도구 호출의 성공이 작업 성공을 의미하지 않습니다. 모든 출력은 수락되기 전에 검증됩니다.
• 결정적 신뢰성 시나리오: 37개의 내장 케이스가 정상 실행, 오류 주입, 백엔드 폴백, 기능 격차를 테스트합니다. 현재 기준선은 잘못된 완료 0건을 보고합니다.
• 광범위한 CAD 지원:
  • SolidWorks 네이티브 형식 전체 지원(SLDPRT, SLDDRW, SLDASM).
  • OCCT를 통한 개방형 형식 내보내기(STEP, STL, IGES, BREP, OBJ, GLB, DXF, SVG, PDF, PNG).
• 기능 매트릭스: 각 기능은 capabilities.yaml에서 verified, stable, pilot, 또는 blocked로 표시되어 에이전트가 안정적으로 사용 가능한 것을 알 수 있습니다.
• 하위 스킬: 특정 작업(나사 구멍, CNC 필렛/모따기, 기어 생성 등)을 위한 모듈식 워크플로우로, 루트 스킬이 자동으로 호출할 수 있습니다.
• 추가 런타임 서비스 불필요: 실행 코어는 SolidWorks와 통신하는 동일한 프로세스 내에서 실행됩니다. 별도 서버를 시작할 필요가 없습니다.

시작하기

진입점	대상 사용자	GUI 필요?	일반적인 용도
Skill	스킬 가져오기를 지원하는 에이전트	아니요	순수 자연어로 SolidWorks 구동
MCP	Smithery MCP 클라이언트(Codex, Claude, Cursor, Windsurf) 사용자	아니요	LLM에서 자동 도구 호출
CAD Studio	시각적 프로젝트 관리자를 원하는 엔지니어	예	작업 제출, 모델 미리보기, PDF 다운로드

세 가지 중 하나를 설치한 후 제공된 진단 스크립트(python scripts/cad_doctor.py)를 실행하여 SolidWorks 환경을 검증하세요.

문서 및 리소스

• 빠른 시작 가이드(Skill, MCP, CAD Studio) – README에 있습니다.
• 실행 코어의 상세 아키텍처 – docs/architecture/execution-core.md.
• 신뢰성 평가 방법론 – docs/architecture/v2-evaluation.md.
• 기능의 전체 목록 및 상태 – capabilities.yaml.
• 하위 스킬 사양 – subskills/ 및 SUBSKILLS.md.
• 모델링, 어셈블리, 도면, 모션, FEA를 다루는 예제 프로젝트 – examples/.

로드맵

• 검증된 SolidWorks 네이티브 기능을 확장합니다.
• CAD Studio에서 기능 라우팅 및 관찰 가능성을 개선합니다.
• 자동 테스트를 갖춘 커뮤니티 기여 하위 스킬을 더 추가합니다.

라이선스 – MIT.

---

요약하자면, SolidWorks 자동화 스킬은 내장된 검증, 결정적 오류 처리, 명확한 기능 카탈로그를 갖추어 LLM 에이전트가 실제 CAD 소프트웨어를 안정적으로 제어할 수 있게 하는 프로덕션 등급 브리지입니다.