BackboneNeo/ai-skills-hardware-wiring-diagrams

Arbeitsablauf für Hardware-Verdrahtungspläne

Behandeln Sie Datenblätter und Steckerzeichnungen als elektrische Quelle der Wahrheit. Behandeln Sie Komponentenfotos nur als Platzierungsnachweise, wenn deren Pad-Beschriftungen lesbar und die Ausrichtung eindeutig ist.

1. Festlegen des Verbindungsvertrags

1. Erfassen Sie jede Komponente, jeden Stecker, Pin, jedes Signal, jede Spannungsdomäne, Ausrichtung und das angeforderte Ausgabeformat.
2. Notieren Sie die autoritative Quelle und Revision für jede Pinbelegung. Leiten Sie keine Pin-Zuweisung aus einem Produktfoto ab, wenn ein Datenblatt oder Schaltplan existiert.
3. Normalisieren Sie jede Verbindung in einer maschinenlesbaren Netzliste vor dem Zeichnen. Verwenden Sie physikalische Pin-Nummern und Signalnamen gemeinsam.
4. Markieren Sie unbekannte, optionale, reservierte, nicht verbundene und Stromquellen-Pins explizit. Stoppen Sie vor dem Verlegen, wenn eine sicherheitskritische Pinbelegung oder Spannung ungeklärt ist.
5. Unterscheiden Sie einen Montage-/Verdrahtungsplan von einem Prinzipschaltplan. Halten Sie sie über dieselbe Netzliste synchron, auch wenn dem Benutzer nur einer angezeigt wird.

Lesen Sie source-truth-and-orientation.md, bevor Sie gedrehte Platinen, gespiegelte Ansichten, Unterseitenfotos oder Steckerpaarflächen interpretieren. Lesen Sie electrical-rules.md für Signal- und Spannungsprüfungen.

2. Planung des Blattes vor dem Verlegen

1. Wählen Sie A4 oder A3 und reservieren Sie Bereiche für Titel, Komponenten, Pinbelegungs-Hinweise, Notizen und Legende.
2. Platzieren Sie die Hauptsteuerung nahe der Bildmitte. Setzen Sie Peripheriegeräte in die Nähe der Steuerseite, mit der sie verbunden sind.
3. Drehen Sie das Komponentenbild und den zugehörigen Hinweis zusammen. Halten Sie jeden Hinweis nahe am entsprechenden physischen Stecker.
4. Verwenden Sie einen kompakten Pinbelegungs-Hinweis, wenn ein Board-Header zu dicht ist. Bewahren Sie die exakte physikalische Reihenfolge nach Drehung oder Spiegelung.
5. Verschieben Sie Beschriftungen vor dem Verlegen auf eine freie Seite. Verlegen Sie niemals durch Fotos, Beschriftungen, Pin-Nummern oder benachbarte Kontaktsymbole.

Lesen Sie layout-and-callouts.md für die A3-Komposition, GPIO-Hinweise und Komponenten-Karten-Muster.

3. Deterministisches Verlegen von Verbindungen

1. Verlegen Sie orthogonal, es sei denn, das Projekt erfordert explizit einen anderen Stil.
2. Verbinden Sie von der Grenze eines beschrifteten Anschlusses oder Pads bis zur Grenze seines Ziels. Stoppen Sie nicht vorher, verschwinden Sie nicht unter einer Karte und kreuzen Sie nicht die Kontaktmitte.
3. Reservieren Sie einen Kanal pro Draht. Platzieren Sie niemals zwei Verbindungssegmente auf demselben geometrischen Segment.
4. Vermeiden Sie Kreuzungen. Wenn eine Kreuzung unvermeidbar ist, halten Sie sie bei 90 Grad, verwenden Sie eine sichtbare Trennungskonvention und deuten Sie niemals eine Verbindungsstelle an.
5. Zeichnen Sie Leitungen unter den Anschlusssymbolen, zeichnen Sie dann Anschlussfüllungen, Nummern und Beschriftungen über den Leitungen neu. Bewahren Sie einen sichtbaren Endpunkt an der Kontaktkante.
6. Halten Sie parallele Leitungen mindestens im konfigurierten Kanalabstand zueinander, einschließlich ihrer Halos.
7. Wenden Sie die stabile Farbzuordnung in visual-language.md an; kombinieren Sie Farbe immer mit einer Signalbezeichnung.

