Scandit

Scandit SDK 向けエージェントスキル

Scandit Data Capture SDK を統合するための AI エージェントスキルです。

各スキルは製品とフレームワーク（例：SparkScan iOS）に特化しており、推奨される統合コード、最新のセットアップ手順、権限設定とライセンスキーの組み込み、よく使われるカスタマイズのレシピ（モード、コールバック、UI の調整）、移行ガイダンス、SDK のバージョンアップグレード、さらに一部の製品ではサードパーティ製スキャナーの置き換え手順をまとめています。これらはすべて Scandit の公式ドキュメントに基づいています。一度インストールすれば、ドキュメントの抜粋を AI エディターに貼り付ける代わりに、エージェントに機能を依頼するだけで使えます。

インストール

プラグインをインストールします。コマンドを 1 つ実行するだけで、エージェントが 86 個すべてのスキルを利用できます。

npx [email protected] add scandit/skills

利用中のコーディングエージェントを検出し、それぞれにインストールします。最新のスキルを取得するには、同じコマンドを再実行してください。

または、エージェント独自のマーケットプレイスからインストールしてください。

エージェント	インストール	更新
Codex / ChatGPT App	ワンクリックでインストール、またはプラグインディレクトリで Scandit SDK を検索	Scandit が新しいディレクトリバージョンを公開したとき
Claude Code	/plugin install scandit-sdk@claude-plugins-official、または /plugin → Discover で Scandit SDK を検索	Scandit のリリースごとに自動更新
Cursor	ワンクリックでインストール、またはエディターで /add-plugin scandit-sdk	Scandit のリリースごとに自動更新
Codex CLI	codex plugin marketplace add scandit/skills codex plugin add scandit-sdk@scandit-plugins	codex plugin marketplace upgrade scandit-plugins
Copilot CLI	copilot plugin marketplace add scandit/skills copilot plugin install scandit-sdk@scandit-plugins	copilot plugin update scandit-sdk
その他すべて	npx [email protected] add scandit/skills	npx [email protected] add scandit/skills を再実行

スキルを 1 つだけ使いたい場合は？ エージェントはプロンプトに必要なスキルだけを読み込むため、全スキルをまとめてインストールする方法がおすすめです。npx [email protected] add scandit/skills を一度実行するだけで済みます。

使い方

やりたいことを自然な言葉で説明してください。エージェントが適切なスキルを自動で読み込みます。または、タスクに続けて /skill-name を指定すれば、スキルを明示的に呼び出せます。

必要な Scandit 製品がわからない場合は？ data-capture-sdk から始めてください。これは統合スキルではなくアドバイザーです。ワークフローについていくつか質問し、適切な製品を提案してから、お使いのプラットフォームに合った実装スキルに引き継ぎます。アプリの説明や、スキャン機能を追加したい画面のスクリーンショット、読み取りたいラベル、パッケージ、ID の写真を添付してください。

/data-capture-sdk I need to scan barcodes in a warehouse picking app - which Scandit product should I use?
/data-capture-sdk here is a photo of the labels we want to capture - what fits best?

製品がすでに決まっている場合は？ 対応するスキルを直接使ってください。

/sparkscan-ios add a barcode scanner to the home screen of my app
/label-capture-web capture the expiry date and lot number from these pharmacy labels

移行する場合は？ ほとんどの実装スキルには、初回統合の手順に加えてバージョン移行のガイダンスが含まれています。Barcode Capture、SparkScan、MatrixScan Batch の各スキルには、サードパーティ製スキャナーを置き換えるためのガイドもあります。

/barcode-capture-android migrate this app from the Scandit SDK v6 API to v8
/matrixscan-batch-web we use BarcodeTracking, move us to BarcodeBatch
/sparkscan-android replace our current third-party barcode scanner with SparkScan

ライセンスキー

