bom

BOM 管理

BOM データは、唯一の信頼できる情報源として KiCad の回路図シンボルのプロパティに保存されています。このスキルは、回路図の分析、販売代理店の検索、部品の検証、プロパティの書き戻し、管理用 CSV のエクスポート、発注ファイルの生成まで、ライフサイクル全体を調整します。

関連スキル

スキル	目的
kicad	回路図、PCB、フットプリントの読み取り・分析
digikey	DigiKey の検索、データシートのダウンロード（試作の主な調達先）
mouser	Mouser の検索（試作の第 2 調達先）
lcsc	LCSC の検索（量産／JLCPCB 用部品）
element14	Newark／Farnell／element14 の検索（海外向け）
jlcpcb	PCB 製造・実装の発注
pcbway	PCB 製造・実装の代替サービス

スクリプト

BOM スキルのディレクトリを参照するには、<skill-path> を使用します。

# Analyze schematic (JSON output, recursive sub-sheets)
python3 <skill-path>/scripts/bom_manager.py analyze path/to/schematic.kicad_sch --json --recursive

# Export BOM tracking CSV (creates new or merges with existing)
python3 <skill-path>/scripts/bom_manager.py export path/to/schematic.kicad_sch -o bom/bom.csv --recursive

# Generate per-distributor order files (5 boards + 2 spares/line)
python3 <skill-path>/scripts/bom_manager.py order bom/bom.csv --boards 5 --spares 2

# Quick single-distributor order (bypasses Chosen_Distributor column)
python3 <skill-path>/scripts/bom_manager.py order bom/bom.csv --distributor digikey

# Write properties to schematic (dry-run first, then apply)
echo '{"R1": {"MPN": "RC0805FR-0710KL", "Manufacturer": "Yageo"}}' \
  | python3 <skill-path>/scripts/edit_properties.py path/to/schematic.kicad_sch --dry-run

# Sync datasheet URLs from manifest.json back into schematic Datasheet properties
python3 <skill-path>/scripts/sync_datasheet_urls.py path/to/schematic.kicad_sch --recursive --dry-run

# Translate KiCad/Altium BOM and CPL files into JLCPCB upload format
# (`pnp --bom` filter drops orphan designators — see skills/jlcpcb/SKILL.md
# for the 3-step PCBA upload workflow)
python3 <skill-path>/scripts/translate_bom_pnp.py bom input_bom.csv -o jlc_bom.csv
python3 <skill-path>/scripts/translate_bom_pnp.py pnp input_cpl.csv -o jlc_cpl.csv --bom jlc_bom.csv

ワークフロー

該当しない手順は省略してください。よくあるショートカット：

• 「Mouser の PN を追加」 — 各部品の MPN で Mouser を検索 → 検証 → 回路図に書き込み → CSV を更新
• 「不足を埋める」 — --gaps-only を指定してアナライザーを実行し、不足している各フィールドに対応
• 「データシート URL を更新」 — sync_datasheet_urls.py を実行し、データシートのマニフェストから空の Datasheet フィールドを補完
• 「量産に向けて準備」 — すべての部品に LCSC 番号があることを確認し、在庫を確認して、Chosen_Distributor を LCSC に設定

Step 1: プロジェクトを把握する

python3 <skill-path>/scripts/bom_manager.py analyze path/to/schematic.kicad_sch --json --recursive

出力から、プロジェクトのフィールド命名規則、登録済みの販売代理店、不足項目、優先する販売代理店がわかります。また、プロジェクトディレクトリまたは bom/ フォルダーに既存の BOM 管理用 CSV がないか確認してください。

このスクリプトは一般的なパターンに対応していますが、プロジェクトによっては内部キーシステムやパラメトリックフィールドを使っている場合があります。全項目の一覧は references/part-number-conventions.md を参照してください。何かおかしいと感じたら、回路図を読んで確認してください。

Step 2: データシートを同期する

すぐに実行してください。 データシートは、検証や部品選定に欠かせない情報です。まず優先する販売代理店の同期を実行し、一部失敗した場合はほかの販売代理店も試してください。各スクリプトは同じ datasheets/ ディレクトリを共有しており、ダウンロード済みの部品はスキップします。

