BackboneNeo/ai-skills-hardware-wiring-diagrams

ハードウェア配線図のワークフロー

データシートとコネクタ図面を電気的な信頼できる情報源として扱います。コンポーネントの写真は、パッドのラベルが判読可能で向きが明確でない限り、配置の証拠としてのみ使用します。

1. 接続契約の確立

1. すべてのコンポーネント、コネクタ、ピン、信号、電圧ドメイン、向き、要求された出力形式を棚卸しします。
2. 各ピン配置の信頼できる情報源とリビジョンを記録します。データシートや回路図が存在する場合、製品写真からピン割り当てを推測しないでください。
3. 描画前に、すべての接続を機械可読なネットリストに正規化します。物理ピン番号と信号名を一緒に使用します。
4. 不明、オプション、予約、未接続、電源ピンを明示的にマークします。安全性に関わるピン配置や電圧が未解決の場合は、配線を開始する前に停止します。
5. 実装/配線図と原理回路図を区別します。ユーザーにどちらか一方のみが表示される場合でも、同じネットリストを通じて同期を保ちます。

回転した基板、ミラー表示、下面写真、コネクタ嵌合面を解釈する前に、source-truth-and-orientation.mdを参照してください。信号と電源のチェックについては、electrical-rules.mdを参照してください。

2. 配線前のシート計画

1. A4またはA3を選択し、タイトル、コンポーネント、ピン配置コールアウト、注釈、凡例のゾーンを確保します。
2. メインコントローラを視覚的中心の近くに配置します。ペリフェラルは、接続するコントローラ側の近くに配置します。
3. コンポーネント画像とそのコールアウトを一緒に回転します。各コールアウトは、対応する物理コネクタの近くに配置します。
4. 基板ヘッダが密集しすぎている場合は、コンパクトなピン配置コールアウトを使用します。回転やミラーリング後も、正確な物理的順序を維持します。
5. 配線前にラベルを空いている側に移動します。写真、ラベル、ピン番号、隣接する接点シンボルを通して配線しないでください。

A3の構成、GPIOコールアウト、コンポーネントカードのパターンについては、layout-and-callouts.mdを参照してください。

3. 接続の決定論的配線

1. プロジェクトが明示的に他のスタイルを要求しない限り、直交配線します。
2. ラベル付き端子またはパッドの境界から宛先の境界まで接続します。途中で止めたり、カードの下に隠したり、接点の中心を横切ったりしないでください。
3. 1本のワードあたり1チャネルを確保します。同じ幾何学的セグメント上に2つの接続セグメントを配置しないでください。
4. 交差を避けてください。交差が避けられない場合は、90度に保ち、可視的な分離規則を使用し、接続点を暗示しないでください。
5. 端子シンボルの下に配線を描画し、その後、端子の塗りつぶし、番号、ラベルを配線の上に再描画します。接点の端に可視的な端点を維持します。
6. 平行配線は、ハローを含め、設定されたチャネル間隔以上離します。
7. visual-language.mdの安定した色マッピングを適用します。常に色と信号ラベルをペアにします。

重要な配線変更のたびに scripts/validate_wiring.py を使用します。重複、意図しない交差、未接続の端点、隠れたラベル、無効な電気的接続はすべて不合格候補として扱います。

4. 再利用可能なSVGプリミティブから構築

1. プロジェクト固有のテンプレートがない場合は、wiring-a3-template.svgから開始します。
2. コンポーネント写真は assets/ またはプロジェクトのアセットディレクトリに保存し、相対パスで参照します。
3. 配線、端子、ラベル、コンポーネント、キープアウト領域に安定したIDと意味的な data-* 属性を付与します。svg-annotation-contract.mdに従います。
4. 配線は端子とテキストの下の専用レイヤーに配置します。ハローは配線を背景から分離するためだけに使用し、別の配線を隠すために使用しないでください。
5. 編集可能なSVGをソースとして保持します。PNG/PDFはレビュー用の派生アーティファクトとしてのみレンダリングします。

5. レイヤーによる検証

1. 構造的なSVG解析と配線バリデータを実行します。
2. 各ネットリストのエンドポイントが正確に1回存在し、各配線が宣言された両方のエンドポイントで終端していることを確認します。
3. 電源方向、電圧互換性、共通グランド、UARTクロスオーバー、バス固有の要件を確認します。
4. 実際に表示されている向きに対して物理番号を確認します。ピン1の指標や奇数/偶数の行を含みます。
5. 完全なシートと、変更された各コネクタのクローズアップをレンダリングします。
6. 意図した印刷サイズで検査します。ピン番号、信号名、ワード識別子、端点接点、警告は判読可能でなければなりません。
7. SVG編集のたびに再レンダリングします。ソース検査のみからの成功を報告しないでください。

scripts/render_svg.py を使用します。Codex Desktopでは、利用可能な場合はワークスペース依存関係をロードします。レンダラーは、PNG出力用にバンドルされたNode.jsとSharpランタイムも自動検出します。

完了を宣言する前に validation-gates.md を参照してください。既存の図面を修正する場合は failure-patterns.md を参照してください。

6. 真実の提供

• 要求された場合、編集可能なSVG、レンダリングされたPNG、PDFを提供します。
• 新しく追加または変更された接続の正確なピン間マッピングを記載します。
• どのピン配置が情報源によって検証され、どの前提が残っているかを記載します。
• 構造、電気、配線、視覚の各ゲートが合格した場合のみ completed を報告します。
• 信頼できるピン配置、電圧定格、コネクタの向き、嵌合面の解釈を確立できない場合は blocked を報告します。
• 視覚的に妥当な配線が電気的な正確性を証明するとは決して主張しないでください。