メインコンテンツへ移動
AIチュートリアル

Claude CodeとCodex向けPCB Skillで発注可能な基板を作る

Claude CodeまたはCodex、EasyEDA Pro、ブラウザ自動化でPCB Skillをインストールして使う方法を解説します。要件定義、部品調達、基板の作成と配線、製造ファイルの独立検証、発注準備まで、エージェントが購入操作を行わないゲート付きワークフローを説明します。

約12分で読了
Claude CodeとCodex向けPCB Skillで発注可能な基板を作る

PCB Skillの機能

PCB Skillは、ハードウェアのアイデアを初期構想から、発注、はんだ付け、通電確認が可能なPCBまで導くエージェントスキルです。Claude Code desktopまたはCodex desktop上で動作し、MCPブリッジを介してEasyEDA Proを操作します。また、PCBメーカーや部品サプライヤーにすでにログインしているブラウザーを使用します。

このプロジェクトは、一般的なPCB理論の講座ではありません。代わりに、実際に起こりやすい不具合を検出するための、ゲート付きのエンジニアリングプロセスを提供します。たとえば、ソケットの向き違い、モジュール本体の下に隠れた部品、効果のないキープアウト、誤った幾何変換、古い検証入力、ひそかに失敗する監視スクリプトなどを検出します。

エージェントはカートを準備して支払い前のページまで移動できますが、注文の確定や支払いは一切行いません。最終的な購入操作は手動で行います。

設計原則

ワークフローは、次の3つの優先事項を中心に構成されています。

  • 費用対効果: 各部品の価格は、ライブのサプライヤーページから取得するか、明示的に見積もりとして表示します。部品表は、すでに所有している部品も考慮して調整されます。
  • 手作業での組み立て: 基板はあなた自身が組み立てることを前提に設計します。底面終端パッケージを避け、パッドにアクセスできる状態を保ち、はんだ接合部を閉じ込めない組み立て順序を検討します。
  • 無料試作: 初期スケッチの段階から、選択した無料試作の制約内に基板を収めます。最後にサイズ変更や簡略化を行うことはありません。

前提条件

スキルを使用する前に、必要なデスクトップアプリケーションとアカウントを準備してください。

  • Claude Code desktopまたはCodex desktop。
  • 必要なMCPブリッジを設定したEasyEDA Pro。
  • エージェント拡張機能をインストールした対応ブラウザー。
  • PCBメーカーと部品サプライヤーの有効なブラウザーセッション。
  • 任意: お使いのOSがブラウザー操作ごとに権限プロンプトを表示する場合は、承認ウォッチャー。

完全な環境チェックリストについては、リポジトリのセットアップガイドに従ってください。プラットフォーム別の承認ウォッチャー手順は、macOSおよびWindows向けに用意されています。

承認ウォッチャーの機能は意図的に制限されています。繰り返し表示される権限プロンプトを減らせる場合がありますが、カートや支払い操作には関与しません。

PCB Skillをインストールする

1. リポジトリをクローンする

git clone https://github.com/daishuge/pcb-skill.git

2. エージェントにインストールする

Claude Codeの場合は、スキルをClaudeのスキルディレクトリにコピーします。

cp -r pcb-skill/skills/pcb ~/.claude/skills/pcb

Codexの場合は、代わりにCodexのスキルディレクトリを使用します。

cp -r pcb-skill/skills/pcb ~/.codex/skills/pcb

3. EasyEDA ProとMCPを設定する

EasyEDA MCPのセットアップを完了してください。PCB SkillはEasyEDA Proを操作するためにこのブリッジに依存するため、基板の作業を始める前に接続を確認してください。

4. ブラウザーセッションを準備する

必要なエージェント拡張機能を備えたブラウザーを開き、利用するPCB製造サービスと部品サプライヤーにログインしてください。エージェントは認証情報を自ら扱わず、これらの既存セッションを通じて購入手続きを行います。詳しくはブラウザーログイン手順を参照してください。

PCBプロジェクトを開始する

スキルと連携機能の準備ができたら、具体的なハードウェアのアイデアをエージェントに伝えます。既知の電気的、機械的、製造上、予算上、在庫上の制約を含めてください。たとえば、次のように依頼できます。

ディスプレイモジュール用の、手はんだ付け可能なコントローラーボードを設計してください。
可能な限り、在庫にある部品を使用してください。
PCBメーカーの無料試作制限内に設計を収めてください。
基板を変更する可能性がある要件については、質問してください。
調達と製造の注文を準備しますが、支払い前に停止してください。

これは特別なコマンド構文ではありません。プロジェクトの目標と、PCB Skillが適用するよう設計されている範囲を実際的に伝える方法です。

4段階のワークフローに従う

フェーズ1: 構想を定義する

最初のフェーズでは、必須制約と任意の希望を分けます。必須制約には、コネクターの互換性、筐体寸法、必要な電源電圧、製造上の制限などがあります。任意の希望には、部品ブランド、コネクターの位置、オプション機能などがあります。

このフェーズは、異なる回答によって異なる基板が生まれる可能性のある質問を、エージェントがすべて尋ね終えた場合にのみ完了します。このゲートを急いで通過しないでください。ここで残した不確実性は、後で高額な手戻りにつながります。