python3 <digikey-skill-path>/scripts/sync_datasheets_digikey.py path/to/schematic.kicad_sch --recursive
python3 <lcsc-skill-path>/scripts/sync_datasheets_lcsc.py path/to/schematic.kicad_sch --recursive
python3 <element14-skill-path>/scripts/sync_datasheets_element14.py path/to/schematic.kicad_sch --recursive

DigiKey が最適です（直接 PDF URL を取得できます）。element14 も信頼性があります（ボット対策がありません）。LCSC は LCSC 専用部品に使用できます。Mouser は最後の手段です（ダウンロードがブロックされることがよくあります）。

データシートの保存場所をユーザーに伝えてください（例：hardware/<project>/datasheets/）。ユーザーは頻繁に参照します。

複数リビジョンのプロジェクト： リビジョンごとに分けず、プロジェクトレベルで共通のデータシートディレクトリを 1 つ使用してください。同じ MPN のデータシートは、リビジョン間で変わりません。

新しい MPN を書き込んだ後（Step 5）に再同期してください。スクリプトは冪等です。その後、Datasheet URL を回路図に反映します。

python3 <skill-path>/scripts/sync_datasheet_urls.py path/to/schematic.kicad_sch --recursive

このスクリプトは datasheets/manifest.json（旧名の index.json にも対応）を読み込み、見つかったデータシート URL を、回路図の空の Datasheet プロパティに書き込みます。空欄のみを補完します。回路図にすでに別の URL が設定されている場合は上書きせず、不一致を警告します（置き換える場合は --overwrite を使用してください）。まず --dry-run を指定してプレビューしてください。

Step 3: 部品情報を収集する

カンマ区切りの MPN に注意してください。 一部のシンボルは複数の物理部品（例：電池ホルダー＋クリップ）を記録しています。カンマで分割し、各 MPN を個別に検索してください。結合した文字列で検索すると、別の製品が一致します。

利用できる情報に応じた検索方法：

• MPN がある → MPN で販売代理店を検索し、各社の PN と在庫を取得
• 販売代理店の PN はあるが MPN がない → その販売代理店を検索して MPN を取得し、続けてほかの販売代理店を検索
• Value と Footprint のみがある → 説明で検索（例：「100nF 0402 X7R 16V」）

まずプロジェクトで優先する販売代理店を使い、次に代替先を使います。試作：DigiKey が主、Mouser が第 2 調達先。量産：LCSC。

Step 4: 一致する部品を検証する

既存の PN が正しいと思い込まないでください — 販売代理店の PN は古くなることがあります（製造中止、番号変更など）。既存の PN が API で解決できることを確認してください。PN が 404 を返す場合は、置き換え対象としてフラグを立ててください。

一致する部品ごとに、次の項目を確認してください。

1. パッケージが回路図のフットプリントと一致している（下記の相互参照表を参照）
2. 仕様が一致している（静電容量、抵抗、電圧、許容差）
3. 説明が妥当である（抵抗器のリファレンスには抵抗器が対応している）
4. ライフサイクル — 廃番または EOL ではない
5. データシート URL が PDF への直接リンクである（製品ページではない）

判断が難しい場合は、ユーザーに確認してください。部品の誤りは、部品がないよりも深刻です。

Step 5: 回路図を更新する

KiCad との共存。 スクリプトは KiCad のロックファイルを検出して警告しますが、処理は続行します。KiCad は外部変更を自動検出しないため、メモリ上のコピーを保持します。KiCad が開いている場合は、次のようにユーザーに伝えてください。「変更を反映するには、回路図を閉じて再度開いてください（File → Open Recent）。先に KiCad から保存しないでください。」

KiCad に未保存の作業がある場合は、先に保存するよう依頼してください（Ctrl+S）。その後、スクリプトを実行してから再度開きます。

echo '{"R1": {"MPN": "RC0805FR-0710KL", "Manufacturer": "Yageo", "DigiKey": "311-10.0KCRCT-ND"}}' \
  | python3 <skill-path>/scripts/edit_properties.py path/to/schematic.kicad_sch

