Kicad Studio Kit

KiCad Studio Kit は、VS Code 拡張機能のリポジトリです。MCP サーバーは 別途開発・リリースされています。このリポジトリが管理するのは、拡張機能側の MCP 検出、設定、互換性メタデータ、およびユーザーエクスペリエンスのみです。詳しくは、 ADR 0009 と リポジトリの構成をご覧ください。

KiCad Studio の PCB および回路図プレビューは、MCP に依存せず、外部ツールが 基礎となる設計ファイルを保存したときに自動更新できます。 ライブビューアーの更新では、 イベント駆動の動作、リソース制限、未保存の編集を保護する仕組み、および制限事項について説明しています。

カバレッジバッジが示すのは、設定された Jest の単体テストの分母であり、出荷されるすべての ソースファイルではありません。除外の管理と、重要モジュールに対する独立したラチェットについては、 テスト戦略に記載されています。

このリポジトリには、次のものが含まれています。

• KiCad Studio の VS Code 拡張機能（apps/vscode-extension）— ここでリリースされる唯一の製品です。
• 非公開の共有テスト基盤（packages/test-harness、packages/kicad-fixtures）。
• 拡張機能側の MCP 統合コントラクトと互換性メタデータ。 KiCad MCP Pro サーバー（kicad-mcp-pro）の Python ソース、npm ランチャー、 コンテナーイメージ、および MCP Registry の掲載情報は、 KiCad MCP Pro にあります。

リポジトリの成熟度と標準

OpenSSF Best Practices Silver の過去の実績（MIT ライセンス期間）： Silver のエビデンスは追跡可能性のために保存されており、 現在の FLOSS バッジとして提示されているわけではありません。ライセンスの移行後、 プロジェクトが作成したソースは PolyForm Noncommercial 1.0.0 の下で利用できます。このライセンスは OSI 承認のオープンソースライセンスではありません。セキュリティ、リリース、来歴、 ガバナンスのチェックは、過去のバッジの状態とは独立して引き続き実施されます。

バージョンの基準

このリポジトリのローカルなリリース対象は次のとおりです。

• VS Code 拡張機能：oaslananka.kicadstudiokit（2.1.1）

Python パッケージ kicad-mcp-pro、コンテナーイメージ、および MCP Registry の掲載情報は、 KiCad MCP Pro からリリースされます。

KiCad との互換性

KiCad Studio Kit では、KiCad 10.0.x を主なテスト対象とし、上流の EOL 後も KiCad 9.x との互換性を非推奨のベストエフォートとして維持し、KiCad 8.x との 互換性はファイルレベルに限って非推奨の状態で維持します。正式な互換性マトリックス、 テスト済みパッチバージョン、CI のカバレッジレベル、および機能ゲートは、 docs/support-matrix.md と compatibility.yaml で管理されています。

ローカルでの検証

corepack enable
corepack pnpm run dev:doctor
corepack pnpm install --frozen-lockfile
corepack pnpm --dir apps/vscode-extension exec playwright install chromium
corepack pnpm run check:forbidden-refs
corepack pnpm run check:version
corepack pnpm --filter kicadstudiokit run check
corepack pnpm --filter kicadstudiokit run package

製品別のエントリーポイントは、ルートから利用できます。

corepack pnpm run check:kicad-studio

corepack pnpm --dir packages/test-harness run check
corepack pnpm run check:protocol-schemas
corepack pnpm run check:compatibility-contract
corepack pnpm run check:dev-doctor

Python／MCP サーバーのチェックは、 KiCad MCP Pro リポジトリで実行します。

再現可能な VS Code Dev Containers または GitHub Codespaces 環境を使用するには、 チェックイン済みの開発コンテナー設定を使用してください。 このコンテナーは、ルートのチェックと MCP テスト用に、Node、pnpm、Python、uv、 Playwright、shellcheck、actionlint、GitHub CLI、およびベストエフォートの KiCad CLI サポートをセットアップします。コンテナーデーモンを使わず、最小権限の VPS を使用する場合は、 チェックイン済みのルートレス検証ホストプロファイルを使用してください。

インストール

Visual Studio Marketplace または Open VSX から拡張機能をインストールするか、 ローカルでビルドします。

corepack enable
corepack pnpm install --frozen-lockfile
corepack pnpm run package:kicad-studio

使用方法

KiCad プロジェクトを含むワークスペースを開き、KiCad Studio のアクティビティバーのビューと コマンドを使用します。手順に沿ったワークフローについては docs/getting-started.mdを、コマンド一覧については docs/extension/commands.mdを参照してください。

アーキテクチャ

• 検索可能なドキュメントサイト
• リポジトリ構成
• 製品の境界
• リリースモデル
• テスト戦略
• 開発コンテナー
• ルートレス検証ホスト
• KiCad フィクスチャコーパス
• 統合モデル
• エージェントのオンボーディング
• MCP クライアント設定の例
• VS Code MCP ワークスペースの例

例

• 例の概要
• LED Basic KiCad の例
• MCP ワークフローのデモ

公開

公開は、.github/workflows 以下の GitHub Actions ワークフローによって処理されます。 環境、マーケットプレイスのシークレット、信頼済み発行者に関する外部設定については、 docs/publishing.mdに記載されています。 安定版 1.x 系列向けの構造化プレビュー（ベータ）プログラムとテスターからのフィードバックループについては、 docs/beta-program.mdに記載されています。

メンテナンス

依存関係の更新ポリシー、ダッシュボードのトリアージ、セキュリティ更新への対応については、docs/dependency-lifecycle.md に記載されています。 互換性のサポート状況とリリースのゲートについては、docs/support-matrix.md に記載されています。 正規リポジトリとポートフォリオのワークフロー状況は、CANONICAL.md、.repo-health.yaml、docs/reusable-workflows.md に記録されています。 テレメトリとエラー報告はオプトイン方式で、デフォルトでは無効になっており、docs/telemetry.md に記載されています。

コントリビューション

プルリクエストを作成する前に、CONTRIBUTING.md を読み、corepack pnpm run check を実行してください。

ライセンス

KiCad Studio Kit の現行のプロジェクト作成ソースは、PolyForm Noncommercial License 1.0.0 の下で利用できます。商用利用には別途、書面によるライセンスが必要です。LICENSING.md と COMMERCIAL-LICENSING.md を参照してください。以前に MIT ライセンスで公開されたリビジョンは、公開時に適用された MIT の条件の下で引き続き利用できます。