フェーズ2: 回路図を作成し、部品を調達する

エージェントは回路図を作成し、価格付きの部品表を構築して、サプライヤーのカートを準備します。フェーズを承認する前に、ネットリストのアサーションが合格しなければなりません。

調達結果を慎重に確認してください。すべての価格は、ライブページでVERIFIED（検証済み）として確認されたものか、ESTIMATE（見積もり）として識別できる必要があります。費用計算では、部品表の各行を新規購入として扱うのではなく、在庫にある部品も考慮してください。

この段階では、電気的な値だけでなくパッケージの選択も確認します。このプロジェクトの組み立て方針では、パッドにアクセスしやすいパッケージを優先し、想定する手はんだ付け工程に適さないパッケージは避けます。

フェーズ3：基板を配置・配線し、レビューする

レイアウトフェーズでは、部品配置、配線、ベタ配置を完了したPCBを作成します。配置は、EDAツール上で単に合法と判定されればよいのではなく、配線可能でなければなりません。リポジトリには、実際のパッドからキープアウト領域を導出するユーティリティ、ビアレーンの特定、モジュール本体周辺のクリアランス確認を行うユーティリティが含まれています。

このフェーズでは、クリーンなデザインルールチェックと、敵対的レビューの成功が必要です。このレビューは読み取り専用で実行し、既存の値やステータス表示を信頼するのではなく、重要な測定値を再導出します。

フェーズ4：製造ファイルを検証し、購入を準備する

エージェントはGerberパッケージを生成し、それを作成したEDAソフトウェアとは独立して検証します。リポジトリの検証スクリプトは、Gerberの解析、クリアランスの全体確認、ドリル数、ネットリストのアサーション、3D干渉などを対象としています。

検証後、エージェントは製造と部品購入を準備し、支払い前のページまで進めることができます。最終的な価格、数量、配送の詳細、製造オプション、支払い操作を確認し、注文を手動で送信する前に最終判断する責任は、引き続きあなたにあります。

リポジトリのツールを理解する

  • skills/pcb/SKILL.md：エージェントのスキルと中核的な動作を定義します。
  • skills/pcb/references/：ワークフロー、レビュー、製造、調達、EDA-MCPの落とし穴、機械および3Dチェック、立ち上げに関するオンデマンドのガイダンスを収録しています。
  • scripts/placement/：パッドから導出したキープアウト領域、配線スペース、モジュール本体のクリアランスに関する配置チェックを提供します。
  • scripts/routing/：Specctra DSNおよびSESオートルーティングのチェーン、4状態ウォッチドッグ、レート下限の監視機能を含みます。
  • scripts/verify/：EasyEDAとは独立して、Gerber、クリアランス、ドリル、ネットリスト、干渉を検証します。
  • scripts/notify/：長時間の処理が無言のままにならないよう、進捗を中継します。
  • docs/case-study.md：参照基板で見つかった不具合を記録し、実際のコストを報告します。

信頼性を高める高度なヒント

レビューを始める前に終了条件を定義する

緑色の基板ビューや、問題がなさそうなレイアウトは、設計が正しいことの証明ではありません。各フェーズは、1回で完了する敵対的レビューで終えるべきです。レビューを始める前に終了条件を書き留めておきます。そうしないと、レビューが終わりのないループになる可能性があります。

意思決定に重要な主張を測定する

おそらくサポートされていないといった主張だけで、作業を進めるかどうかを決めてはいけません。フェーズを阻止または承認する主張には、証拠を求めます。どの値を直接測定し、どの値をその測定結果から計算したかを記録します。

検証ツールを較正する

チェッカーが正常に完了したからといって、正しいと仮定してはいけません。既知の非対称オブジェクトを使って、幾何変換を較正します。対称なテストオブジェクトでは、回転、反転、座標系の誤りが隠れてしまうことがあります。

長時間実行するジョブを可視化する

待機条件やログフィルターごとに、その時点でクラッシュした場合に目に見える行が出力されるかを確認します。PCB Skillにはウォッチドッグと通知コンポーネントが含まれています。プロセスが無言で実行されていると、停止したのか失敗したのかを見分けにくいためです。

ソース設計だけでなく、最終パッケージを検査する

アップロードする実際のGerberとドリルデータに対して、独立したチェックを実行します。これにより、エクスポートの問題、古いファイル、検証ツールが誤って現在の基板ではなく以前のリリースを読み込む問題から保護できます。

ケーススタディをレビューチェックリストとして使う

プロジェクトのケーススタディでは、このワークフローのきっかけとなった実際の不具合を説明しています。最初の設計を承認する前に確認し、抽象的なゲートを具体的な故障モードと結び付けられるようにします。

結論

PCB Skillは、要件、回路図の作成、調達、レイアウト、配線、製造検証、購入準備にまたがる、明示的でテスト可能なゲートの連続へとPCB開発を変えます。その主な価値は自動作図だけではなく、ツールとフェーズをまたいだ規律あるチェックにあります。Claude CodeまたはCodexにインストールし、EasyEDA MCPとブラウザーのセットアップを完了したうえで、最終的な購入操作はすべて手動で管理してください。