バックアップ： デフォルトでは .bak ファイルは作成されません（変更は git で追跡されます）。回路図が git リポジトリにない場合や、ユーザーが保持したい未コミットの変更がある場合は、--backup を指定してください。

プロジェクトの規約に従ってください。 "Digi-Key_PN" が存在する場合は "DigiKey" ではなく、そちらに書き込んでください。新規プロジェクトでのみ正規の名前を使用します。

MPN と併せて、必ず Manufacturer も書き込んでください — すべての API で取得でき、追加費用のかからないデータです。

Step 6: BOM 管理 CSV を更新する

python3 <skill-path>/scripts/bom_manager.py export path/to/schematic.kicad_sch -o bom/bom.csv --recursive

CSV の列は動的です — プロジェクトが使用する販売代理店の列のみが追加されます。基本列は Reference、Qty、Value、Footprint、MPN、Manufacturer です。使用中の販売代理店ごとに PN 列と在庫列が追加されます。末尾の列は Chosen_Distributor、Datasheet、Validated、DNP、Notes です。

Notes 列は、初回のエクスポート時に回路図の BOM Comments プロパティ（または Notes、Remarks、Ordering Notes などの別名）から値が設定されます。再エクスポート時は CSV 内のユーザー編集が優先されます。既存の Notes の値は保持され、回路図由来のコメントで上書きされることはありません。

マージの動作： 再エクスポートでは、ユーザー管理列（stock、Chosen_Distributor、Validated、Notes）を保持しながら、回路図由来の列を更新します。

Step 7: 在庫を確認する

販売代理店の PN がある各部品について、該当する販売代理店のスキルを使って現在の在庫を照会してください。CSV の在庫列を更新します。在庫データは古くなるため、日付を記録し、発注前に再確認してください。

選択した販売代理店の在庫がない場合は、その旨を示し、代替の販売代理店を提案してください。

Step 8: 選択する販売代理店を設定する

検討要素：在庫状況、発注数量での価格、最小注文数／注文単位、リードタイム、配送の集約（販売代理店が少ないほど配送回数も少なくなります）。

試作では、1〜2 社の販売代理店（DigiKey + Mouser）に集約してください。量産では、LCSC/JLCPCB が最も安価です。

Step 9: データシートと URL を再同期する

Step 2（ダウンロードと URL の補完）を再実行し、Step 3〜5 で追加された部品を取得してください。すでにダウンロード済みのファイルはスキップされるため、すぐに完了します。

Step 10: 設計と照らし合わせてデータシートを検証する

ダウンロードしたデータシートを読み、部品が回路に対して機能的に適切かを確認してください。これにより、Step 4 では見逃す可能性のある部品番号の誤りを検出できます。

種類別の確認項目：

• 受動部品 — 電源レール電圧に対する定格電圧、温度係数、消費電力
• レギュレーター — Vin の範囲、Vout、最大電流、静止電流
• MCU/IC — 電源電圧、I/O レベル、周辺機能、ピン配置
• コネクター — ピン数、ピッチ、電流／電圧定格
• MOSFET — Vds、Rds(on)、ゲートしきい値、熱損失
• ダイオード — Vf、Vr、電流定格、逆回復時間

大規模な BOM（部品 50 点以上）では、電源部品、重要な信号経路、ユーザーが指定した部品を重点的に確認してください。一般的な受動部品は、通常、詳細なレビューは不要です。

ステップ 11：注文ファイルを生成する

まだ分かっていない場合は、ボードの枚数を確認します。これにより、--boards の乗数が設定されます。

事前確認： 欠落がないこと、CSVが最新であること、Chosen_Distributorが設定されていること（または --distributor フラグを使用すること）、在庫情報が最新であることを確認します。

# Using Chosen_Distributor column, 5 boards + 2 spares
python3 <skill-path>/scripts/bom_manager.py order bom/bom.csv -o bom/orders/ --boards 5 --spares 2

# Or quick single-distributor order
python3 <skill-path>/scripts/bom_manager.py order bom/bom.csv --distributor digikey

