Community画像github.com

cad-parts

CadQuery サブプロセスを使って、物理的な 3D パーツをローカルの .stl/.step ファイルとして作成します。ワンショットで RAM ウォッチドッグ監視下のサブプロセスとして実行し、ユーザーが設計、モデリング、リサイズ、トリミング、リミックスを行いたい場合に使用します。

cad-parts とは?

このスキルは、Claude Code などの AI エージェントが、CadQuery を使用してローカル環境で物理的な 3D CAD パーツを設計・出力するためのものです。Windows 環境 (`C:\cadquery-venv`) 上で動作し、`.stl` や `.step` ファイルを生成します。主な特徴として、OOM(メモリ不足)クラッシュを防ぐための RAM ウォッチドッグ付きワンショットサブプロセス実行、出力品質を保証する `cq_helpers` による厳格なエクスポート検証、積層造形の失敗を防ぐためのアイランド(島)チェック機能などがあります。また、既に実績のあるパーツスクリプトの編集を禁止し、バリアントは新しいファイルとして作成するなど、厳格なバージョン管理ルールを定めています。このスキルは、FDM プリンターでの印刷を前提としたアダプター、ブラケット、ロボット部品、エンクロージャーなどの設計に特化しており、PCB 設計やスライサー設定には使用しません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ColinE0/cad-parts/tree/HEAD/cad-parts

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Copyright 2026 Colin Ezra Wilder. Licensed under the Apache License, Version 2.0 (本スキルに付属する LICENSE および NOTICE ファイルに従います)。

CadQuery サブプロセスによる CAD パーツ

ローカルでスクリプト可能な CAD:Python スクリプトがソリッドを構築し、ウォッチドッグ監視下のサブプロセスがそれを実行し、cq_helpers がエクスポートを検証し、6 方向からの PNG レンダリングが形状を証明します。ユーザーは結果を FDM プリンターで出力するため、ここから出力されるすべての STL はクリーンにスライス可能でなければなりません。

絶対条件

  1. ワンショットサブプロセスのみ。 2026-07-14 に、常駐型 CAD サーバープロセスが、呼び出しごとに蓄積されたインポートモデルによって OOM でマシン全体をクラッシュさせました(2026-11-14 の再現により、最初は非一様スケールが原因とされた問題は解決済み。落とし穴参照)。サブプロセスがクラッシュすると 1 回の実行が失われるだけですが、インプロセス処理がクラッシュするとマシン全体がダウンします。すべてのビルドは scripts/run_watchdogged.ps1 を通じて実行し、他の仮想環境スクリプト(描画プローブ、メッシュチェックなど)についても同様とし、CadQuery かどうかは問いません。hooks/require_runner.py が Claude Code フックとして登録されている場合(README 参照)、venv の Python への直接呼び出しは拒否され、代わりに使用するランナーコマンドが表示されます。この拒否はルールが機能している証拠であり、回避すべきエラーではありません。
  2. 実績のあるパーツファイルは決して編集しない。 印刷テストが完了し、正常に動作したスクリプトは凍結されます。バリアントは新しいファイルとして作成し(例:adapter_hex_trim.py は adapter_hex.py の隣に配置)、何が、なぜ変更されたかを docstring に正確に記載します。すべてのスクリプトには STATUS: 行(スクリプト規約参照)が含まれ、"実績あり"であることが記憶ではなく記述として残るようにします。
  3. すべてのエクスポートは cq_helpers.export_checked を通過する。 BRep isValid() だけではクリーンなメッシュが保証されず、スライサーは有効性チェックに合格する非水密 STL を拒否します。このゲートはすでに出荷済みの不良パーツを捕捉しています。
  4. 印刷予定のすべてのパーツは、その PRINT 方向でアイランドチェックを受ける。 h.islands(solid, up="+z")(または計画された上向き軸)を使用して、ベッドの上から始まり、後でパーツに結合されるマテリアルを検出します。これにより、サポート材が全体にわたって安定します。HIGH アイランドは、「サポート材で対応する」ではなく、設計上の問題として対処するか、印刷計画の前にユーザーに提示する必要があります。2026-10-09 には、ロボットシェルのホイールギャップピラーがこれに該当し(ツリーサポート上で 36.8 mm、厚さ 6.52 mm)、すべてのフィットチェックを通過した後、22 時間の 3 色印刷の途中で破損しました。フィットチェックは「収まるか」を問いますが、これは「積層造形できるか」を問うものです。

