kicad-layout

このスキルは、エージェントが適切なレイアウトを作成できるよう支援することを目的としています。エージェントが自らの欠点を理解し、通常は省略しがちなレイアウトの手順を完了するよう促します。GPT-6-Astra と claude-fable-5.1 向けに特化して作成されていますが、ほかのエージェントでも利用できます。人間の方向け：モデルやツールの性能が向上するにつれて、こうした内容の多くは不要な冗長さになっていきます。常に最新の状態に保ってください。

アクティブなボードをその場で編集する

通常の配置、配線、クリーンアップでは、プロジェクトルートの .backplane.json（project または明示的に指定された pcb）から正規のボードを特定し、そのパスを厳守してください。未完成の作業も含め、意味のある節目ごとに IPC の SaveDocument またはツールの --save を使って保存してください。最終ボードができるまで保存を待ってはいけません。保存したパスを読み戻し、viewer_show で正規ファイルを表示して、ビューアーと履歴がその保存済みファイルを参照していることを確認してください。不一致があれば報告してください。<native-filename>.backplane.json の付随ファイルと既存の履歴を保持してください。

バックアップと中間出力は、別のバックアップ／ビルドディレクトリに保管してください。ツールがステージングファイルを書き出す場合は、それを検証し、続行する前にバックアップを取って正規パスへ移してください。進捗をメモリ上だけに残したり、最終コピーだけに残したり、アクティブなファイル名を黙って変更したりしてはいけません。明示的に実験を依頼された場合に限り、代替ボードを使用し、実験用であることを明確に示してください。ボードへ書き込むエージェント／プロセスは常に1つだけにしてください。他のエージェントは、変更を確認したり、統合用の変更を準備したりできます。

• 各部品のフットプリントが適切であることを確認し、できるだけ品質の高い3Dモデルを用意してください。適切な3Dモデルが見つからない場合は、低精度でもよいので独自に作成してください。プロジェクトのライブラリ構成は維持しつつ、自己完結型のプロジェクトライブラリファイルを優先してください。
• KiCad IPC（系）のツールまたは kiPy を利用できる場合は、常にそれらを強く優先してください。
• 部品配置には、layout-placement スキルを使用してください。このスキルは、各接続が許容できる距離の短さに応じて部品を並べ替え、IPC スクリプトを使って部品の移動や距離・配線可能性の確認を行います。
• オートルーティングについては、特に指示がない限り、オートルーティングソフトウェアは使わず、手作業で配線してください。基板が複雑になり、ピッチの細かい部品や数千のネットを含むような場合は、オートルーティング、tscircuit、freerouting などを使用してもかまいません。ただし、可能な限り使用は避けてください。
• 特に指示がない限り、レイアウトをより論理的ですっきりしたものにするために、回路図を変更してもかまいません。ピンの入れ替えなどを行い、配線を短くし、レイヤーの切り替えを減らし、全体をきれいにしてください。ただし、ピンの入れ替えにはリスクが伴います。変更によってプロジェクトの目的や機能を損なわないよう、十分注意してください。また、回路図に新たな不具合を持ち込まないよう、細心の注意を払ってください。
• レイアウトについても同様に、特に指示がない限り、配線しやすく、完全に機能するボードになるまで、上位レベルの配置も変更してかまいません。
• 上記のすべてにおいて、レイアウトと配線のベストプラクティスを尊重してください。高レベルと低レベルそれぞれのベストプラクティスについて、必要性も踏まえて検討してください。少しでも迷った場合は、どの段階でも検討してください。悪い手法で配線したボードは、早く配線できても役に立ちません。こうした手法の多くはすでに理解しているはずなので、それに応じて合理的に対応してください。理論や手法に確信が持てない場合は、オンラインで調べてもかまいません。
• エージェントが見落としがちな、考慮すべき特定の概念／手法（すべてではありません）は、適切なビアスティッチング、同一平面のグラウンドがトレースのインピーダンスに与える影響、高周波で機能しない銅箔とそれを介した結合ノイズ、重要な信号すべてに対するクリーンなリターンパスなどです。状況に応じて判断してください。
• コネクターにアクセスできることを確認してください。どちら向きに外側を向くべきか、配線がどこを通るかを確認し、3Dモデル上にもそれが分かるようにしてください。必要に応じて簡易な3Dレンダリングも確認し、検証してください。
• レイアウトを進めてから気に入らない点に気づいた場合は、より高い視点から検討し、適切であれば一部またはほぼ全体をやり直してもかまいません。