IronBarcode 문서를 기반으로 Cursor 사용하기
IronBarcode에서 BarcodeReaderOptions.CropArea는 같은 이름의 System.Drawing 유형이 아닌 IronSoftware.Drawing.Rectangle를 받고, 기억에 의존하는 모델은 익숙한 타입을 선택합니다. 같은 습관으로 dotnet add package IronBarcode를 쓰지만, 패키지는 BarCode이고 네임스페이스는 IronBarCode입니다.
Cursor는 이전에 @Docs 멘션으로 문서 사이트를 인덱싱하여 이 문제를 해결했습니다. 현재 Cursor 문서에는 이 멘션이 더 이상 나오지 않습니다. 대신 프롬프트에 링크를 붙여 넣어 에이전트의 웹 도구가 가져오게 하거나, 규칙 또는 스킬에 지침을 담을 수 있습니다. 이 세 가지는 모두 에이전트를 실제 페이지로 안내하며 어느 방식도 인덱싱을 기다릴 필요가 없습니다.
Cursor는 AI 중심의 편집기이며, 그 에이전트는 두 가지 매우 다른 범위에서 작동합니다:
- 인라인 편집과 Tab은 커서 위치에서 작동합니다.
Ctrl+K(Mac에서는Cmd+K)로 변경 내용을 한 문장으로 지정하고, Tab은 다음 편집을 예측합니다. - 에이전트 모드는 여러 파일에 걸친 작업을 계획하고 빌드를 실행하며 오류를 읽고 반복하면서, 계획 모드는 먼저 여러분과 접근 방식을 결정하게 합니다.
Tab은 후속 변경이 다른 파일에 필요하면 해당 파일로 이동할 수 있는 포털을 엽니다. 인라인 편집은 현재 위치에 diff를 표시하여 수락하거나 거부할 수 있게 합니다.
규칙은 에이전트 모드와 채팅에만 적용됩니다. Cursor의 문서는 규칙이 Cursor Tab이나 다른 AI 기능에 영향을 미치지 않는다고 명백히 명시합니다. 따라서 커밋한 규칙은 Tab이 메서드를 제안할 때 적용되지 않습니다.
바코드 작업에서 Cursor가 문서를 근거로 작업하게 하려면 두 개의 커밋한 파일과 프롬프트에 붙여 넣은 링크가 필요합니다. 이 준비는 정밀한 변경 작업, 즉 리더 옵션 제한, 자르기 영역 추가, 읽기 속도 선택 또는 품질이 낮은 스캔 이미지 묶음을 읽을 수 있게 하는 단일 이미지 수정을 찾는 작업에서 특히 중요합니다.
이 내용은 IronBarcode 리더 내부의 신뢰도 점수 산정과는 별개이며, 이에 대해서는 별도의 작동 예제가 있습니다.
빠른 시작Cursor에서 C# 프로젝트를 열고 쓰기 전에 에이전트에게 페이지를 읽도록 하십시오.
In Program.cs, generate a Code 128 barcode for an asset tag and style it for a
printed label. Set the bar color and the background with ChangeBarCodeColor and
ChangeBackgroundColor, size it with ResizeTo, and print the value under the
bars. The license comes out of IRONBARCODE_LICENSE_KEY.
Work from https://ironsoftware.com/barcode/csharp/llms-full.txt, use only
members that appear in it, and tell me which page each styling call came from.
색상 및 크기 멤버는 반쯤 기억하기 쉽기 때문에, 프롬프트는 에이전트를 우선 페이지로 보냅니다. 바코드 스타일링 가이드는 세 가지 모두를 정확하게 명명합니다.
5단계 기본 워크플로
- NuGet에서 C# 바코드 라이브러리 다운로드
- IronBarcode의
llms-full.txt링크를 바코드 코드를 작성하는 프롬프트에 붙여 넣으십시오. - IronBarcode의
skill.md를.cursor/skills/ironbarcode/SKILL.md로 저장하십시오. - BarCode 버전과 코딩 규칙을 명시하는 프로젝트 규칙을 커밋하십시오.
- 모두 빌드하고, 모든 바코드를 다시 읽고, API 레퍼런스에 대응하여 모든 API 이름을 확인하십시오.
어떤 모델이 바코드 세션을 실행해야 합니까?
Cursor는 이 시리즈에서 모델을 선택할 수 있는 유일한 도구입니다. 자체 에이전트 모델인 Composer는 도구 사용, 파일 편집 및 편집기 내 터미널 작업에 맞게 조정되었으며, 빠른 버전이 기본으로 제공됩니다. 모델 선택 목록에는 OpenAI, Anthropic, Google 및 SpaceXAI의 최신 고성능 모델도 나열되어 있습니다. Tab은 이 모델 선택과 별개로 최근 편집 내용, 주변 코드, 린터 오류를 바탕으로 작동합니다.
바코드 세션의 대부분은 비용이 적고 반복적입니다. 포맷을 추가하고, 다시 빌드하며, 테스트 세트를 해독하고 조정합니다. 때때로 실제 스캔 배치가 해독되지 않고 왜 그런지 설명하는 오류가 없을 때, 편집 전에 더 오래 생각하는 모델로 전환해야 할 때입니다. 모델은 또한 코드를 형성하므로 기본값을 남기지 말고 심볼로지, 출력 크기 및 다시 읽기 성공 조건을 고정하십시오.
여기에서 이 시리즈가 겹칩니다. Cursor에서 Claude 모델을 실행하고 Claude Code 가이드의 메모가 그 출력에 적용됩니다. 모델은 동일합니다. 인터페이스만 다릅니다.
Cursor가 IronBarcode 문서를 근거로 작업하게 하려면 어떻게 해야 합니까?
기존 인덱스는 다음 세 가지 방법으로 대체할 수 있으며, 함께 사용할 수 있습니다:
- 링크 붙여 넣기: 문서 허브 대신
llms-full.txt를 지정하십시오. 이 URL 하나로 에이전트에 가이드, 예제, 멤버 이름을 제공할 수 있습니다. - 스킬 커밋: IronBarcode의 게시된
skill.md를.cursor/skills/ironbarcode/SKILL.md로 저장하고,name: ironbarcode를 폴더에 맞게 설정하고 커밋하십시오. - 규칙 커밋: 다음 섹션은 그 안에 무엇이 들어가는지 다룹니다.
Cursor는 프로젝트 루트나 하위 디렉터리의 .cursor/skills/와 .agents/skills/에서 에이전트 스킬을 로드합니다. 각 스킬 폴더에는 프런트매터에 name과 description이 있는 SKILL.md 파일이 들어 있습니다. 에이전트는 관련 작업을 수행할 때 스킬을 로드하며, /ironbarcode를 입력하면 직접 호출할 수 있습니다. .agents/skills/는 도구에 종속되지 않는 공통 경로이므로 Codex와 Antigravity도 같은 파일을 이 위치에서 로드합니다.
세 가지를 모두 생략하면 모델은 현재 릴리스와 대조하지 않은 학습 데이터를 바탕으로 답합니다. 가장 먼저 메서드 이름에서 문제가 발생합니다. BarcodeScanner.DecodeImageFile()는 실제 호출처럼 보이고 빌드에서 실패합니다.
작업할 페이지가 있으면 추측일 질문이 조회가 됩니다.
Which options narrow a read to two symbologies inside a fixed region of a
larger image? Give me the exact class and property names, and quote the lines
you took them from in https://ironsoftware.com/barcode/csharp/llms-full.txt.
에이전트가 제안한 API의 페이지를 인용할 수 없으면 빌드하기 전에 확인하십시오.
BarcodeReaderOptions를 직접 스크롤하며 살펴보는 대신 질문으로 조회할 수 있고, 답변은 근거가 되는 API 레퍼런스 페이지를 인용합니다.IronBarcode의 규칙을 인코딩하는 프로젝트 규칙을 작성하는 방법은 무엇입니까?
프로젝트 규칙은 리포지토리 루트의 .cursor/rules 폴더에 들어갑니다. 이들은 버전 제어 하에 있으며 코드와 함께 커밋되어 모든 개발자가 제로 설정으로 동일한 동작을 얻습니다.
각 규칙은 .mdc 파일이며, 이는 description, globs, 및 alwaysApply을 설정하는 YAML 프런트매터가 있는 마크다운입니다. Cursor는 폴더를 재귀적으로 검색하므로 서브폴더도 작동합니다. 일반 .md 파일은 규칙을 활성화할 프런트매터가 없어 무시됩니다. IronBarcode 규칙은 다음과 같이 보입니다.
---
description: IronBarcode conventions for barcode reading and writing in this project
globs: ["**/Services/**/*.cs", "**/Barcodes/**/*.cs"]
alwaysApply: false
---
# IronBarcode conventions
Applies to the barcode code in this folder only.
- IronBarcode (package BarCode, namespace IronBarCode) writes and reads every
barcode here. Never reach for a second barcode package.
- Reader options are explicit: set ExpectBarcodeTypes to the formats this
feature really reads, and reuse one BarcodeReaderOptions per format set
rather than allocating per call.
- Reads on a request path are async.
- CropArea takes IronSoftware.Drawing.Rectangle, not System.Drawing.
- Verified recipes: https://ironsoftware.com/barcode/csharp/skill.md
- If you are unsure a member exists, say so and cite the page. Do not guess a
method name that sounds plausible.
모델에게 불확실하다고 답해도 된다고 알려 주면 존재하지 않는 API를 만들어 내는 일을 방지할 수 있습니다. 이 내용을 규칙에 한 번 명시하면 이후 모든 세션에 적용됩니다.
globs 줄은 적용 범위를 고려하여 복사하십시오. alwaysApply: true이 있는 규칙은 모든 요청에 로드되며 바코드가 없는 작업에 문맥을 소모합니다. 바코드 코드가 들어 있는 폴더에 범위를 지정하면 그것이 속한 곳에 유지됩니다.
AGENTS.md 파일을 읽습니다. 이 파일에는 프런트매터나 글로브가 없으며, Cursor는 프로젝트 루트와 하위 디렉터리에서 이를 읽으므로 디렉터리 중첩으로만 적용 범위를 지정할 수 있습니다. 글로브 패턴이 필요하면 .cursor/rules를 사용하고, 여러 도구에서 지침 파일 하나를 공유하려면 AGENTS.md를 사용하십시오.어떤 모드가 변경에 적합합니까?
Cursor는 이 시리즈에서 어떤 도구보다도 더 많은 편집 방법을 제공합니다. 크기에 따라 선택하십시오, 한 줄에서 전체 리포지토리에 이르기까지:
| 모드 | 사용할 때 | 바코드 예시 |
|---|---|---|
| 탭 | 다음 편집이 예측 가능합니다 | 리더 옵션 반복 |
| 인라인 편집 | 한 파일, 한 문장 | 두 형식으로 읽기 좁히기 |
| 에이전트 | 작업이 파일을 넘어서고 빌드 루프가 필요합니다 | 라벨 엔드포인트와 스캔 엔드포인트 |
| 계획 모드 | 다시 검토하기에 너무 큰 재작성 | 다른 바코드 라이브러리에서 마이그레이션 |
| 클라우드 에이전트 | 비감독 상태로 실행할 수 있습니다 | 모든 포맷의 왕복 테스트 |
@ 언급은 무엇을 변화시킵니까?
@ 언급은 에이전트에게 읽을 것을 넘겨주며, 이는 파일, 폴더, 터미널, 이전 채팅, Git diff, 또는 브라우저일 수 있습니다. 바코드를 읽는 파일을 직접 참조하는 편이 설명하는 것보다 효과적입니다. 설명만으로는 버그의 원인이 되는 세부 사항이 빠질 수 있기 때문입니다.
@Services/ScanService.cs @TestData/depot/
Read https://ironsoftware.com/barcode/csharp/llms-full.txt for the options.
Half the photos in TestData/depot/ come back empty. The reader options are
where this gets fixed, not the label generator. Name the setting that was
missing, and give me a decode rate for the folder before your change and after
it.
모듈 전체에 걸친 작업에는 폴더 멘션이 적합하며, 어떤 파일이 관련되는지 모를 때는 전체 코드베이스를 참조할 수 있습니다. 코드를 문서와 짝지으면 문제의 두 측면을 모두 확인할 수 있습니다: 파일은 코드가 현재 수행하는 것을 보여주고, 페이지는 라이브러리가 실제로 제공하는 것을 보여줍니다.
어떤 설정으로 사진 묶음을 읽을 수 있을지는 이미지의 손상 상태에 따라 달라집니다. 설명만으로는 에이전트가 이미지를 직접 처리하는 과정을 대신할 수 없습니다. 읽기 속도 및 이미지 수정 페이지는 개별 설정을 다룹니다.
IronBarcode로의 마이그레이션을 어떻게 계획하고 실행합니까?
마이그레이션 중 검토 없이 여러 파일을 재작성하면 비용이 커집니다. 작성하는 것보다 되돌리는 것이 더 어렵기 때문입니다. 계획 모드는 이것을 위해 존재합니다. 대화 입력에서 Shift+Tab를 누르거나 모드 드롭다운에서 선택하면, 에이전트가 명확화 질문을 하고, 코드베이스를 읽고, 코드가 나타나기 전에 채팅 또는 마크다운으로 편집할 계획을 만듭니다. 계획은 여러분의 홈 디렉토리에 저장되며 "작업 공간에 저장"하면 팀이 검토하기 위해 리포지토리로 이동합니다.
The barcode code in @Labels/ belongs to another library. Using
https://ironsoftware.com/barcode/csharp/llms-full.txt, work out what replacing
it with IronBarcode would actually involve. Which files change, what the
equivalent call is for each thing the folder does today, and where the
documentation says no clean equivalent exists.
Public method signatures are fixed. If the plan needs one to change, say so in
the plan rather than changing it.
계획을 읽고, 한두 문장으로 수정하고, 빌드로 다시 보내십시오. 그런 다음 에이전트 모드가 코드를 읽고, 여러 파일을 편집하고 명령을 실행하며 출력을 확인하는 과정을 반복하므로 다음 프롬프트는 짧을 수 있습니다.
Carry out the plan we agreed. Compile it, clear whatever errors come up, and
satisfy yourself that every symbology the folder handles still comes back out
the same as it went in. Show me the diff at the end. BarCode is the only package
that may appear in the .csproj.
이 두 가지 제한을 생략하면 에이전트는 마이그레이션 중에 호출 패턴까지 재설계합니다.
직접 감독할 필요가 없는 작업은 클라우드 에이전트(이전 명칭: 백그라운드 에이전트)에 맡기고 편집기에서 계속 작업할 수 있습니다. 왕복 테스트 스위트가 이런 작업에 적합합니다. 구현 세부 사항 대신 디코딩된 값을 검증하므로 마이그레이션이 끝날 때까지 기다리지 않고 작성할 수 있습니다.
@Services/
Send this to a cloud agent while I keep working on the reader options.
Cover the migrated service with xUnit. Use a [Theory] over the symbologies it
supports rather than one [Fact] per format, so adding a format later costs one
line. Each case writes a sample value and reads it back, and the assertion is on
the decoded string and the decoded format together.
Then three edge cases as their own facts: an empty image returns no results
instead of throwing, a letters-only value is refused as EAN-13, and a missing
path fails with a readable message. Image bytes are off limits as an assertion
target.
플랫폼 간에 스위트를 안정적으로 유지하는 것은 바이트 비교를 배제하는 것입니다.
읽기 문제는 어디에 있습니까?
읽을 수 없는 바코드는 가장 빈번한 IronBarcode 질문이며, 답은 거의 항상 라벨보다는 리더 옵션에 있습니다. Cursor가 추가하는 것은 실패를 설명할 필요가 없다는 것입니다. 서비스와 실패 이미지의 폴더를 언급하면 편집기는 둘 다에서 작동합니다.
Photos of returns labels read fine on a handheld scanner but come back empty
from @Services/ScanService.cs, and a few product photos carrying no barcode at
all return a value. Samples of both are in @TestData/returns/.
Explain the cause of each before changing anything, then fix both in the reader
options.
설명을 먼저 요청하면 수정 결과를 역으로 분석하는 대신 원인에 대한 추론을 검토할 수 있습니다. 이 두 증상에는 서로 다른 방향의 수정이 필요합니다. 읽기 실패에는 형식 목록 제한, 자르기 영역, 적절한 이미지 필터가 필요하며, 바코드가 인식되지 않음 가이드에서 다룹니다. 잘못 감지된 값에는 RemoveFalsePositive와 신뢰도 임계값이 필요하며, 오탐 가이드에서 다룹니다.
배포 실패의 원인은 대개 C# 파일이 아니라 .csproj나 컨테이너 이미지에 있으며, 터미널 액세스가 있는 에이전트는 둘 다를 읽고 자체 빌드를 실행할 수 있습니다.
@Dockerfile @LabelScan.csproj @Terminals
Reading works on Windows but fails in our Linux container. The failing build is
in the terminal output above, so read it there rather than asking me to paste it.
Check which BarCode package the project references and whether the image has
the native dependencies IronBarcode needs on Linux. Explain the cause, then
propose the change. Don't modify C# code unless the cause is there.
C# 코드를 수정하지 말라고 명시하십시오. 실패하는 호출만 주고 수정 범위를 제한하지 않으면 에이전트는 try/catch를 추가한 뒤 문제가 해결되었다고 보고할 수 있습니다. 리눅스의 Docker 가이드는 이미지에 실제로 필요한 것을 나열합니다.
처음으로 무엇을 설정해야 합니까?
스킬 파일과 적용 범위가 지정된 규칙 하나를 설정하는 데는 약 15분이 걸리며, 그 후의 모든 세션에 적용됩니다. 문서 링크는 매 프롬프트에 한 줄씩 붙여 넣는 습관을 유지하면 됩니다.
편집기 뒤의 모델을 변경해도 세 가지 확인은 여전히 유효합니다: 코드가 컴파일되고, 바코드가 해독되고, 사용된 모든 멤버가 IronBarcode의 문서화된 API에 나타납니다. 이 세 가지는 AI 코딩 보조 및 에이전트 가이드에서 측정하는 것입니다. Claude Code, ChatGPT Codex, GitHub Copilot 및 Google Antigravity에 각각의 페이지가 있습니다.
문제 해결
- IronBarcode에 라이선스 키 적용은 인라인 편집이 컴파일되고 실행이 거부될 때입니다.
- 바코드가 인식되지 않음은 리더 옵션을 아직 조정할 필요가 있을 때입니다.
- 프로젝트 규칙의 버전과
.csproj의 버전이 일치하지 않을 때 IronBarcode NuGet 패키지. - 로컬에서는 읽기에 성공하지만 컨테이너에서는 실패할 때 Linux의 Docker에서 IronBarcode 실행.
질문?
질문이 있으시면 support@ironsoftware.com으로 문의하세요.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.