chip-specs

ChipCtx MCU 仕様

組み込み開発向けの信頼できる MCU チップ仕様の照会。 ChipCtx MCP Server を介して、チップのパラメーター、ピン定義、TRM レジスター、プログラミングガイドにリアルタイムでアクセスできます。

MCP サーバーのセットアップ（最初の照会前に必ず確認）

この Skill には ChipCtx MCP Server が必要です。チップに関する照会を行う前に、MCP ツールが利用可能であることを必ず確認してください。

ステップ 1：ツールの利用可否を確認

現在のセッションで chip_identify が MCP ツールとして利用可能か確認してください。利用可能な場合は、以下の標準照会フローに進んでください。

ステップ 2：自動インストール（ツールが利用できない場合）

chip_identify が利用できない場合は、次のいずれかの方法で MCP サーバーをインストールしてください。

オプション A — Claude Code Plugin（推奨、MCP を自動設定）： 次のコマンドを実行して再起動するよう、ユーザーに伝えてください：

/plugin marketplace add chipctx/skills
/plugin install chipctx@chipctx-marketplace

オプション B — MCP の手動セットアップ：

claude mcp add --transport http chipctx --scope user https://mcp.chipctx.com

ステップ 3：ユーザーに再起動を案内

インストールコマンドの実行後、ユーザーに次のように伝えてください：

ChipCtx MCP サーバーが設定されました。MCP ツールを利用可能にするには、Claude Code を再起動してください（/quit と入力してから再起動します）。その後、照会をもう一度お試しください。

重要： インストール後は、chip_identify やその他の ChipCtx MCP ツールを呼び出さないでください。セッションを再起動するまで利用できません。WebFetch やその他の代替手段に切り替えないでください。まずユーザーに必ず再起動してもらってください。

その他のエージェント

Cursor やその他のプラットフォームでの MCP 設定については、README を参照してください。

適用するタイミング

次のいずれかの条件を検出した場合、この Skill を有効にしてください。

1. 明示的な指定 — ユーザーがチップのモデル名に言及

• 特定のモデル：STM32F407VGT6、ESP32-S3-WROOM-1、nRF52840
• シリーズへの言及：「STM32F4 series」、「ESP32」、「nRF52」
• チップの検索または比較：「BLE と 1MB フラッシュを備えたチップはどれですか？」

2. コードコンテキスト — チップ固有のヘッダーまたは API

• ヘッダー：stm32f4xx.h、esp_system.h、nrf.h、nrf52840.h
• HAL/SDK 呼び出し：HAL_GPIO_Init()、esp_wifi_init()、nrf_gpio_cfg_output()
• チップ固有のレジスターまたはメモリーアドレスへの参照

3. プロジェクト設定 — ビルドシステムのファイル

• STM32CubeMX の .ioc ファイル
• board = ... を含む platformio.ini
• MCU 定義（-DSTM32F407xx）を含む Makefile/CMakeLists.txt
• ESP-IDF の sdkconfig、Zephyr の prj.conf

4. トピック関連 — ハードウェアに関する議論

• ピン割り当て、ペリフェラル設定、レジスター操作
• GPIO、UART、SPI、I2C、ADC、DMA、Timer に関するトピック
• データシート、TRM、またはハードウェア設計への言及

MCP インターフェースのクイックリファレンス

MCP サーバーのエンドポイント： https://mcp.chipctx.com（Streamable HTTP）

ユーザーの意図	MCP ツール	入力	出力
チップモデルを検索／特定	chip_identify	query (string)	id、model、vendor、series、matchScore を含むチップ一覧
チップのパラメーターと仕様	chip_specs	chipId, category?	コアパラメーター、電気的仕様、ペリフェラル一覧
ピン定義とパッケージ	chip_hardware	chipId, query?	AF マッピング付きピンテーブル、パッケージ情報
TRM レジスターとモジュール	chip_trm	chipId, section?	TRM セクション、レジスター／フィールド定義
プログラミングガイドとコード	chip_programming_guide	chipId, topic	初期化手順、コード例、注意点

重要な原則： chipId がすべての照会をつなぎます。必ず最初に chip_identify を呼び出して chipId を取得し、その後のすべてのツール呼び出しで使用してください。

意図別ルーティングマトリックス

ユーザーの照会に含まれるキーワード	呼び出すツール	優先度
モデル、シリーズ、検索、比較、特定	chip_identify	必ず最初に呼び出す
パラメーター、仕様、周波数、フラッシュ、RAM、機能	chip_specs	基本情報
ピン、GPIO、パッケージ、ピン配置、AF	chip_hardware	ハードウェア設計
レジスター、TRM、モジュール、アドレス、ビットフィールド	chip_trm	詳細な技術情報
コード、初期化、設定、プログラム、例、HAL	chip_programming_guide	プログラミング

標準的なクエリフロー

チップ関連のクエリはすべて、次のフローに従います。

