export-stl

STL エクスポートスキル

OpenSCAD ファイルを STL 形式に変換し、3D プリントに向けてジオメトリを自動検証します。

使用するタイミング

次の条件を満たしたら、このスキルを使用します。

1. 設計を反復し、PNG プレビューで正しく表示される
2. 3D プリント用にエクスポートする準備ができている

使用方法

.claude/skills/export-stl/scripts/export-stl.sh <input.scad> [options]

オプション

• --output <path> - 出力先を指定します（デフォルト：<input>.stl）
• --binary - バイナリ STL としてエクスポートします（ファイルサイズが小さく、デフォルト）
• --ascii - ASCII STL としてエクスポートします（人間が読み取れる形式）

ジオメトリの検証

エクスポート中に、スクリプトは一般的なプリント上の問題を確認します。

• 非多様体ジオメトリ - メッシュに穴がある、または 2 つを超える面で共有されるエッジがあります
• 自己交差するジオメトリ - モデルの一部が不適切に重なっています
• 退化した面 - スライサーの問題を引き起こす可能性のある、面積がゼロの三角形です

問題が検出されてもエクスポートは完了しますが、修正方法の案内を含む警告が表示されます。

例

phone_stand_003.scad のプレビューに問題がなければ、次を実行します。

.claude/skills/export-stl/scripts/export-stl.sh phone_stand_003.scad

出力：

--- Geometry Validation ---
STATUS: PASSED - No geometry issues detected
- Mesh appears manifold (watertight)
- No self-intersections found
- Ready for slicing

ワークフローとの統合

/openscad → /preview-scad → /export-stl
                              ↓
                     Geometry validation
                              ↓
                     Ready for slicer

よくある問題の修正

検証で問題が報告された場合：

• 非多様体：すべての形状が閉じた立体であることを確認し、3D コンテキストで 2D 形状を使用しないでください
• 自己交差：重なり合う形状を適切に結合するには、union() を使用します
• 退化：非常に薄い形状がないか確認し、曲線には $fn の値を大きくします

注意事項

• バイナリ STL を推奨します（ファイルサイズが小さく、処理が速いため）
• エクスポート時に完全なレンダリングを行うため、複雑なモデルでは時間がかかることがあります
• スライスの複雑さを見積もるために、三角形の数が報告されます