--boards はすべての数量に乗算されます。--spares は乗算後、各行に一律の追加数量を加えます。--distributor は Chosen_Distributor を迂回し、その販売代理店のPNがある部品すべての注文を生成します。

カンマ区切りのPN（アクセサリー）は、自動的に分割されて別々の注文行になります。DNP部品は除外されます。スクリプトは、正しいアップロード形式で販売代理店ごとに1つのファイルを生成します（形式の詳細は references/ordering-and-fabrication.md を参照してください）。

注文の概要を提示し、注文前にユーザーが確認・編集できるようにします。

コスト見積もり： 注文ファイルの生成後、販売代理店のAPIに注文数量で価格を問い合わせ、販売代理店ごとの合計金額を提示します。コスト概要のテンプレートは references/ordering-and-fabrication.md を参照してください。

BOMの特殊ケースとコンポーネントごとの注記

実際のプロジェクトには、標準フィールドにすっきり収まらないBOM特有の事情があります。設計から発注までの間に見落とされがちな情報です。たとえば、試作専用のコネクター、2枚のボードで共用するケーブル、特定のベンダーロットから注文する必要がある部品などです。BOMの分析中は、こうした情報を積極的に探してください。ユーザーから言及されるのを待ってはいけません。

BOM Commentsフィールド

BOM Comments シンボルプロパティ（標準名）には、コンポーネントごとの自由形式の注記を記録します。この情報は、エクスポートしたCSVの Notes 列に反映されます。スクリプトは、BOM Notes、Ordering Notes、Assembly Notes、Notes、Remarks、Comment や、アンダースコア／スペースの有無が異なる別名も認識します。

BOM Commentsの追加を提案するケース：

• コンポーネントが試作専用（量産時はDNP、またはその逆）
• コンポーネントに発注上の制約がある（最低注文数量、長いリードタイム、特定のベンダーロット）
• コンポーネントを別のボードと共用している（リボンケーブル、接続相手のコネクター、共用ハーネス）
• コンポーネントに組み立て上の注記がある（向きが重要、手はんだ付けのみ、リフロー後に実装）
• コンポーネントに代替品のルールがある（使用可能な代替品、ピン互換の置き換え）
• 実装条件がある（製品バリエーション／SKUごとに値が異なる）

記入例：

"Proto only — DNP in production"
"Shares ribbon cable with power board — don't double-order"
"Must be Murata GRM series, no substitution (validated for EMI)"
"Hand-solder after reflow — temperature sensitive"
"Order 10% extra — fragile QFN rework difficult"
"Use 10K for rev A, 4.7K for rev B"
"Mating connector: Molex 39-01-2040 on cable side"

BOMの特殊な事情を探すその他の場所

コンポーネントごとの注記には回路図シンボルのプロパティが最適ですが、プロジェクト内の情報はさまざまな場所に散在しています。以下をすべて確認してください。

1. 回路図上のテキスト注釈 — 回路図シートに配置された自由形式のテキストです。kicad スキルのアナライザーは、これらを text_annotations として抽出します。発注、組み立て、バリエーションに関する、コンポーネント付近の注記を探してください。

2. タイトルブロックのコメント — タイトルブロックには番号付きのコメントフィールドがあります。ボード全体に関わるBOM注記（「特記がない限り、すべての受動部品は0402」「試作用はDigiKeyから注文」など）に使われることがあります。

3. プロジェクトのREADME／ドキュメント — README.md、docs/、bom/README.md、または部品、発注、組み立てに言及しているテキストファイルを探してください。最も上位のBOM判断が記載されていることがよくあります。

4. 既存のBOM CSVのNotes列 — bom.csv がすでにある場合は、Notes列を読んでください。回路図にはない注記をユーザーが追加していることがあります。

5. プロジェクトレベルの設定（.kicad-happy.json） — preferred_suppliers は調達先の優先順位を設定し、bom セクションはフィールド名とグループ化の規則を設定します。スキーマ全体については skills/kicad/references/config-reference.md を参照してください。

6. 回路図シンボルのDescriptionフィールド — 部品の説明ではなく、組み立て上の注記（例：「100nFのバイパスコンデンサー — U3の4番ピンの近くに配置」）に使われることがあります。

