CommunityBildgithub.com

CAD-Teile per CadQuery-Unterprozess

Erstelle physische 3D-Teile als lokale .stl/.step-Dateien mit CadQuery, ausgeführt als einmalige, RAM-überwachte Unterprozesse gegen C:\cadquery-venv.

Was ist CAD-Teile per CadQuery-Unterprozess?

Dieses Skill definiert eine zuverlässige, lokal ausgeführte CAD-Pipeline mittels CadQuery, die als einmalige, speicherüberwachte Unterprozesse gestartet wird. Es ist für Entwickler:innen und KI-Agenten konzipiert, die programmatisch druckbare 3D-Teile (Adapter, Halterungen, Gehäuse, Roboterteile, Tastenkappen usw.) entwerfen, anpassen oder reparieren müssen. Der Skill verhindert Systemabstürze durch einen Watchdog-Mechanismus, der den Speicherverbrauch des Unterprozesses begrenzt, und stellt die Ausgabequalität durch strenge Validierung mit der Hilfsbibliothek cq_helpers (Wasserdichtigkeits- und Volumenprüfung) sicher. Zu den unterstützten Formaten gehören STL und STEP, wobei die Ausgabe auf FDM-Druck optimiert ist. Das Skill wurde für Claude Code unter Windows entwickelt, ist aber konzeptionell auf andere KI-Codierungsagenten übertragbar.

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

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Copyright 2026 Colin Ezra Wilder. Lizenziert unter der Apache License, Version 2.0 (Die mit diesem Skill mitgelieferten Dateien LICENSE und NOTICE).

CAD-Teile via CadQuery-Unterprozess

Lokales, skriptbares CAD: Ein Python-Skript erstellt den Volumenkörper, ein überwachter Unterprozess führt es aus, cq_helpers steuert den Export, ein 6-Ansichten-PNG belegt die Form. Der Benutzer druckt die Ergebnisse auf FDM-Druckern, daher muss jedes STL, das dieses Skill verlässt, sauber schneidbar sein.

Unverhandelbare Regeln

  1. Nur einmalige Unterprozesse. Am 14.07.2026 stürzte ein langlebiger CAD-Serverprozess den gesamten Rechner ab, da importierte Modelle über mehrere Aufrufe hinweg akkumulierten (eine Wiederholung vom 14.11.2026 klärte die zunächst beschuldigte ungleichmäßige Skalierung; siehe Fallstricke). Ein abgestürzter Unterprozess kostet einen Durchlauf; ein abgestürzter In-Prozess-Vorgang legt die gesamte Maschine lahm. Führe jeden Durchlauf über scripts/run_watchdogged.ps1 aus, sowie jedes andere Venv-Skript (Messsonden, Netzkontrollen), egal ob CadQuery oder nicht. Wenn hooks/require_runner.py als Claude-Code-Hook registriert ist (README), wird ein direkter Aufruf des Venv-Python mit dem stattdessen zu verwendenden Runner-Befehl abgelehnt: Diese Ablehnung ist die funktionierende Regel, kein zu umgehender Fehler.
  2. Bearbeite niemals eine bewährte Teiledatei. Ein Skript, dessen Druck getestet und funktioniert hat, ist eingefroren. Varianten erhalten eine NEUE Datei (z. B. adapter_hex_trim.py neben adapter_hex.py) mit einem Docstring, der genau benennt, was geändert wurde und warum. Jedes Skript enthält eine STATUS:-Zeile (Skriptkonventionen), sodass "bewährt" dokumentiert und nicht erinnert wird.
  3. Jeder Export erfolgt über cq_helpers.export_checked. Allein isValid() der BRep garantiert kein sauberes Netz; Slicer weisen nicht-wasserdichte STLs zurück, die Gültigkeitsprüfungen bestehen. Diese Kontrolle hat bereits ein ausgeliefertes fehlerhaftes Teil abgefangen.
  4. Jedes zu druckende Teil erhält eine Inselprüfung in seiner DRUCK-Orientierung. h.islands(solid, up="+z") (oder die vorgesehene Hochachse) findet Material, das über der Bauplattform beginnt und sich erst später mit dem Teil verbindet, sodass es während des gesamten Drucks auf Stützen steht. Eine HOH-E-Insel ist ein Konstruktionsproblem, das vor jedem Druckplan zu beheben oder dem Benutzer mitzuteilen ist – niemals "Stützen werden das schon regeln". Am 09.10.2026 war ein Radabstandspfeiler einer Roboterschale eine solche Insel (36,8 mm hoch auf Baumstützen, 6,52 dünn) und brach während eines 22-stündigen Dreifarbdrucks ab, nachdem alle Passungskontrollen bestanden waren. Passungskontrollen fragen "Passt es?"; diese hier fragt "Kann es von unten nach oben gebaut werden?".