Step 0: Verify chip_identify tool is available (see MCP Server Setup above)
        If NOT available -> auto-install and ask user to restart. STOP here.
Step 1: Extract chip model keywords from user input or project context
Step 2: chip_identify(query) -> validate model, get chipId
Step 3: Check matchScore -> confirm unique match or ask user to select
Step 4: Route to appropriate tool based on user intent
Step 5: Format and present results, generate code if requested

重要： セッション中、最初のチップクエリではステップ 0 が必須です。MCP ツールが見つからない場合は、先に進まず、インストールして再起動するよう依頼してください。ステップ 2 は決して省略しないでください。その他すべてのツールでは、chip_identify から取得した chipId が必要です。

ハードウェアを考慮した識別

チップ識別フローでは、プロジェクトのコンテキストから自動検出できます。

自動検出のソース：

• C/C++ ヘッダーのインクルード：#include "stm32f4xx.h" -> STM32F4 シリーズ
• Platform IO の設定：board = esp32-s3-devkitc-1 -> ESP32-S3
• CMake の定義：-DNRF52840_XXAA -> nRF52840
• STM32CubeMX の .ioc ファイル：プロジェクトのチップ設定

matchScore のしきい値：

• = 0.9：信頼度が高いため、そのまま進みます

• 0.7-0.9：信頼度は中程度のため、ユーザーに確認します
• < 0.7：信頼度が低いため、ユーザーが選択できるよう候補を提示します

複数候補の処理： 複数のチップが一致した場合は、モデル、ベンダー、説明を含む番号付きリストを提示します。ユーザーに選択を依頼してください。信頼度の低い候補を、ユーザーに知らせず選択してはいけません。

詳細なフローとエラー処理については、rules/flow-chip-identify.md を参照してください。

コンテキスト注入の方針

チップの識別後、仕様データを段階的に注入します。

レイヤー 1：常に注入（識別後）

• チップのモデル、ベンダー、シリーズ
• CPU コア（例：ARM Cortex-M4）、最大周波数
• フラッシュと RAM の容量、動作電圧

レイヤー 2：必要に応じて注入（周辺機器について話す場合）

• 周辺機器の仕様（UART の数、SPI の機能など）
• 特定の周辺機器のピン定義と代替機能
• パッケージ情報（ピン数、寸法）

レイヤー 3：詳細情報を注入（低レベルコードを記述する場合）

• TRM のレジスター定義（名前、アドレス、ビットフィールド、アクセス種別）
• 初期化シーケンスとコード例を含むプログラミングガイド
• HAL レベルとレジスターレベルの両方の実装

コンテキストの管理

• オーバーフローを防ぐ： チップデータを一度にすべて読み込まないでください。現在のタスクに必要なデータだけを読み込みます。
• 関連性を優先する： UART について話す場合は、すべての周辺機器ではなく、UART のデータを読み込みます。
• チップの切り替え： ユーザーが別のチップに切り替えた場合は、古いコンテキストを完全にクリアして、新しいチップのデータを読み込みます。異なるチップのデータを決して混在させないでください。

詳細な注入フローについては、rules/flow-context-inject.md を参照してください。

対応チップファミリー

ベンダー	シリーズ	モデル例
STMicroelectronics	STM32F0/F1/F2/F3/F4/F7/H7/L0/L1/L4/G0/G4/U5/WB/WL	STM32F407VGT6
Espressif	ESP32/ESP32-S2/S3/C3/C6/H2	ESP32-S3-WROOM-1
Nordic Semiconductor	nRF52810/832/833/840	nRF52840

ルールのカテゴリ

詳細なルールは、段階的に読み込めるよう rules/ に整理されています。

ファイル	影響度	説明
rules/flow-chip-identify.md	高	チップ識別のトリガー、5 ステップのフロー、matchScore の処理、エラーからの回復
rules/flow-context-inject.md	高	3 層の注入方針、コンテキストウィンドウの管理、チップ切り替えプロトコル
rules/api-chip-identify.md	高	chip_identify インターフェース：あいまい検索、エイリアス認識、応答形式
rules/api-chip-trm.md	高	chip_trm インターフェース：セクションのフィルタリング、Register/RegisterField のデータ形式
rules/api-chip-specs.md	中	chip_specs インターフェース：4 種類のカテゴリクエリ、上限値を含む電気的仕様
rules/api-chip-hardware.md	高	chip_hardware インターフェース：ピン／機能のフィルタリング、AF マッピング、パッケージ情報
rules/api-chip-programming.md	中	chip_programming_guide：SDK/HAL コード、初期化シーケンス、2 種類の実装

セクションインデックス： 読み込み順と方針については、rules/_sections.md を参照してください。

コンパイル済みドキュメント全体

すべてのルールを 1 つのファイルにまとめて使用するプラットフォーム向けには、Skill 内のすべてのルールファイルをまとめた AGENTS.md を参照してください。