AI 코딩 에이전트로 바코드 스캐닝 연동하기 — Scandit Agent Skills

문제 — AI가 짜 주는 바코드 연동 코드, 왜 자꾸 틀릴까

요즘 새 기능 연동을 AI 코딩 에이전트에게 먼저 시켜 보는 팀이 많습니다. 바코드 스캐닝도 예외가 아닌데, 결과물을 받아 보면 묘하게 옛날 코드가 나옵니다. SDCCore.configure()로 시작하는 웹 코드, newlyRecognizedBarcodes(복수형) 같은 v6 시절 API가 섞여 있는 식입니다.

이유는 단순합니다. AI 모델의 학습 데이터에는 수년 치 블로그 글, 스택오버플로 답변, 샘플 코드가 쌓여 있고, 그중 상당수가 구버전 기준입니다. Scandit SDK는 v6에서 v7, v8로 넘어오며 초기화 방식과 핵심 API가 크게 바뀌었습니다. 모델이 가장 많이 본 코드는 현재 가장 틀린 코드인 셈입니다.

저희가 직접 겪은 문제이기도 합니다. 데이터커넥트 기술 문서를 점검하면서 구버전 API가 남아 있던 부분을 모두 걷어냈는데, 그 검증 기준으로 쓴 것이 바로 이번에 소개하는 Scandit 공식 Agent Skills였습니다.

해결 — Scandit Agent Skills

Scandit이 공개한 Agent Skills는 AI 코딩 에이전트에게 바코드 스캐닝 연동법을 가르치는 공식 지침 모음입니다. Scandit은 이를 바코드 스캐닝을 제대로 통합하도록 AI 에이전트를 가르치는 첫 지침으로 소개하면서, 500개 이상의 평가 테스트 케이스로 검증했다고 밝혔습니다.

구성은 이렇습니다.

• 제품 커버리지 — SparkScan, Barcode Capture, MatrixScan(AR·Batch·Count·Pick) 계열, Smart Label Capture에 더해 ID Capture·ID Bolt까지 40종 이상의 스킬이 공개되어 있습니다.
• 프레임워크 — iOS, Android, Web(JavaScript/TypeScript), React Native, Flutter, Capacitor, Cordova, .NET까지 주요 개발 환경을 다룹니다.
• 지원 에이전트 — Vercel의 skills CLI 기반으로 Claude Code, Codex, Cursor, GitHub Copilot, Cline, Windsurf 등 40개 이상. Agent Skills 오픈 스탠더드를 따르는 도구에 설치할 수 있습니다.
• 라이선스 — Apache-2.0 오픈소스. 스킬 사용 자체는 무료입니다.

스킬의 핵심 동작 원리는 "에이전트의 기억을 믿지 말라"입니다. 각 스킬은 에이전트에게 학습 데이터 속 API를 그대로 쓰지 말고, 동봉된 최신 레퍼런스 문서와 공식 문서를 확인한 뒤 코드를 쓰도록 강제합니다. 버전별로 바뀐 메서드 시그니처, 플랫폼별로 다른 콜백 이름(didScan vs onBarcodeScanned) 같은 함정이 레퍼런스에 명시되어 있습니다.

사용법 — 설치 한 줄, 그다음은 자연어

설치는 터미널에서 한 줄입니다.

npx skills add scandit/skills

Claude Code 사용자는 플러그인 마켓플레이스로도 설치할 수 있습니다.

/plugin marketplace add scandit/skills
/plugin install scandit-sdk@scandit-plugins

설치 후에는 평소처럼 자연어로 요청하면 됩니다. "재고 실사 화면에 SparkScan 붙여줘", "이 React 앱에 바코드 스캐너 추가해줘" 정도의 요청에 에이전트가 해당 스킬을 찾아 읽고, 현재 SDK 8.x API 기준으로 통합 코드를 작성합니다. 심볼로지를 무엇으로 켤지, 어떤 파일에 넣을지 에이전트가 되묻는 것까지 스킬에 설계되어 있습니다.

실행에는 기존과 동일하게 Scandit 라이선스 키가 필요합니다. 스킬은 코드를 바르게 쓰는 법을 가르칠 뿐, 라이선스를 대체하지 않습니다.

2026년 7월 업데이트 — 제품 추천 스킬과 ID 스캐닝

스킬 번들이 확장됐습니다. 중심에 있는 것이 data-capture-sdk 제품 추천 스킬입니다. "iOS 창고 피킹 앱에서 바코드를 스캔하고 싶다"처럼 유스케이스를 평소 말로 설명하면, 이 스킬이 실제 고객 통합 사례를 근거로 알맞은 Scandit 제품·프레임워크 조합을 추천하고, 해당 구현 스킬(예: sparkscan-ios)로 작업을 넘깁니다. 설명이 구체적일수록 추천이 정확해지고, 제품 선택부터 코드 작성까지 에이전트 안에서 끝납니다.

ID 스캐닝 스킬도 추가됐습니다. id-capture-{framework}(web·flutter·cordova·rn·capacitor)와, 웹사이트에 바로 얹는 호스티드 방식의 id-bolt입니다. Scandit은 이 조합을 '깊게 커스터마이즈되는 SDK냐, 기능이 제한된 IDV 플랫폼이냐'라는 오랜 트레이드오프를 푸는 답으로 소개합니다. iOS 전용 MatrixScan Pick(matrixscan-pick-ios) 스킬도 카탈로그에 올랐습니다.

설치 경로도 늘었습니다. Codex는 전용 명령을 지원합니다.

codex plugin marketplace add scandit/skills
codex plugin add scandit-sdk@scandit-plugins

Cursor는 마켓플레이스에서 원클릭 설치가 가능합니다. 전체 스킬 카탈로그는 scandit/skills 저장소에서 항상 최신으로 확인할 수 있습니다.

문서 쪽도 함께 정비됐습니다. Scandit은 AI가 읽을 수 있는 문서를 llms.txt와 Context7로 제공해, 스킬을 설치하지 않은 에이전트도 최신 구조화된 Scandit 문서에 접근할 수 있습니다.

한국 개발팀에 주는 의미

PoC 속도가 달라집니다. 바코드 스캐닝 도입 검토에서 가장 시간이 들던 구간이 "일단 돌아가는 데모"였습니다. 에이전트와 스킬 조합이면 기존 앱에 스캔 화면을 붙이는 첫 데모까지의 시간이 크게 줄어듭니다. 도입 검토 중인 팀이라면 평가 라이선스를 받아 반나절 안에 자사 앱에서 인식률을 직접 확인하는 시나리오가 현실적이 됐습니다.

구버전 API 사고를 예방합니다. 마이그레이션(v6→v7→v8) 작업이나 신규 통합에서 에이전트가 옛 API를 섞는 문제가 스킬 설치만으로 크게 줄어듭니다. 마이그레이션 전용 레퍼런스도 스킬에 포함되어 있습니다.

사람의 역할은 검토로 이동합니다. 생성된 코드의 카메라 라이프사이클, 권한 흐름, 기존 아키텍처와의 결합부는 여전히 사람이 검토해야 합니다. 데이터커넥트는 Scandit 한국 공식 파트너로서 에이전트 생성 코드의 검토, 평가 라이선스 발급, 현장 PoC 설계를 지원합니다. 직접 해보다 막히는 지점이 생기면 기술팀에 문의해 주세요.

연동 절차 전체가 궁금하다면 연동 가이드에서 플랫폼별 직접 통합 방법과 함께 확인할 수 있습니다.