7. 標準外の名前を持つKiCadカスタムフィールド — Assembly、Order、Variant、Config、SKU などのフィールドに、BOMに関係する情報が含まれている場合があります。アナライザーはこれらを unrecognized_fields として通知します。

8. 理由が記載されていないDNP — DNPコンポーネントには、なぜ DNPなのか、いつ 実装するのかを記す注記が必要な場合があります。KiCadのDNPフラグは真偽値のため、その理由はBOM Commentsに記載します。

複数基板／システムレベルのBOMに関する注意事項

プロジェクトに複数の基板（例：メイン基板＋子基板、または送信機＋受信機）がある場合：

• 共用ケーブル／コネクター — どのコネクター同士を接続するかを両方の基板に記載し、基板間で共用するケーブルには「二重に注文しない」旨を記載します
• 共用電源 — 基板間でPSUを共用する場合は、どちらの基板のBOMに含めるかを記載します
• 基板間で共通の部品 — 注文時に、基板間で数量を合算します。共用部品を各基板のBOMに記載します
• 基板固有のバリエーション — 同じPCBを異なる部品実装オプションで使用する場合（例：出力電圧ごとに異なる抵抗値を使う場合）、BOMのコメントにバリエーションのルールを記載します

BOM対象外の項目

プロジェクト固有の項目には、回路図には記載されていないものの、BOMとあわせて注文が必要なものがあります。よく忘れられる項目：

• 接続相手側のコネクターとケーブル — 回路図にコネクターがある場合、もう一方の部品も注文する必要があります（基板間接続、リボンケーブル、ワイヤーハーネス）
• ステンシル — PCBとあわせてフレーム付きステンシルを注文します（JLCPCB／PCBWayから約$7）
• プログラミング／デバッグ用アダプター — Tag-Connectケーブル、SWDリボンケーブル、基板のデバッグコネクター用の専用USBケーブル
• アンテナケーブル — 基板にRFコネクターがある場合は、U.FL-SMAピッグテールケーブル
• 取り付け用ハードウェア — 筐体に合わせたスペーサー、ネジ、ナット
• 熱管理部品 — 特定の部品向けのヒートシンク、サーマルパッド

これらは、Reference = -- とメモを設定したBOM CSVの行として記録するか、別ファイルの bom/non-bom-items.csv に記録します。コスト見積もりでは、これらを別項目として記載します。

BOMコメントの提示

レポートや注文概要を作成するときは、BOMコメントを常に目立つように表示してください。コメントには、例外や注意点について設計者の意図が記されています。埋もれさせないでください。注文概要では、BOMコメントのある部品をメインの表の後に個別に一覧表示し、ユーザーが「注文」をクリックする前に確認できるようにします。

パッケージ／フットプリント対応表

インペリアル	メートル法	KiCadフットプリント
0201	0603	R_0201_0603Metric
0402	1005	R_0402_1005Metric
0603	1608	R_0603_1608Metric
0805	2012	R_0805_2012Metric
1206	3216	R_1206_3216Metric

必要に応じて、R_ を C_ または L_ に置き換えます。Resistor_SMD:、Capacitor_SMD: などを先頭に付けます。

BOMの差分比較

リビジョン間で回路図が変更された場合は、旧BOMと新BOMを比較して、追加、削除、変更された部品を特定します。新たに調達が必要な部品を強調表示します。

インタラクティブBOM（ibom）

PCB上の部品位置を示すHTMLページを生成します。手作業での組み立てに不可欠です。

pip install InteractiveHtmlBom
generate_interactive_bom board.kicad_pcb \
  --dest-dir bom/ --name-format "%f_ibom_%r" \
  --extra-fields "MPN,Manufacturer,DigiKey,Mouser,LCSC" \
  --group-fields "Value,Footprint,MPN" \
  --checkboxes "Sourced,Placed" --dnp-field "DNP" --no-browser

参考ファイル

詳細な検索データが必要な場合は、以下を参照してください。