ワークフロー

  1. プロンプトで未確定の事項を確認する。 完全な仕様(「高さ 12 mm、外径 9、穴径 4.3」)であれば、ゲートは不要です。荷重がかかる選択肢が未確定の場合(どの穴か、「15 mm 突出」の測定基点、取り付けるもの、使用するハードウェア、どのフォルダか)、自身の解釈を短い提案として述べ、構築前にユーザーに確認します。参照画像は常にこのゲートの対象となります(下記参照)。
  2. スクリプトを作成する。 成果物のパーツ:スクリプトは出力ファイルと同じパーツフォルダに配置します(スクリプトがパーツの記録そのものです。「パーツの格納場所」参照)。プローブや実験:スクラッチフォルダを使用します。
  3. 実行する:
    & "$env:USERPROFILE\.claude\skills\cad-parts\scripts\run_watchdogged.ps1" -Script "C:\path\to\part.py" -Tail 40
    
    デフォルト:300 秒のタイムアウト、4 GB の上限、500 ms のポーリング間隔、インタープリタは C:\cadquery-venv\Scripts\python.exe(-Python <path> または CADPARTS_PYTHON 環境変数で上書き可能)。上限はプロセスツリー全体のコミットメモリに対して適用され、Windows ジョブオブジェクトを通じてカーネルレベルで強制されます。超過した割り当ては拒否され(スクリプトは MemoryError または OCCT 割り当てエラーを確認)、ランナーはツリーを強制終了し、終了コード 137 を返します。cadquery のインポートだけで約 0.7 GB をコミットするため、上限は決して ~1 GB 未満にしないでください。既知の重いジョブのためにのみ意図的に制限を引き上げます。強制終了の最初の対応として制限を引き上げることは絶対にしないでください。ウォッチドッグによる強制終了は、通常、上限不足ではなくジオメトリの誤り(落とし穴参照)が原因です。 -Tail N は標準出力の最後の N 行のみを表示します。完全なログは常にスクリプトと同じディレクトリの <script>.out.txt に保存されます。ログが長いスクリプトで使用すると、全ログがコンテキストに含まれなくなります。サマリー行は経過時間を報告します。-TimeoutSec は推測ではなく、この経過時間に基づいて選択します。PowerShell ツールを介して実行する場合は、ツール自身のタイムアウトを -TimeoutSec より長く設定します。ツールが先にランナーを強制終了すると、ジョブオブジェクトもビルドを一緒に停止します。実行は失われ、孤立することはありません。
  4. 出力を読む。 ランナーはスクリプトの標準出力、標準エラー出力、経過時間、およびプロセスツリーのピークコミットメモリを出力します。DONE センチネルが必要です。これがない実行は完了していません。終了コード 137 = ウォッチドッグによる強制終了(最終行にタイムアウトまたは上限超過が表示されます)。3 = ウォッチドッグをアームできなかったか(インタープリタが見つからない場合)、スクリプトは実行されていません。<script>.out.txt はビルドの実行ログです(README でこれを参照します)。<script>.err.txt は標準エラー出力に内容があった場合のみ存在します。上限超過による強制終了の場合、制限に触れる前にトリアージを行います(落とし穴:「上限超過による強制終了のトリアージ」参照)。
  5. 報告前に検証する。 render6 PNG を読み、シルエットが意図と一致するか確認します。寸法は記憶ではなく、スクリプトが出力する bbox/体積から報告します。各フィーチャーは、構築されたソリッドを測定(describe、面の bbox、壁を貫通するスラブの交差)することでチェックします。入力定数とそれ自身を比較するアサートは何も証明しません。その後、パーツが印刷される方向で h.islands を実行し(絶対条件 4)、フラグが立てられた内容をパーツとともに報告します。
  6. 記録する。 フォルダの README(印刷するファイル)を更新し、STATUS 行を設定し、次回のセッションに必要な情報を記録します(「記録」参照)。

パーツの格納場所とパーツフォルダの内容

パーツルート:ASK(ここにまだ ASK と書かれている場合、ユーザーにパーツの保存場所を尋ねます。例:C:\Users\<name>\Documents\cad-parts。ここに書き込むことを提案します)。すべてのパーツは、このルートの下に専用のフォルダを持ちます。関連するパーツはサブフォルダにグループ化します(ロボットのシャーシパーツは一緒に、単発の印刷物は別々に)。パーツの保存場所が不明な場合は推測せずに尋ねます。