Arbeitsablauf

  1. Bestätige, was die Eingabe offen lässt. Eine vollständige Spezifikation ("12 mm hoch, 9 AD, 4,3 Loch") benötigt keine Abfrage. Wenn eine tragende Entscheidung offen ist (welche Löcher, woran "15 mm überstehend" gemessen wird, was darauf montiert wird, welche Hardware, welcher Ordner), formuliere deine Interpretation als kurzen Vorschlag und frage den Benutzer vor dem Bauen. Referenzbilder erhalten immer diese Abfrage (siehe unten).
  2. Schreibe das Skript. Lieferbare Teile: Das Skript liegt neben seinen Ausgaben im Ordner des Teils (das Skript IST die Aufzeichnung des Teils; siehe "Wo Teile leben"). Sonden und Experimente: ein Scratch-Ordner.
  3. Führe es aus:
    & "$env:USERPROFILE\.claude\skills\cad-parts\scripts\run_watchdogged.ps1" -Script "C:\pfad\zu\part.py" -Tail 40
    
    Standardwerte: 300 s Timeout, 4 GB Grenze, 500 ms Abfrage, Interpreter C:\cadquery-venv\Scripts\python.exe (überschreibbar mit -Python <pfad> oder der Umgebungsvariablen CADPARTS_PYTHON). Die Grenze bezieht sich auf den gesamten belegten Speicher des gesamten Prozessbaums, kernelgestützt durch ein Windows-Job-Objekt: Eine Überschreitung wird abgelehnt (das Skript sieht MemoryError oder einen OCCT-Allokationsfehler) und der Runner tötet den Baum, Exit 137. Das Importieren von CadQuery allein belegt bereits etwa 0,7 GB, daher niemals unter ~1 GB begrenzen. Grenzen nur bewusst für einen bekanntermaßen schweren Job erhöhen, niemals als erste Reaktion auf einen Kill; ein Watchdog-Kill bedeutet meist einen Geometriefehler (siehe Fallstricke), keine zu knappe Grenze. -Tail N gibt nur die letzten N stdout-Zeilen aus; das vollständige Log befindet sich stets in <skript>.out.txt neben dem Skript. Verwende es bei lang protokollierenden Skripten, damit das gesamte Log nicht im Kontext landet. Die Zusammenfassungszeile gibt die Wandzeit an: wähle -TimeoutSec daran bemessen, nicht durch Raten. Setze bei einem PowerShell-Tool dessen eigenes Timeout über -TimeoutSec. Wenn das Tool den Runner zuerst tötet, reißt das Job-Objekt den Build mit in den Tod: Der Durchlauf ist verloren, niemals verwaist.
  4. Lies die Ausgabe. Der Runner gibt die Stdout-Ausgabe des Skripts, etwaige Stderr, die Wandzeit und den maximal belegten Speicher des Baums aus. Erwarte die DONE-Sentinel; ein Durchlauf ohne sie ist nicht abgeschlossen. Exit 137 = Watchdog-Kill (die letzte Zeile sagt Timeout oder Grenze); 3 = Der Watchdog konnte nicht aktiviert werden (oder der Interpreter fehlt), also wurde das Skript nie ausgeführt. <skript>.out.txt ist das Build-Laufprotokoll (READMEs zitieren es); <skript>.err.txt existiert nur, wenn Stderr Inhalt hatte. Bei einem Grenz-Kill: Fehlersuche vor Eingriff in die Grenzen (Fallstricke: "Fehlersuche bei einem Grenz-Kill").
  5. Überprüfe vor dem Melden. Lies das render6-PNG und überprüfe die Silhouette auf Übereinstimmung mit der Absicht. Melde Abmessungen aus den gedruckten Bbox/Volumen des Skripts, nicht aus dem Gedächtnis. Überprüfe jedes Merkmal durch MESSEN des gebauten Volumenkörpers (describe, Flächen-Bboxes, eine durch die Wand geschnittene Platte); eine Behauptung (Assert), die eine Eingangskonstante mit sich selbst vergleicht, beweist nichts. Führe dann h.islands aus in der Orientierung, in der das Teil gedruckt wird (unverhandelbare Regel 4), und melde, was es zusammen mit dem Teil kennzeichnet.
  6. Dokumentiere. Aktualisiere die Ordner-README (welche Datei zu drucken ist), setze die STATUS-Zeile und notiere alles Gelernte, das die nächste Sitzung benötigt (siehe "Dokumentation").