• references/kicad-fields.md — フィールド定義、別名、S式形式、部品番号のパターン
• references/ordering-and-fabrication.md — 販売代理店向け貼り付け形式、ガーバー出力、CPL、コストテンプレート
• references/part-number-conventions.md — 56件以上の実プロジェクトにおける命名パターンの詳細な分析

製造準備チェックリスト

• すべての部品にMPNとLCSC番号（JLCPCB向け）、またはMPN（PCBWay向け）がある
• 廃止部品やEOL部品がない
• 在庫を確認し、基本部品と拡張部品を識別した
• BOMとCPLを正しい形式で出力した
• ガーバーデータを出力して検証した
• デザインルールがメーカーの最小要件を満たしている（jlcpcb または pcbway スキルを参照）
• 試作品のテストがすべて完了した

生成ファイルとクリーンアップ

BOMスキルと販売代理店スキルは、プロジェクトツリーにファイルを作成します。クリーンアップしたり .gitignore に追加したりできるよう、それらがどのようなファイルか把握しておきましょう。

プロジェクトディレクトリに作成されるファイル

ファイル/ディレクトリ	作成元	目的	git に保持するか？
datasheets/	DigiKey、LCSC、element14、Mouser の同期スクリプト	ダウンロードされた PDF データシート	いいえ — 大きなバイナリであり、再ダウンロード可能
datasheets/manifest.json	データシート同期スクリプト	MPN ごとのダウンロード状況を追跡（旧名称: index.json）	いいえ — 同期によって再生成される
bom/bom.csv	bom_manager.py export	BOM トラッキング用スプレッドシート	はい — ユーザーが管理するデータ
bom/orders/*.csv	bom_manager.py order	販売代理店ごとの注文アップロードファイル	いいえ — 各注文の前に再生成される
*.YYYYMMDD_HHMMSS.bak	edit_properties.py --backup	編集前の回路図バックアップ	いいえ — 代わりに git を使用してください

kicad スキルは、ユーザーが選択したファイル名でアナライザーの JSON およびデザインレビューの Markdown レポートも作成します。追跡とクリーンアップのガイダンスについては、同スキルの「生成されるファイル」セクションを参照してください。

一時ファイル（プロジェクト外）

ファイル	場所	目的
digikey_token_cache.json	システムの一時ディレクトリ	OAuth トークンキャッシュ（TTL 9 分、モード 0600）
manifest.tmp	datasheets/	アトミック書き込みのステージング — manifest.json にリネームされ、永続化されることはありません

クリーンアップコマンド

# Remove downloaded datasheets (re-downloadable)
rm -rf datasheets/

# Remove order files (regenerate before ordering)
rm -rf bom/orders/

# Remove schematic backups
rm -f *.bak

# Remove KiCad analyzer/report files (filenames vary — check project instructions file)

.gitignore への追加推奨項目

# BOM skill working files
datasheets/
bom/orders/
*.bak

bom/bom.csv は追跡対象のままにしてください — 回路図だけからは再生成できない、ユーザーが管理するデータ（Chosen_Distributor、Validated、Notes）が含まれています。

ヒント

• MPN は万能のキー — まずこれを入力してください。すべての相互参照が可能になります
• 回路図が信頼できる情報源 — すべての BOM データはシンボルプロパティにあり、必要に応じてエクスポートされます
• 試作には DigiKey が第一、Mouser が第二。量産には LCSC
• CSV ラウンドトリップ — 一括更新には Edit Symbol Fields > Export/Import CSV を使用
• フィールド名テンプレート（KiCad 9+）— MPN、Manufacturer、LCSC、DigiKey、Mouser を事前定義
• DigiKey トークンの再利用 — TTL 9 分で一時ファイルにキャッシュされます。呼び出しごとに再認証する必要はありません
• セカンドソース — 重要な部品には AltMPN フィールドを使用
• 目標数量での価格 — 試作価格 ≠ 量産価格
• BOM コメント — 標準フィールドに収まらない発注・組立上の注意点には、BOM Comments シンボルプロパティを使用してください。CSV の Notes 列に反映されます。散在する BOM 情報については、回路図のテキスト注釈、README、既存の CSV ノートも確認してください。