Verwenden Sie scripts/validate_wiring.py nach jeder wesentlichen Routing-Änderung. Behandeln Sie jede Überlappung, unbeabsichtigte Kreuzung, lose Endpunkte, verdeckte Beschriftung oder ungültige elektrische Verbindung als fehlgeschlagenen Kandidaten.

4. Aufbau aus wiederverwendbaren SVG-Primitiven

1. Beginnen Sie mit wiring-a3-template.svg, wenn kein projekteigenes Template existiert.
2. Halten Sie Komponentenfotos in assets/ oder dem Projekt-Asset-Verzeichnis und referenzieren Sie sie über relative Pfade.
3. Geben Sie Leitungen, Anschlüssen, Beschriftungen, Komponenten und Keep-Out-Bereichen stabile IDs und semantische data-*-Attribute. Folgen Sie svg-annotation-contract.md.
4. Platzieren Sie Leitungen in einer dedizierten Ebene unter den Anschlüssen und dem Text. Verwenden Sie einen Halo nur, um Leitungen vom Hintergrund zu trennen; verwenden Sie ihn nicht, um eine andere Leitung zu verbergen.
5. Bewahren Sie bearbeitbares SVG als Quelle. Rendern Sie PNG/PDF nur als abgeleitete Prüfartefakte.

5. Überprüfung in Schichten

1. Führen Sie strukturelles SVG-Parsing und den Verdrahtungsvalidator aus.
2. Überprüfen Sie, ob jeder Netzlisten-Endpunkt genau einmal existiert und jede Leitung an beiden deklarierten Endpunkten endet.
3. Überprüfen Sie die Stromrichtung, Spannungskompatibilität, gemeinsame Masse, UART-Überkreuzung und bussspezifische Anforderungen.
4. Überprüfen Sie die physikalische Nummerierung gegen die tatsächlich angezeigte Ausrichtung, einschließlich Pin-1-Indikatoren und ungeraden/geraden Reihen.
5. Rendern Sie das vollständige Blatt und Nahaufnahmen jedes geänderten Steckers.
6. Überprüfen Sie in der beabsichtigten Druckgröße. Pin-Nummern, Signalnamen, Drahtidentität, Endpunktkontakt und Warnungen müssen lesbar bleiben.
7. Rendern Sie nach jeder SVG-Bearbeitung neu; melden Sie niemals Erfolg allein aufgrund der Quelleninspektion.

Verwenden Sie scripts/render_svg.py. Laden Sie in Codex Desktop die Workspace-Abhängigkeiten, sofern verfügbar; der Renderer erkennt auch automatisch die gebündelte Node.js- und Sharp-Laufzeitumgebung für die PNG-Ausgabe.

Lesen Sie validation-gates.md, bevor Sie die Fertigstellung erklären. Lesen Sie failure-patterns.md, wenn Sie ein vorhandenes Diagramm reparieren.

6. Wahrheitsgemäße Lieferung

• Liefern Sie das bearbeitbare SVG, ein gerendertes PNG und PDF, wenn angefordert.
• Geben Sie die genaue Pin-zu-Pin-Zuordnung für neu hinzugefügte oder geänderte Verbindungen an.
• Geben Sie an, welche Pinbelegungen quellgeprüft wurden und welche Annahmen noch bestehen.
• Melden Sie completed nur, wenn strukturelle, elektrische, Routing- und visuelle Prüfungen bestanden sind.
• Melden Sie blocked, wenn eine autoritative Pinbelegung, Spannungsbewertung, Steckerausrichtung oder Interpretation der Paarfläche nicht ermittelt werden kann.
• Behaupten Sie niemals, dass eine visuell plausible Leitung die elektrische Korrektheit beweist.