パーツフォルダには以下が含まれます:

  • スクリプト、STEP、レンダリングはトップレベルに配置。すべての STL は stl/ サブフォルダに配置(stl_dir="stl" を指定してエクスポート)。チェーンフォルダ(「チェーン編集」参照)では、トップレベルにはパーツの 1 つのライブバージョンのみを保持します。トップレベルのパーツに対応する STL が stl/ にある場合、それが印刷対象です。誰かから渡された破損した STL は、stl/ が印刷可能を意味するため、トップレベルに残し、stl/ には入れません。
  • README.md:パーツの説明、系統(「使用中:v12、最新:v16 トライアル」)、および「印刷対象」と明示された行。ユーザーの許可なく archived/ に移動しないでください。README がない場合は作成します。バージョンではなくサイズ違い(11 mm と 14 mm のスタンドオフ)には、それぞれに印刷行を 1 つずつ設けます。
  • archived/:置き換えられたバージョン。バージョンまたはチェーンステップごとに 1 フォルダ。各フォルダには、スクリプト、STEP、STL、レンダリング、実行ログが一緒に含まれ、アーカイブルートには WHY-ARCHIVED.md が配置されます。アーカイブされたチェーンステップは元の場所で再実行しないでください(ソースパスが古いレイアウトを想定しています)。再実行する前に、まずトップレベルにコピーしてください。
  • DEAD-*.md マーカー:二度と使用してはいけないフィーチャー用(例:CRUSH-RIBS-DEAD-DO-NOT-REBUILD.md:2 つのモーターを破壊したクリブリブ)。パーツに触れる前に、フォルダ内の DEAD ファイルをすべて読んでください。
  • 印刷計画(存在する場合):1 つの STL 名に紐づけられます。パーツが進行したら古いものとしてマークします。
  • <script>.out.txt:ビルドの実行ログ。
  • current.json:チェーンフォルダ内(次のセクション参照)。

