Communityライティング&編集github.com

DWG → PDF 変換スキル

CAD図面(DWG/DXF)をWebサービスにアップロードせず、ローカル環境でPDFに変換するスキルです。

DWG → PDF 変換スキル とは?

このスキルは、開発者やAIエージェントがCAD図面(DWG/DXF形式)をローカル環境でPDFに変換するためのツールです。図面を外部サービスに送信せずに済むため、セキュリティとプライバシーを重視するシナリオに最適です。Windows環境を前提としており、ODA File Converterやezdxf、matplotlib、pymupdfといった依存関係を自動的にインストールできます。変換ワークフローは、ソースファイルの確認、出力パスの決定、専用Pythonスクリプトの実行、結果の検証(ページ数・バイト数・プレビュー画像の確認)の4ステップで構成されます。非ASCIIパスや文字化けへの対応、品質チェックの実施など、実運用で必要となる細かな注意点もカバーされています。

対応~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 を PDF に変換

概要

このスキルを使用すると、CAD図面をWebサービスにアップロードせずに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を変更しないでください。変換時にはコピーした中間フォルダから作業します。
  • ユーザーが図面のアップロードを明示的に承認しない限り、Webコンバーターは避けてください。
  • 中国語やその他の非ASCIIパスに保存する場合は、スクリプトが最初にASCII一時PDFに書き込み、要求された出力パスにコピーするようにします。
  • 最終的な応答では絶対ファイルパスを使用してください。

関連スキル