Community라이팅 & 에디팅github.com

DWG To PDF

CAD 도면(DWG/DXF)을 웹 서비스 업로드 없이 PDF로 변환하는 스킬입니다.

DWG To PDF란 무엇인가요?

이 스킬은 AI Agent(예: Claude Code, Cursor, Codex)가 사용자의 CAD 도면 파일(DWG/DXF)을 웹에 업로드하지 않고 로컬에서 직접 PDF로 변환할 수 있도록 지원합니다. Windows 환경에서 ODA File Converter와 Python 패키지(ezdxf, matplotlib, pymupdf)를 활용하여 변환을 수행하며, 한글 등 비ASCII 경로 문제나 라이브러리 의존성 같은 까다로운 세부 사항을 내부 스크립트(scripts/convert_dwg_to_pdf.py)가 처리합니다. 사용자는 단순히 원본 파일과 출력 경로만 지정하면 되며, AI는 생성된 PDF의 페이지 수, 바이트 크기, 미리보기 PNG를 검증하여 품질을 확인합니다. 또한 변환 결과가 비어 있거나 잘못된 경우 용지 크기 조정이나 수동 출력 대안을 제안합니다. 웹 기반 변환 도구는 사용자의 명시적 승인 없이 사용하지 않으며, 보안과 파일 무결성을 최우선으로 합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add 2807334132-lab/codex-skills

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

DWG To PDF은(는) 무엇을 하나요?

개요

이 스킬을 사용하면 CAD 도면을 웹 서비스에 업로드하지 않고 PDF 파일로 변환할 수 있습니다. DWG 변환에는 Windows에서 여러 까다로운 세부 사항(ODA 명령줄 인수 순서, CAD 라이브러리 의존성, 비ASCII 출력 경로)이 있으므로 번들 스크립트를 선호합니다.

워크플로

  1. 원본 파일이 존재하는지 확인하고 .dwg인지 .dxf인지 식별합니다.
  2. 출력 경로를 선택합니다. 사용자가 지정하지 않은 경우 원본 파일 옆에 <원본파일명>.pdf로 저장합니다.
  3. 절대 경로로 scripts/convert_dwg_to_pdf.py를 실행합니다:
python scripts/convert_dwg_to_pdf.py --input "D:\path\plan.dwg" --output "D:\path\plan.pdf"
  1. 스크립트 출력에서 결과를 확인합니다:
    • pages가 1 이상이어야 합니다.
    • bytes가 0보다 커야 합니다.
    • preview는 1페이지의 렌더링된 PNG를 가리켜야 합니다.
  2. 사용자가 "열기"를 요청했거나 열어보는 것이 명확히 유용할 때 PDF를 엽니다.

도구

스크립트는 다음을 지원합니다:

  • .dwg: ODA File Converter로 DXF로 변환한 후 PDF로 렌더링합니다.
  • .dxf: 직접 PDF로 렌더링합니다.

ODA File Converter가 없는 경우, 허용될 때 Windows Package Manager로 설치합니다:

winget install --id ODA.ODAFileConverter -e --accept-source-agreements --accept-package-agreements --disable-interactivity

스크립트는 Python 패키지 ezdxf, matplotlib, pymupdf를 필요로 합니다. 패키지 설치가 허용되고 이들이 없으면 다음을 실행합니다:

python -m pip install ezdxf matplotlib pymupdf

품질 확인

생성된 PDF가 렌더링되는지 항상 확인하세요. 비어 있지 않은 PDF라도 도면이 보이지 않거나, 페이지가 심하게 잘렸거나, 텍스트/글꼴이 실패한 경우 잘못될 수 있습니다.

생성된 미리보기 PNG를 사용해 빠른 시각적 검사를 수행하세요. 미리보기가 비어 있거나 심하게 잘린 경우:

  • 더 큰 용지 크기(예: --paper a2-landscape)로 다시 실행합니다.
  • 도면이 ezdxf가 잘 렌더링할 수 없는 레이아웃이나 기능을 사용하는 경우 직접 ODA 뷰어/수동 인쇄를 시도합니다.
  • 출력이 모든 CAD 기능을 정확히 보존하지 못할 수 있음을 사용자에게 알립니다.

참고 사항

  • 원본 DWG를 수정하지 마십시오. 변환 시 복사된 중간 폴더에서 작업하십시오.
  • 사용자가 도면 업로드를 명시적으로 승인하지 않는 한 웹 변환기를 사용하지 마십시오.
  • 중국어 또는 기타 비ASCII 경로로 저장할 때는 스크립트가 먼저 ASCII 임시 PDF에 쓴 다음 요청된 출력 경로로 복사하도록 하십시오.
  • 최종 응답에는 절대 파일 경로를 사용하십시오.

관련 스킬