これらのスキルは統合コードを作成しますが、ライセンスキー自体は発行しません。その処理はScandit MCP サーバーが担います。スキル（npx [email protected] add scandit/skills）とあわせて接続（claude mcp add --transport http scandit https://ssl.scandit.com/mcp）すると、各実装スキルの ## Licence key セクションでトライアルキーを取得し、アプリ内のライセンスキー呼び出しに書き込みます。チャットにはマスクされたプレビューのみが表示されます。スキルがマシン上のキーを探すことはありません。キーは MCP サーバーから取得するか、ユーザー自身が提供します。キーはソースコードにそのまま書き込まれるため、トライアル以外のキーはバージョン管理に含めないでください。

この方法で発行されるキーはトライアルキーのみです。また、MCP サーバーの認証はブラウザーを使うため、ヘッドレス環境や CI では動作しません。MCP サーバーを利用できない場合でも、https://ssl.scandit.com のダッシュボードを使う方法は引き続き利用できます。すべてのスキルがそちらの方法に切り替わります。

プライバシー

スキル自体が外部にデータを送信することはありません。同梱の Scandit MCP サーバー（https://ssl.scandit.com/mcp）は、トライアル用ライセンスキーを発行するためにお客様の Scandit アカウントと通信します。Scandit のプライバシーポリシーは https://www.scandit.com/privacy/ をご覧ください。

利用可能なスキル