Wo Teile leben und was ein Teilordner enthält

Teile-Wurzel: FRAGEN (wenn hier immer noch FRAGEN steht, frage den Benutzer, wo die Teile abgelegt werden sollen, z. B. C:\Users\<name>\Documents\cad-parts, und biete an, es hier einzutragen). Jedes Teil erhält einen eigenen Ordner unter dieser Wurzel; gruppiere verwandte Teile in Unterordnern (die Chassisteile eines Roboters zusammen, Einzeldrucke zusammen). Wenn der Heimatordner eines Teils unklar ist, frage nach; rate nicht.

Ein Teilordner enthält:

  • Das/die Skript(e), STEPs und Renderings auf der obersten Ebene; jedes STL in einem stl/ Unterordner (exportieren mit stl_dir="stl"). In einem Kettenordner (siehe "Kettenbearbeitungen") enthält die oberste Ebene EINE Live-Version des Teils: Wenn sich ein STL in stl/ für das Teil der obersten Ebene befindet, ist es das zu druckende. Ein defektes STL, das jemand aushändigt, bleibt auf der obersten Ebene, niemals in stl/, da stl/ druckbar bedeutet.
  • README.md: Was das Teil ist, die Abstammung ("in Verwendung: v12, neueste: v16 Versuch"), und eine explizite Zeile "das zu druckende Teil". Nichts wird ohne das OK des Benutzers nach archived/ verschoben. Kein README vorhanden: eins schreiben. Geschwistergrößen anstatt Versionen (ein 11 mm und ein 14 mm Abstandshalter) erhalten jeweils eine Druckzeile.
  • archived/: Veraltete Versionen, ein Ordner pro Version oder Kettenschritt, jeder mit seinem Skript, STEP, STL, Renderings und Laufprotokoll zusammen, und WHY-ARCHIVED.md im Archiv-Stamm. Archivierte Kettenschritte werden nicht an Ort und Stelle erneut ausgeführt (ihre Quellpfade gehen vom alten Layout aus); kopiere zuerst eine zurück auf die oberste Ebene.
  • DEAD-*.md Markierungen für Funktionen, die niemals zurückkehren dürfen (z. B. CRUSH-RIBS-DEAD-DO-NOT-REBUILD.md: Quetschrippen, die zwei Motoren zerstört haben). Lies jede DEAD-Datei im Ordner, bevor du das Teil berührst.
  • Ein Druckplan, falls einer geschrieben wurde, gebunden an einen STL-Namen; markiere ihn als veraltet, wenn das Teil weiterentwickelt wird.
  • <skript>.out.txt, das Build-Laufprotokoll.
  • current.json in Kettenordnern (nächste Abschnitte).