スクリプト規約

  • モジュール docstring:パーツの説明、存在理由、実行方法、STATUS: 行(Windows パスを含む場合は raw docstring r""" を使用。CPython 3.14 では \c、\s エスケープに関する警告が出ます)。例:STATUS: printed 2026-09-08, fitted, FROZEN または STATUS: trial, unprinted。FROZEN は絶対条件 2 で言うところの「実績あり」を意味します。印刷結果が得られたら行を更新します。
  • docstring には、このバージョンの変更内容とその理由を含めます。系統と印刷するファイルは README に記載します。以前のバージョンのメモを前方にコピーしないでください(あるスクリプトでこれを行った結果、50 KB に達しました)。
  • バージョン番号は 0.1 刻みで進める: バージョン管理されたパーツラインの新しいビルドは +0.1、v22 -> v22.1 ... v22.9 -> v23。ユーザーが明示しない限り、先にスキップしないでください。ファイル名ではドットをアンダースコアで記述します(chassis_v22_1.py、.step、stl/..._v22_1.stl)。これは、後のスクリプトが以前のバージョンをモジュールとしてインポートするため(import chassis_v12 as V12)、ドットを含むモジュール名はインポートできないからです。docstring と README では「v22.1」と記載します。既存のファイルはその番号を保持します。チェーンステップ(step8、step11e)は独自の方式を維持し、パーツに刻印されたバージョンスタンプはユーザー自身のカウントを保持します。
  • すべての寸法は、先頭に名前付き定数として、mm 単位で記述します。編集箇所を 1 か所にします。
  • import cq_helpers as h(venv の site-packages にインストール済み)。
  • 左右を記述する際は どちらの手かを明記する:ロボットまたはパーツ自身の左(ロボットになったつもりで前方を向いた場合)、または、その正面を見たときの観察者の左。これらは逆です。docstring、README、メッセージ内の裸の「左」は欠陥です。複数パーツのプロジェクトの先頭には軸の規則(前方、+x、上方向)を記述し、それを維持します。
  • solid.isValid() をアサートし、バウンディングボックスが意図した寸法と一致することをアサートします。また、式をアサートとしてガードします(例:ボーア深さはシャフト突出部を超えている必要があるなど)。これにより、パラメータの誤った編集がスクラップを印刷する代わりに大きなエラーとして失敗します。
  • 組み合わせるハードウェアはソリッドとしてモデル化し、h.interference でチェックします。寸法はデータシートまたはキャリパーから取得し、各定数のコメントに測定値か想定値か、数値の出所を記述します。より良い情報がない場合のデフォルトのファスナー値:M3 六角穴付きボルト 5.5 x 3.0、M3 クリアランス D3.30、M2 セルフタッピングパイロット穴(PLA 用)D1.7 ~ 1.8。その他の標準ファスナー:ISO 261 ねじおよび ISO 273 クリアランス。想定値であることを明記します。
  • print(..., flush=True) で進捗を表示。最後に print("DONE", flush=True) で終了します。
  • エクスポート:h.export_checked(solid, str(OUT / "part_name"), stl_dir="stl") の後に h.render6(solid, str(OUT / "part_name.png")) を実行します。
  • エクスポートされるファイルごとに 1 つのパーツ。パーツは個別に印刷されます。

インポートした STEP に対するチェーン編集

多くのパーツは、インポートした親 STEP に対する差分です(あるベースプレートは、9 回の差分を経て step 10c に到達しました)。ルール:

  • ステップに step<N> という名前を付け、ブランチの場合は接尾辞文字(step7c)、リベースの場合は r(step5r)を追加します。docstring の SRC 行は親ファイルを指定します。リベースにはフォルダ内に WHY ノートを追加します。
  • チェーンフォルダには、ライブの親を指定する current.json を配置します。ユーザーが印刷するパーツを指定した場合、またはステップスクリプト内で export_checked の直後に、h.set_current(folder, "part.step", note="2026-09-22: ...") を使用して書き込みます。README の「印刷対象」行と current.json は一致している必要があります。
  • 依存パーツは、plate = h.import_current(PLATE_DIR, pin="base_plate_step10c") を使用して親をインポートします。ファイル名をハードコードしないでください。チェーンが移動すると、ピン留めされたビルドは両方のパーツを指定して FAIL します。新しい親に対してすべてのフィットチェックを再実行し、その後ピンを移動します。set_current なしで STEP が置き換えられた場合、フィンガープリントチェックも失敗します。(理由:依存パーツは、かつて親 STEP が消失すると実行を停止していました。また、ある依存パーツは、印刷対象のパーツが新しいバージョンであるにもかかわらず、古い親にピン留めされたままで、すべてのチェックを通過していました。)
  • 差分を証明する:編集の前後で h.diff を使用し、編集ボックス外のすべてが変更されていないことをアサートします。
  • 新しい依存パーツ(プレートにボルトで固定されるブラケットなど)は、少なくとも以下をアサートします:装着されていること(合わせ面とのギャップゼロ、オーバーラップなし)、穴の軸が親の軸と一致していること、両方の穴でシャンククリアランスがあること、ヘッドと工具のアクセスがクリアであること(各ヘッドの上に六角レンチ用の柱があること)、およびブロックしてはならない親フィーチャーがまだ空いていること。親の穴は、その B-rep から読み取り、円筒面を軸方向でフィルタリングします(フィレットも円筒面であるため)。
  • スクリプトのパラメータのみのバリアント(11 mm スタンドオフの 14 mm コピー):2 つのスクリプトのテキスト差分(docstring、NAME、パラメータのみが異なること)と、解析的な体積に対する describe() を使用して、「他に変更がないこと」を証明します。ジオメトリ差分プローブは不要です。
  • 非一様スケールは、インポートした B-rep のすべての面を B スプラインに変換します(落とし穴)。その後のオフセットは失敗する可能性があります。再構築するか、メッシュをスケーリングします。

cq_helpers API(venv site-packages)

  • export_checked(shape, basepath, stl=True, step=True, stl_dir=None, mesh=None, agree_tol=0.015):Workplane または Shape を受け入れます。isValid() が必要です。.step / .stl を書き込みます(stl_dir が設定されている場合、STL は <basepath のディレクトリ>/<stl_dir>/ に書き込まれます。ここでは常に "stl")。trimesh による水密性 + ワインディングチェックを STL に対して行い、自動修復(merge_vertices 桁数 5 その後 4、fill_holes、fix_normals、体積のずれが 0.5% 未満の場合のみ許容)を実行します。その後、STL はディスクから読み戻した STEP(または step=False の場合は shape)と一致する必要があります:バウンディングボックスは各辺で max(0.05 mm, パーツの最大サイズの 0.5%) 以内、体積は agree_tol 以内である必要があります。trimesh メッシュを返します。失敗したチェックはそれぞれ h.GateError(AssertionError のサブクラス。python -O でスキップされないように明示的に発生)を発生させ、実行を停止します。書き込まれたファイルごとに 1 つの export ok: 行(完全なパスと拡張子付き)、および一致数とともに 1 つの export check: 行を出力します。自動修復は、有効な B-rep 上の細かいテッセレーションのひび割れを閉じます。欠落した面は閉じません(「ユーザーから渡されたメッシュの修復」参照)。STL は新しいコピーでメッシュ化されます(shape はメッシュ化されないままです)。そのため、最初に shape にピン留めされたメッシュは破棄されます。mesh=(deflection, angular)(mm 絶対値、ラジアン)でピン留めします。(ベンダーパーツのスリバー面には (0.05, 0.2) が必要でした。落とし穴参照)。
  • render6(shape, png_path, color="#b25563", tol=0.3):6 つの標準的なシェーディングビュー(前面/背面/左面/右面/上面/前面-3/4)を 1 つの PNG にレンダリングします。深度バッファリングされた VTK オフスクリーンレンダリング(matplotlib のペインターソートはアセンブリで透過を偽装しました。落とし穴参照)。平行投影。各ビューはパーツにフレーム設定されます。Workplane はそのスタック上のすべての Shape をレンダリングします。tol はテッセレーションの線形たわみ(mm)です(大きなアセンブリの場合は 0.6)。
  • render_compare(shape, ref_image_path, p(翻訳打ち切り)

関連スキル