スキル	説明
data-capture-sdk	製品選定アドバイザー — ユースケースに適した Scandit 製品を推奨し、対応する実装スキルに引き継ぎます。
sparkscan-{framework}	SparkScan の統合と移行。android、ios、web、cordova、capacitor、flutter、rn（React Native）、kmp（Kotlin Multiplatform）で利用できます。
barcode-capture-{framework}	BarcodeCapture（単一バーコードのスキャン）の統合と移行 — BarcodeCaptureSettings、リスナーの接続、DataCaptureView と BarcodeCaptureOverlay、カメラのライフサイクルに加え、6→7 および 7→8 の変更点。android、ios、web、cordova、capacitor、flutter、rn（React Native）、kmp（Kotlin Multiplatform）で利用できます。
barcode-selection-kmp	Barcode Selection（タップまたは照準で複数のバーコードから 1 つを選択）の統合 — 選択タイプと戦略、セッションカウント、基本オーバーレイのブラシ。kmp（Kotlin Multiplatform）で利用できます。
matrixscan-ar-{framework}	MatrixScan AR（Barcode AR）の統合と BarcodeBatch から BarcodeAr への移行。android、web、cordova、capacitor、flutter、rn（React Native）、kmp（Kotlin Multiplatform）で利用できます。
matrixscan-count-{framework}	MatrixScan Count（BarcodeCount）の統合 — リストに基づくカウント、ステータスオーバーレイ、キャプチャリストおよびリスト外のワークフローに加え、7.6 より前から 7.6 へのコンストラクター移行。cordova、capacitor、flutter、rn（React Native）、kmp（Kotlin Multiplatform）で利用できます。
matrixscan-count-{framework}	MatrixScan Count（BarcodeCount）のネイティブ統合 — 組み込みの AR カウント UI を使った一括カウント、明示的に管理するカメラのライフサイクル、ハイライトのカスタマイズ（Icon／Dot スタイル）、ステータスモード、クラスタリング、キャプチャリストに基づくスキャン（進捗、リスト外の項目の承認／拒否）。ios、android で利用できます。
matrixscan-batch-{framework}	MatrixScan Batch（旧 BarcodeTracking）の統合 — トラッキングセッション、基本オーバーレイのブラシ、高度なオーバーレイによるバーコードごとの AR 注釈。android、ios、web、cordova、capacitor、flutter、rn（React Native）、kmp（Kotlin Multiplatform）で利用できます。
matrixscan-find-kmp	MatrixScan Find（BarcodeFind）の統合 — 商品リストに基づく検索と発見、発見した商品の処理、バーコードトランスフォーマー、AR 検索ビュー。kmp（Kotlin Multiplatform）で利用できます。
matrixscan-pick-{framework}	MatrixScan Pick（BarcodePick）の統合 — 商品と数量のリストに基づくガイド付きピッキング、スキャンしたバーコードと商品データベースの照合に加え、ハイライトのスタイル設定。ios、kmp（Kotlin Multiplatform）で利用できます。
label-capture-{framework}	Smart Label Capture の統合と移行（正規表現の名前変更 v7.6→v8.0、Validation Flow の再設計 v8.1→v8.2、任意の更新コールバック v8.2→v8.4）。android、ios、web、cordova、capacitor、flutter、rn（React Native）、kmp（Kotlin Multiplatform）で利用できます。
id-capture-{framework}	ID Capture（パスポート、運転免許証、ID カード、MRZ／VIZ／バーコード／モバイル書類などの身分証明書のスキャン）の統合と v7 から v8 への移行（scannerType から scanner ラッパーへの変更、AamvaBarcodeVerifier の削除）、および 3 つの追加機能モジュール（無効化された ID の検出、欧州運転免許証のデコード、AAMVA バーコード検証）。web、flutter、cordova、rn（React Native）、capacitor、kmp（Kotlin Multiplatform）で利用できます。
id-bolt	ID Bolt — Scandit がホストする、Web サイト向けのすぐに使える ID スキャン機能（ID Capture を Scandit がホストするポップアップ内で実行する薄いラッパーであり、UI ワークフローを構築する必要はありません）。IdBoltSession.create(...) と start()、DocumentSelection、スキャナー／バリデーター／匿名化、onCompletion／onCancellation、テーマ設定とローカライズに対応しています。ID Capture SDK ではなく @scandit/web-id-bolt を使用します。Web のみ。
parser-kmp	Parser — GS1 AI、HIBC、AAMVA、EPC、Swiss QR などの構造化バーコードデータを型付きフィールドに解析します。kmp（Kotlin Multiplatform）で利用できます。
scandit-xamarin-to-net-migration	Xamarin アプリをサポート対象の .NET スタック（.NET for Android、.NET for iOS、または .NET MAUI）に移行した後で、Scandit SDK の統合を移行します（Microsoft の .NET アプリ最新化ツールを使用した後など。Xamarin のサポートは 2024 年 5 月に終了しました）。移行後に使用する Scandit 専用の補助スキルです。Scandit.DataCapture.*.Xamarin(.Forms) パッケージを .NET／*.Maui の対応パッケージに置き換え、SDK-8 の初期化、.Unified 名前空間とビューを修正し、スキャンを検証したうえで、対応する *-net-android／*-net-ios／*-net-maui スキルに引き継ぎます。一般的なアプリの移行は Microsoft のツール（非推奨となった .NET Upgrade Assistant の後継である GitHub Copilot app-modernization エージェント）を使用します。Scandit の移行レポートを作成します。

貢献

これらのスキルの品質向上につながるフィードバックを歓迎します。

• 問題を報告する。 バグ、古くなった SDK のパターン、誤ったガイダンスは、issue tracker に報告してください。
• 新しいスキルをリクエストする。 必要な Scandit の製品、フレームワーク、ワークフローがカバーされていない場合は、機能リクエストを作成してください。

ブランチ： 開発は main で行われるため、プルリクエストの対象はこのブランチにしてください。デフォルトの dist ブランチはインストール専用のコピー（評価や内部ツールは含まれません）で、main へのプッシュごとに CI が再生成します。このブランチにプッシュした変更は上書きされます。main はデフォルトブランチではないため、プルリクエストのマージ時に Fixes #N を記載しても issue はクローズされません。手動でクローズしてください。

プッシュ前のチェック： main のクローンで、git config core.hooksPath internal/githooks を一度実行してください。以降、プッシュのたびに skill-auditor の構造チェックとテストが実行され、いずれかで問題が報告されるとプッシュは拒否されます。

ライセンス

ライセンス情報については、LICENSE ファイルを参照してください。