Skriptkonventionen

  • Modul-Docstring: Was das Teil ist, warum es existiert, wie man es ausführt, und eine STATUS:-Zeile (mache es zu einem rohen Docstring, r""", wenn es Windows-Pfade enthält: CPython 3.14 warnt vor \c, \s Escape-Sequenzen): STATUS: printed 2026-09-08, fitted, FROZEN oder STATUS: trial, unprinted. FROZEN ist das, was unverhandelbare Regel 2 mit "bewährt" meint; aktualisiere die Zeile, wenn ein Druckergebnis vorliegt.
  • Der Docstring enthält das Delta DIESER Version und seine Begründung. Abstammung und welche Datei zu drucken ist, gehören in die README. Kopiere keine Notizen der vorherigen Version nach vorne (ein Skript, das dies tat, erreichte 50 KB).
  • Versionsnummern in Zehntelschritten: Jeder neue Build einer versionierten Teilelinie ist +0,1, v22 -> v22.1 ... v22.9 -> v23, niemals vorausspringen, es sei denn, der Benutzer sagt es. Dateien schreiben den Punkt als Unterstrich (chassis_v22_1.py, .step, stl/..._v22_1.stl), da spätere Skripte frühere Versionen als Module importieren (import chassis_v12 as V12) und ein gepunkteter Modulname nicht importiert werden kann; Docstrings und READMEs sagen "v22.1". Vorhandene Dateien behalten ihre Nummern. Kettenschritte (step8, step11e) behalten ihr eigenes Schema, und jeder auf einem Teil eingravierte Versionsstempel bleibt die eigene Zählung des Benutzers.
  • ALLE Abmessungen als benannte Konstanten oben, in mm, eine Stelle zum Bearbeiten.
  • import cq_helpers as h (installiert in den site-packages des Venv).
  • Sage, WELCHE Seite, wenn du links oder rechts schreibst: Die eigene Linke des Roboters oder Teils (als ob du es wärst, nach vorne schauend) oder die Linke des Betrachters, der auf seine Vorderseite schaut. Sie sind entgegengesetzt; ein bloßes "links" in einem Docstring, README oder einer Nachricht ist ein Fehler. Schreibe die Achsenkonvention (welche Richtung ist vorne, +x, oben) oben in jedes Mehrteileprojekt und behalte sie bei.
  • Assert solid.isValid() und assertiere, dass die Begrenzungsbox den beabsichtigten Abmessungen entspricht; schütze auch Formeln mit Asserts (z. B. Bohrungstiefe muss Wellenüberstand überschreiten), damit eine fehlerhafte Parameterbearbeitung laut fehlschlägt, anstatt Ausschuss zu drucken.
  • Passende Hardware wird als Volumenkörper modelliert und mit h.interference geprüft. Nimm die Abmessungen aus einem Datenblatt oder einem Messschieber und markiere den Kommentar jeder Konstanten als gemessen oder angenommen, mit der Herkunft der Zahl. Standardwerte für Verbindungselemente, wenn nichts Besseres bekannt ist: M3 Zylinderschraube 5,5 x 3,0, M3 Durchgangsloch D3,30, M2 Schneidschrauben Pilot in PLA D1,7 bis 1,8. Andere Standardverbindungselemente: ISO 261 Gewinde und ISO 273 Durchgangsloch, als angenommen markiert.
  • print(..., flush=True) für Fortschritt; beende mit print("DONE", flush=True).
  • Export: h.export_checked(solid, str(AUS / "teil_name"), stl_dir="stl") dann h.render6(solid, str(AUS / "teil_name.png")).
  • Ein Teil pro exportierter Datei; Teile werden einzeln gedruckt.

Kettenbearbeitungen an einem importierten STEP

Viele Teile sind eine Änderung gegenüber einem importierten Mutter-STEP (eine Grundplatte erreichte Schritt 10c durch neun solcher Änderungen). Regeln:

  • Benenne Schritte step<N>, mit einem Suffixbuchstaben für einen Zweig (step7c) oder ein Rebase (step5r); die SRC-Zeile im Docstring benennt die Mutterdatei. Ein Rebase erhält eine WHY-Notiz im Ordner.
  • Der Kettenordner trägt current.json, das die Live-Mutter benennt. Schreibe es mit h.set_current(ordner, "part.step", note="2026-09-22: ..."), wenn der Benutzer das zu druckende Teil benennt, oder aus dem Schritt-Skript direkt nach seinem export_checked. Die Zeile "das zu druckende Teil" in der README und current.json müssen übereinstimmen.
  • Abhängige importieren die Mutter mit plate = h.import_current(PLATTE_VERZ, pin="base_plate_step10c"), niemals mit einem fest codierten Dateinamen. Wenn die Kette weiterzieht, SCHLÄGT der gepinnte Build FEHL und benennt beide Teile; führe jede Passungsprüfung gegen die neue Mutter erneut aus, dann verschiebe den Pin. Die Fingerabdruckprüfung schlägt ebenfalls fehl, wenn der STEP ohne set_current ersetzt wurde. (Warum: Abhängige hörten einmal auf zu laufen, als ihr Mutter-STEP verschwand, und einer bestand jede Prüfung, gepinnt auf eine alte Mutter, während eine neuere das zu druckende Teil war.)
  • Belege die Änderung: h.diff vorher und nachher, und assertiere, dass alles außerhalb des Bearbeitungsrahmens unverändert ist.
  • Ein NEUES abhängiges Teil (eine an einer Platte verschraubte Halterung) assertiert mindestens: Sitz (kein Spalt zur Passfläche, keine Überschneidung), seine Lochachsen auf denen der Mutter, Schaftdurchlass in beiden Löchern, Kopf- und Werkzeugzugang frei (ein Inbusschlüssel-Säule über jedem Kopf) und jedes Muttermerkmal, das es nicht blockieren darf, noch frei. Lies die Löcher der Mutter aus ihrer B-Rep, indem du Zylinderflächen nach Achsrichtung filterst, da eine Verrundung ebenfalls eine Zylinderfläche ist.
  • Nur-Parameter-Variante eines Skripts (die 14 mm Kopie eines 11 mm Abstandshalters): belege "nichts anderes geändert" mit einem Text-Diff der beiden Skripte (nur der Docstring, NAME und der Parameter unterscheiden sich) plus describe() gegen das analytische Volumen. Keine Geometrie-Diff-Sonde erforderlich.
  • Eine ungleichmäßige Skalierung verwandelt jede Fläche einer importierten B-Rep in eine B-Spline (Fallstricke): Versätze können danach fehlschlagen. Neu bauen oder das Netz skalieren.

cq_helpers API (Venv site-packages)

  • export_checked(shape, basepath, stl=True, step=True, stl_dir=None, mesh=None, agree_tol=0.015): Akzeptiert Workplane oder Shape; erfordert isValid(); schreibt .step/.stl (das STL in <verz von basepath>/<stl_dir>/ wenn stl_dir gesetzt ist, hier immer "stl"); trimesh Wasserdichtigkeit + Windungsprüfung für das STL mit automatischer Reparatur (merge_vertices Stellen 5 dann 4, fill_holes, fix_normals, akzeptiert nur, wenn Volumendrift < 0,5 %); dann muss das STL mit dem von der Festplatte zurückgelesenen STEP übereinstimmen (oder mit shape wenn step=False): Begrenzungsbox innerhalb von max(0,05 mm, 0,5 % der größten Teilegröße) pro Seite, Volumen innerhalb von agree_tol. Gibt das trimesh-Netz zurück. Jede fehlgeschlagene Prüfung löst h.GateError aus (eine Unterklasse von AssertionError, explizit ausgelöst, damit python -O es nicht überspringen kann), was den Durchlauf stoppt. Gibt eine export ok:-Zeile pro geschriebener Datei aus, voller Pfad mit Erweiterung, und eine export check:-Zeile mit den Übereinstimmungszahlen. Die automatische Reparatur schließt haarfeine Tessellierungsrisse in einer gültigen B-Rep; sie wird KEINE fehlende Fläche schließen (siehe "Reparieren eines vom Benutzer übergebenen Netzes"). Das STL wird auf einer frischen Kopie vernetzt (shape bleibt unvernetzt), daher wird ein zuerst auf shape angeheftetes Netz verworfen: Hefte es mit mesh=(deflection, angular) an (mm absolut, rad; Herstellerteile mit schlanken Flächen benötigten (0.05, 0.2), Fallstricke).
  • render6(shape, png_path, color="#b25563", tol=0.3): 6 kanonische schattierte Ansichten (vorne/hinten/links/rechts/oben/vorne-3/4) in einem PNG. Ein tiefengepufferter VTK Offscreen-Renderer (matplotlibs Painter-Sortierung simulierte Durchsicht bei Zusammenbauten, Fallstricke), Parallelprojektion, jede Ansicht auf das Teil gerahmt; ein Workplane rendert jede Shape auf seinem Stack; tol ist die lineare Abweichung der Tessellierung in mm (0,6 für große Zusammenbauten).
  • render_compare(shape, ref_image_path, p

…

[für die Übersetzung gekürzt]

Verwandte Skills