Scandit

Scandit SDK 的 Agent Skills

用于集成 Scandit Data Capture SDK 的 AI Agent 技能。

每项技能都针对特定产品和框架（例如 SparkScan iOS），并整合了推荐的集成代码、最新的设置方式、权限和许可证密钥配置、常见的自定义方案（模式、回调、UI 调整），以及迁移指南、SDK 版本升级说明；部分产品还包含替换第三方扫描器的指南，所有内容均以 Scandit 自有文档为依据。安装一次后，只需向 Agent 请求所需功能，无需再把文档片段粘贴到 AI 编辑器中。

安装

安装插件。只需一条命令，Agent 就能获取全部 86 项技能：

npx [email protected] add scandit/skills

它会检测你使用的编码 Agent，并将技能安装到每个 Agent 中。再次运行同一命令即可获取最新技能。

也可以从 Agent 自带的市场安装：

Agent	安装	更新
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
其他 Agent	npx [email protected] add scandit/skills	再次运行 npx [email protected] add scandit/skills

只需要一项技能？ Agent 只会加载提示词所需的技能，因此完整技能包才是合适的选择——使用 npx [email protected] add scandit/skills 安装一次即可。

使用方法

用日常语言描述你的需求。Agent 会自动加载合适的技能；你也可以通过 /skill-name 显式调用某项技能，然后描述任务。

不确定需要哪款 Scandit 产品？ 从 data-capture-sdk 开始。它是一个顾问，而非集成技能：它会询问一些关于工作流的问题，推荐合适的产品，然后将任务交给适用于你平台的对应实现技能。描述你的应用，粘贴想要添加扫描功能的屏幕截图，或提供需要采集的标签、包装或证件照片。

/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 服务负责这部分工作——将它连接起来（claude mcp add --transport http scandit https://ssl.scandit.com/mcp），并同时安装技能（npx [email protected] add scandit/skills），之后每项实现技能中的 ## Licence key 部分都会调用它获取试用密钥，并将密钥写入应用的许可证密钥调用代码中；聊天中只会显示遮罩后的预览。技能绝不会在你的设备上查找密钥：密钥由 MCP 服务提供，或由你自行提供。密钥最终会以明文形式写入源代码，因此请勿将任何非试用密钥提交到版本控制中。

通过此方式配置的密钥仅限试用，且 MCP 服务采用基于浏览器的身份验证，因此无法在无头环境或 CI 中使用。即使不使用它，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（点击或瞄准，从多个条码中选取一个）集成——选择类型与策略、会话计数、基础叠加层画笔。适用于 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 进行批量计数、显式管理摄像头生命周期、自定义高亮样式（图标/圆点样式）、状态模式、聚类，以及根据捕获列表进行扫描（进度、接受/拒绝列表外项目）。适用于 ios、android。
matrixscan-batch-{framework}	MatrixScan Batch（BarcodeBatch，前身为 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（身份文件扫描——护照、驾照、身份证、MRZ/VIZ/条码/移动文件）集成与 v7→v8 迁移（scannerType→scanner 封装器、移除 AamvaBarcodeVerifier），以及三个附加功能模块（作废 ID 检测、欧洲驾照解码、AAMVA 条码验证）。适用于 web、flutter、cordova、rn（React Native）、capacitor、kmp（Kotlin Multiplatform）。
id-bolt	ID Bolt——Scandit 为网站提供的托管式即插即用 ID 扫描方案（它是 ID Capture 的轻量封装，在 Scandit 托管的弹出窗口中运行，因此您无需构建 UI 工作流）。IdBoltSession.create(...) + start()、DocumentSelection、扫描器/验证器/匿名化、onCompletion/onCancellation、主题与本地化。使用 @scandit/web-id-bolt（而非 ID Capture SDK）。仅适用于 Web。
parser-kmp	Parser——将 GS1 AI、HIBC、AAMVA、EPC、Swiss QR 等结构化条码数据解析为类型化字段。适用于 kmp（Kotlin Multiplatform）。
scandit-xamarin-to-net-migration	在 Xamarin 应用已迁移到受支持的 .NET 技术栈后，迁移 Scandit SDK 集成——.NET for Android、.NET for iOS 或 .NET MAUI（例如，使用 Microsoft 的 .NET 应用现代化工具后；Xamarin 支持已于 2024 年 5 月结束）。这是迁移后的 Scandit 专用配套技能：它会将 Scandit.DataCapture.*.Xamarin(.Forms) 包替换为对应的 .NET/*.Maui 包，修复 SDK-8 初始化、.Unified 命名空间和视图，验证扫描功能，并转交给匹配的 *-net-android / *-net-ios / *-net-maui 技能。通用应用迁移仍使用 Microsoft 的工具（GitHub Copilot 应用现代化 Agent，它是已弃用的 .NET Upgrade Assistant 的后继产品）。生成 Scandit 迁移报告。

贡献

欢迎提供反馈，帮助提升这些技能的质量：

• 报告问题。 请在问题跟踪器中提交错误、过时的 SDK 用法或不正确的指导。
• 申请新技能。 如果你需要的 Scandit 产品、框架或工作流尚未涵盖，请提交功能请求。

分支： 开发工作在 main 上进行，因此请将拉取请求提交到该分支。默认的 dist 分支仅用于安装（不包含评估或内部工具），CI 会在每次推送到 main 时重新生成该分支；推送到该分支的更改会被覆盖。由于 main 不是默认分支，合并拉取请求时，Fixes #N 不会关闭对应问题：请手动关闭。

推送前检查： 在 main 克隆中运行一次 git config core.hooksPath internal/githooks。之后每次推送都会运行 skill-auditor 结构检查及其测试；只要其中任何一项报告问题，推送就会被拒绝。

许可证

许可信息请参阅 LICENSE 文件。