AI 코딩 어시스턴트와 함께 IronXL 사용하기
IronXL은 Iron Software의 .NET 라이브러리로, Excel 파일 작업을 위한 것입니다. Microsoft Office가 설치되지 않은 상태에서도 XLSX 및 기존 XLS 작업을 생성, 읽고, 편집하며, CSV 및 TSV 파일을 가져오고, 수식을 평가하고, 차트를 그릴 수 있습니다. IronXL은 2019년부터 NuGet에서 제공되며, 튜토리얼에서는 WorkBook과 WorkSheet을 사용합니다.
클래스 이름은 릴리스 2026.10.1이 데이터를 처리하는 방식을 보여주지 않습니다. IronXL에 문자열 "8.27"을 셀 값으로 제공하면 현재 연도의 8월 27일로 저장됩니다. 필드 변환 기능을 켜고 CSV를 가져오면 OrderId가 000417인 상태로 반환됩니다. EvaluateAll를 호출하지 않고 저장하면 파일은 마지막 편집 전의 수식 결과를 보유할 수 있습니다. 이 점들은 빌드를 중단하지 않습니다.
이 페이지는 이러한 작업을 위한 어시스턴트를 설정합니다.
- 채팅 스타일 어시스턴트는 선택한 코드를 다시 작성하거나 편집기에서 질문에 답합니다.
- 에이전트는 ChatGPT Codex, Google Antigravity, Claude Code, Cursor와 같이 전체 작업을 수행하고 작성한 코드를 빌드하고 실행합니다.
작업이 CSV 내보내기 읽기, 수식 편집, 차트 추가 또는 워크북 암호화인 경우, 두 경우 모두 설정은 동일합니다.
AI 코딩 어시스턴트와 함께 IronXL을 사용하는 방법
- NuGet에서 IronXL.Excel 패키지를 가져옵니다
- 첫 번째 워크북 호출 전에
IronXL_LICENSE_KEY에서IronXL.License.LicenseKey를 할당합니다. - 세션 시작 시 어시스턴트에 IronXL의
llms.txt인덱스를 제공합니다. - 어시스턴트가 로드하는 지시 파일에 IronXL 규칙을 유지합니다.
- 새 세션을 열고 원샷 설정 프롬프트를 전송합니다.
- 프로그램을 빌드하고 실행한 다음 셀프 체크 프롬프트를 전송합니다.
내 AI 어시스턴트가 Excel을 혼자서 처리할 수는 없나요?
기억력만으로 어시스턴트는 교육 때 본 IronXL을 작성하며, 여기에는 현재 릴리스에 없는 멤버가 포함될 수 있습니다. IronXL은 도구가 읽을 수 있는 형태로 문서를 게시하므로, 어시스턴트는 대신 현재 API에서 작업할 수 있습니다.
수의 그리드를 XLSX에 쓰는 것이 가장 쉬운 부분입니다. 라이브러리 간의 차이는 수식, 기존 XLS 입력, 공급업체 CSV 파일, 외부인이 접근할 수 없어야 하는 워크북에서 나타납니다.
- Office Interop은 코드를 하나의 데스크탑에 묶습니다: Interop을 사용하는 어시스턴트는 코드가 실행되는 곳에 Excel이 설치되어야 하지만, IronXL 패키지는 Windows, Linux, macOS 서버에서 실행됩니다.
- CSV 파서 재작성은 토큰을 소모합니다: IronXL의 CSV 가져오기를 수작업으로 작성한 분할기로 대체하는 에이전트는 시도할 때마다 비용을 지불하며, 새 파서는 여전히 IronXL이 이미 처리하는 인용 규칙을 배워야 합니다.
- 패키지 이름과 네임스페이스가 다릅니다: NuGet ID는
IronXL.Excel이며 네임스페이스는IronXL입니다. 추측한 ID는 잡아내려는 유사 패키지로 해석될 수 있습니다. 이를 슬롭스쿼팅 공격이라 부릅니다. 정확한 ID를 프롬프트에 작성하세요.
단계 1: IronXL 설치
패키지가 참조되면 어시스턴트는 IronXL의 실제 유형을 검사할 수 있습니다.
Add the IronXL.Excel package from NuGet and restore the project.
Then tell me which version the project file references.
대신 터미널에서 릴리스를 고정하려면 이름을 지정하세요.
dotnet add package IronXL.Excel --version 2026.10.5
IronXL.Excel 2026.10.5는 IronSoftware.Common 및 IronSoftware.System.Drawing에만 의존합니다.
2단계: 라이선스 키를 적용하세요
IronXL은 워터마크나 제한된 모드로 되돌아가지 않습니다. 키가 없을 경우, 워크북을 생성, 로드하거나 가져오는 것은 IronSoftware.Exceptions.LicensingException을 발생시켜 Production License Required라는 메시지를 팝니다. 오타가 있는 키의 경우, 첫 번째 호출에서 License Key Not Recognized라는 메시지와 함께 실패합니다. 아래에 무료 체험 키가 있으며 라이선싱 페이지는 각 영구 라이선스 등급의 개발자, 위치, 프로젝트 수를 제공합니다.
오늘 무료 체험으로 프로젝트에서 IronXL 사용을 시작하십시오.
프로그램이 시작될 때 한 번 키를 설정하고, 다른 IronXL 호출 전에 IRONXL_LICENSE_KEY 환경 변수에서 가져오십시오. 이는 소스 통제에서 제외됩니다.
유효한 키가 적용되면 IronXL.License.IsLicensed이 true를 반환하며 IronXL.License.IsValidLicense는 주어진 키가 유효하고 만료되지 않았는지 보고합니다. 예외 유형은 내부적이므로 이름을 지정하는 catch 절은 컴파일되지 않으며 CS0122을 보고합니다. 시작 시 IsLicensed을 확인하거나 Exception를 잡고 메시지를 읽으세요.
Web.config 또는 appsettings.json에 보관하는 방법을 보여줍니다.단계 3: 어시스턴트를 IronXL의 LLM 문서에 연결하기
llms.txt은 페이지 당 한 줄로 연결된 인덱스이며, 모든 세션 시작 시 위치합니다.- 94페이지의 초록이
llms-full.txt하나의 파일로 도착하며, 광범위한 질문에 적합합니다. llms-full-catalog.txt은 비교 및 블로그 워크스루를 위해 모든 블로그 게시물을 인덱스에 추가합니다.- API Reference는 모든 네임스페이스, 유형 및 멤버를 나열합니다.
- 스킬 파일을 로드하는 도구는 설치, 라이선싱, 레시피 및 일반적인 실패를 다루는
skill.md를 받아들일 수 있습니다. - AI Product Fact Sheet는 배경을 한 페이지로 제공합니다.
Fetch https://ironsoftware.com/excel/csharp/llms.txt before you write any spreadsheet code.
Stick to IronXL members that the index documents.
- Open workbooks with WorkBook.Load or WorkBook.Create.
- Import delimited text with WorkBook.LoadCSV and an explicit delimiter.
- Save with SaveAs.
Look up any member the index lacks at https://ironsoftware.com/excel/csharp/object-reference/api/.
If it's missing there too, tell me instead of making one up.
작업이 한 가지 가이드를 종속적으로 요구하면, 어시스턴트에게 해당 페이지를 열도록 요청하세요.
단계 4: 프로젝트에 IronXL 컨텍스트 추가
채팅 지시는 채팅을 닫을 때 사라집니다. 프로젝트 파일은 세션이 열릴 때마다 다시 읽으므로, 팀이 이미 유지하고 있는 IronXL 규칙을 추가하세요. Claude Code는 CLAUDE.md을 읽고, ChatGPT Codex는 AGENTS.md를 읽고, GitHub Copilot은 .github/copilot-instructions.md를 읽습니다. Cursor는 .cursor/rules/ 또는 AGENTS.md에서 .mdc 파일을 읽습니다. Google Antigravity는 AGENTS.md 또는 GEMINI.md을 읽습니다. 모든 파일에서 규칙은 동일하게 읽습니다.
## Spreadsheets with IronXL
All Excel, CSV, and TSV work in this repo uses IronXL.
The NuGet package is `IronXL.Excel`. Its namespace is `IronXL`.
Number formats live in `IronXL.Formatting` and charts in `IronXL.Drawing.Charts`.
- Read the docs index at https://ironsoftware.com/excel/csharp/llms.txt.
- Read the skill file at https://ironsoftware.com/excel/csharp/skill.md.
- Set `IronXL.License.LicenseKey` from IRONXL_LICENSE_KEY at startup.
- Never write the key into a file.
- Import CSV with `WorkBook.LoadCSV`, passing the path, an XLSX format, and the delimiter.
- Choose `convertFieldValues` on purpose. Conversion strips leading zeros from ID columns.
- A numeric string such as "8.27" assigned to `Value` becomes a date.
- Write numbers as numbers and dates as `DateTime`.
- Call `EvaluateAll` before `SaveAs` so the file stores current formula results.
- Encrypt with `WorkBook.Password` or `SaveAs` with a password. `ProtectSheet` only locks editing.
- Save XLSX unless a task names XLS.
- Before calling a change done, reload every saved workbook.
- Compare the reloaded values with the source data.
- Add no Office Interop and no second spreadsheet library.
- If IronXL lacks a feature, ask before adding anything.
스킬 파일은 암호화, 시트 보호 및 EvaluateAll을 정확하게 처리합니다. 리딩 제로 또는 날짜 변환에 대한 경고는 없으므로, 이 두 줄을 본인의 파일에 유지하세요. 단일 파일 예제는 여전히 2026.8.1에 고정되어 있으며, NuGet의 2026.10.5 패키지보다 3개의 릴리스를 뒤진 것으로, 프로젝트에서 사용하는 릴리스로 고정하십시오.
5단계: 원샷 설정 프롬프트
1단계부터 4단계까지는 한 메시지에 적합합니다. 프로젝트 시작 시 또는 새로운 세션에서 전송하세요.
Set this project up for spreadsheet work with IronXL.
Store the rules below in the instructions file your later sessions load.
- Reference the IronXL.Excel NuGet package. Its namespace is plain IronXL.
- Read IRONXL_LICENSE_KEY into IronXL.License.LicenseKey at startup, before any WorkBook call.
- Never copy the key into a file.
- Before writing code, fetch https://ironsoftware.com/excel/csharp/llms.txt.
- Build only on members it documents.
- Look up anything else in the API reference before you rely on it.
- If you support skill files, load https://ironsoftware.com/excel/csharp/skill.md.
- When the compiler and the skill disagree, believe the compiler.
- Whenever code saves a workbook, open the saved file again.
- Compare the reopened file's cells and formula results with the data that went in.
6단계: 작동하는 코드를 생성하는 프롬프트 패턴
시트, 셀 및 형식을 이름 짓습니다. 어시스턴트는 어떤 셀이 중요한지 또는 작업에 필요한 파일 형식을 추측할 수 없습니다.
모호한 IronXL로 우리의 주문을 Excel 보고서로 전환하세요.
더 나은
WorkBook.Create(ExcelFileFormat.XLSX)로 워크북을 생성하고, 굵고 고정된 헤더 행이 있는 주문 시트에 주문을 작성하고, UnitPrice 열에BuiltinFormats.Currency2를 적용하고, Summary 시트에 지역별 SUMIF를 배치합니다.
릴리스 및 프레임워크를 지정합니다. 버전 간에는 동작이 변경되며, 버전이 없는 어시스턴트는 구식과 신식이 혼합될 수 있습니다.
더 나은 타겟 .NET 9 및 IronXL.Excel 2026.10.5.
전체 파일을 요청합니다. 단편은 using 지시문의 일부를 잃고, 이는 IronXL.Formatting에 BuiltinFormats가 있고 IronXL.Drawing.Charts에 ChartType가 있어 중요합니다.
더 나은 모든 using 지시문 및 라이선스 할당과 함께 완전한
Program.cs을 반환하여 그대로 컴파일할 수 있도록 합니다.
7단계: 되돌아온 것을 검증하기
이러한 실수 각각은 2026.10.1에서 재현됩니다.
- 모호한
Range: 암묵적 사용과 함께,A1:B2과 같은 시트 범위를Range변수에 할당하면IronXL.Range및System.Range모두와 일치하여 CS0104로 실패합니다.IronXL.Range를 작성하거나 별명(alias)을 추가합니다. - 범위에서 호출된 셀 멤버:
A1과 같은 단일 셀을 인덱싱해도 여전히IronXL.Range을 반환하므로, 그러한 결과에서AddComment을 호출하는 것은 CS1061로 실패합니다.First을 호출하여Cell에 도달하세요. - 세미콜론 파일에 잘못된 리더:
WorkBook.Load이 콤마 파일을 열로 나누었지만, 세미콜론 파일의 각 줄을 열 A에 넣고 인용된 필드가 있는 세미콜론 파일에서 FileLoadException을 발생시켰습니다. 구분자를WorkBook.LoadCSV에 전달하세요. CSV 읽기 가이드처럼 하세요.
에이전트에게 자신의 작업을 검증하게 하세요
Rebuild in Release and run the program. Then check the result yourself:
- Name the documentation page behind each IronXL member you used.
- Print IronXL.License.IsLicensed.
- Reopen every workbook the program saved.
Give me a table of file, cell, value expected, value found, and whether they agree.
CSV 필드 및 셀 값 변환
타입 변환은 두 장소에서 발생합니다. 이 결과는 .NET 9의 IronXL.Excel 2026.10.1의 결과입니다.
WorkBook.LoadCSV은 convertFieldValues 플래그를 사용하며, 기본값은 true입니다.
| CSV의 필드 | 변환 켜짐 | 변환 꺼짐 |
|---|---|---|
| 000417 (ID) | 숫자 417 | 텍스트 000417 |
| 12.50 (가격) | 숫자 12.5 | 텍스트 12.50 |
| 2026-08-30 (날짜) | 텍스트 | 텍스트 |
| "모니터 27" 매트" 후 2 | 텍스트 | 텍스트 |
| "볼트; M8 아연" | 한 필드 | 한 필드 |
인용은 RFC 4180이 설명하는 대로 작동하며, Cafe와 같은 UTF-8 이름은 바이트 순서 표시 여부와 관계없이 가져오기에서 살아남았습니다. 이스케이프된 따옴표가 있는 줄은 다음 숫자를 텍스트로 유지했으며 SUM 및 SUMIF는 텍스트를 건너뛰면서도 동일한 셀을 곱한 수식은 여전히 작동했습니다.
두 번째 장소는 Value 설정자입니다. 셀 값으로 할당된 문자열은 구문 분석되며, 한 달과 같은 형상을 가진 문자열은 날짜가 됩니다. 테스트에서 "1.5"는 2026년 1월 5일로 저장되었고, "2026-08-30"은 2026년 8월 30일로 저장되었으며, "12.50" 및 "000417"은 여전히 텍스트로 남았습니다.
따라서 CSV 필드를 문자열로 복사하는 가져오기는 8.27의 가격을 주변 46,261 근처의 날짜 시리얼로 변환할 수 있습니다. 안전한 패턴은 변환을 끄고 가져오며, 모든 열을 문화 불변으로 구문 분석하고 int, decimal, double 또는 DateTime 값을 할당하는 것입니다.
저장된 파일에서의 수식 결과
IronXL은 수식을 읽었을 때 계산하므로, IronXL을 통해 워크북을 다시 로드하는 체크는 항상 최신 답을 제공합니다. 저장된 파일은 다른 문제입니다. 계산을 하지 않는 리더들은, openpyxl 및 pandas 같은 경우, 저장된 파일의 결과만을 봅니다.
테스트에서는 SaveAs 이전에 읽히지 않거나 평가되지 않은 수식은 저장된 결과 없이 작성되었습니다. 한 번 읽힌 후 입력이 변경되고 저장된 후에도, 그 결과는 파일에 남아있었습니다. IronXL은 재로드 후 43의 새 총계를 보고했지만, openpyxl은 저장된 5를 읽었습니다. EvaluateAll 및 이후 SaveAs 후, 모든 수식은 현재 값을 가지고 있었습니다. 같은 이유로 수식 편집 가이드에서 EvaluateAll을 호출합니다.
교차 시트 참조는 예상대로 작동합니다. 주문 시트에서 범위에 SUMIF를 하는 Summary 시트는 올바르게 평가되고, 저장되고, 값을 가지고 있는 수식으로 재로드되었습니다.
IronXL에 의해 반환된 수식 텍스트
각 Orders 행이 자체 Revenue 수식 보유를 확인할 수 있지만, IronXL은 제공된 문자열을 반납하지 않습니다. 2026.10.1에서 셀 G2에 =E2*F2을 할당했으며, Formula 속성은 저장 전과 재로드 후 모두 등호 없이 E2*F2을 반환했습니다. 이는 시트 XML의 수식 요소 콘텐츠입니다. Cell.Formula에 대한 IronXL의 자체 XML 문서는 =A2+A2+A3+A4를 예제로 제공하며, 수식 편집 가이드는 수식을 쓰지만 결과만 읽습니다.
등호 없이 작성된 수식은 변경되지 않고 다시 읽히며, Value을 통해 할당된 수식은 동일하게 등호를 잃습니다. 일반 숫자를 가진 셀은 null을 반환합니다. IronXL은 제공된 대소문자와 간격을 유지하므로 =e5 * f5은 e5 * f5로 다시 읽힙니다.
따라서 =E2*F2와 수식 텍스트를 비교하는 셀프 체크는 올바른 워크북에서 실패합니다. 아래의 프롬프트에서 그러한 종류의 잘못된 실패는 이미 올바른 보고서 코드를 변경하기 위해 에이전트를 다시 단계 11로 보낼 것입니다.
전체 열은 두 번째 함정이 있습니다. Formula 속성은 모든 셀이 동일한 수식을 가지고 있지 않으면 다중 셀 범위에서 null을 반환합니다. 범위 G2:G5는 네 개의 올바른 개별 행 수식에 대해 null이었으며, E2:E5에 대해서는 동일한 답을 주었으며, 이는 전혀 수식을 포함하지 않습니다. 각 Cell에서 IsFormula을 테스트하고, 예상 문자열에서 =를 제거한 후에만 수식 텍스트를 비교하세요.
XLS 출력 제한
오래된 주문 및 회계 시스템은 여전히 XLS를 내보내며, IronXL은 이를 읽고 씁니다. 쓰기에는 XLSX에는 없는 제한이 있습니다.
| 작업 | XLSX | 2026.10.1의 XLS |
|---|---|---|
| 행 | 1,048,576 행까지 가능 뒤 예외 발생 | 65,536 행까지 가능 뒤 ArgumentException |
| 차트 | 작동 | Exception, 메시지는 XLSX를 추천 |
Password, Encrypt, 또는 SaveAs 암호와 함께 | 암호화 | ArgumentException, .xlsx, .xlsm, .xltx만 가능 |
| 텍스트 000501 | 텍스트 | 텍스트 |
DateTime | 날짜 | 날짜, IsDateTime 재로드 후 true |
IronXL이 작성한 XLS 파일은 진정한 Excel 97-2003 워크북입니다. 최초 8바이트는 D0 CF 11 E0 A1 B1 1A E1, 합성 파일 서명이며, 이는 어시스턴트가 XLSX 내용을 .xls 이름 아래 저장하지 않았음을 빠르게 확인하는 방법입니다.
시트 보호 및 파일 암호화
"암호로 보호된 워크북"을 요청하면, 어시스턴트가 두 가지 IronXL 기능 중 하나를 선택할 수 있습니다. 그들은 다르게 동작합니다.
| 로 저장 | 첫 번째 바이트 | 암호 없음 | 잘못된 암호 |
|---|---|---|---|
각 시트에 Q3-review로 ProtectSheet | 50 4B 03 04 (ZIP) | 열림 | 열림 |
암호로 WorkBook.Password, SaveAs 또는 Encrypt 열리고, 그 후 SaveAs 발동 | D0 CF 11 E0 (암호화됨) | ArgumentNullException | SecurityException, 잘못된 암호 |
모두 올바른 암호로 열립니다. ProtectSheet는 Excel 내부에서 편집을 중지하는 역할이며, 암호화하지 않습니다. 외부인이 파일을 읽지 못하게 하려면, 워크북 암호 가이드처럼 이름으로 암호화를 요청하세요. Encrypt은 암호화된 워크북을 스트림으로 반환하고, 워크북에 암호를 저장하므로 그 뒤 따르는 SaveAs은 암호화된 파일을 씁니다. 암호와 함께 WorkBook.Load이 결과를 엽니다.
재생산할 수 있는 결과
테스트는 귀하의 코드 없이 프롬프트 하나만입니다. 빈 폴더에서 새 세션을 열고 프롬프트를 붙여넣어, 반환된 것과 그 아래 패스 리스트를 비교하세요.
IRONXL_LICENSE_KEY에 있는 IronXL 체험판 또는 프로덕션 키가 필요합니다.프롬프트
Write a .NET 9 console program that merges two order exports into a regional sales workbook.
The working directory should be empty.
If a project or any source file is already there, tell me and stop.
Nobody can answer questions, so write, build, run and repair the program yourself.
Note every assumption you settle on, and put all deliverables in the project root.
1. Install the IronXL.Excel NuGet package pinned to version 2026.10.1.
Don't add any other release.
2. Use https://ironsoftware.com/excel/csharp/llms.txt and the guides it links as your reference.
Call no IronXL member they leave out.
3. At startup, assign IronXL.License.LicenseKey from the IRONXL_LICENSE_KEY environment variable.
Don't let the key appear in any file in the project folder.
The program reads that variable itself, so never print its value.
Don't list environment variables either.
If IronXL.License.IsLicensed is false, say so and exit.
4. Write a generator for the two input files.
Use random seed 2026, and create the inputs only when they're absent.
Every order in both files follows these rules:
- OrderIds are six digits with leading zeros.
- They count up from 000101 and never repeat across the two files.
- Dates fall between July 1 and September 30, 2026.
- Regions are North, South, East, and West in unequal shares.
- Quantity is 1 to 40.
- Every UnitPrice has cents other than .00.
Products come from a catalog of eight or more names.
At least two names contain each of these:
- A semicolon.
- A double quote.
- A letter outside ASCII. An accented e or a German sharp s will do.
orders.csv holds 200 orders in this shape:
- It's UTF-8 and semicolon-delimited.
- Its header is OrderId;Date;Region;Product;Quantity;UnitPrice.
- It quotes the fields with those characters in RFC 4180 style.
legacy.xls is a genuine Excel 97-2003 workbook written by IronXL.
It holds 50 further orders under the same six headers, stored like this:
- OrderId cells are text.
- Date cells are dates.
- Quantity and UnitPrice cells are numbers.
Then write manifest.csv from the generator's in-memory records:
- It's comma-delimited and quoted in the same RFC 4180 style.
- Each order gets one row with its source file and all six values.
5. Measure the inputs before the first load.
Whenever a figure falls outside its range, fix the generator and generate the inputs again.
orders.csv needs exactly 200 data rows.
Count these three kinds of rows in it separately. Each count must be 15 or more:
- Rows with a semicolon in Product.
- Rows with a double quote.
- Rows with a non-ASCII letter.
Then measure these figures:
- OrderIds that start with 0: all 250.
- Prices with cents other than .00: 225 or more.
- The first eight bytes of legacy.xls: D0 CF 11 E0 A1 B1 1A E1.
- Order counts per region: four different numbers.
- Revenue per region: every two regions at least 1,000 apart.
Once the program has loaded the inputs for the first time, orders.csv and legacy.xls are frozen.
Don't rewrite or edit them.
6. Load both inputs and save sales-report.xlsx.
Its Orders sheet holds all 250 orders under the six input headers plus Revenue:
- OrderId is text.
- OrderId, Region and Product are identical to the input.
- Date is a date, and Quantity and UnitPrice are numbers.
- Revenue is a formula multiplying Quantity by UnitPrice in every row.
The Summary sheet has the columns Region, Units, and Revenue:
- It has one row per region with Units and Revenue as SUMIF formulas over the Orders sheet.
- A Total row of SUM formulas follows the region rows.
- Add a column chart of revenue by region to Summary.
Give Revenue a currency format.
Make the header row bold and frozen on both sheets.
The saved file must hold every formula's current result.
That way a reader that never calculates formulas sees the same figures.
7. The import is one fixed procedure.
The procedure has these rules:
- Use one IronXL load call with set options per file.
- Don't parse any input file by hand.
- Apply one conversion rule per column to every row.
Loading and report code may not do any of these things:
- Open manifest.csv.
- Hold an OrderId, product name, quantity or price as a literal.
- Compare a cell with an expected value.
- Patch individual rows.
Only the round-trip code reads the manifest.
Changing the procedure between runs is your job and never the program's.
8. Save sales-report-protected.xlsx, a copy that no one can open without the password Q3-review.
Encrypt the file. Locking sheets doesn't count.
9. Build in Release and run.
10. Reload both workbooks through IronXL and write roundtrip.md.
Start with each step 5 measurement as a number, then describe the import procedure.
After that, add a table with the columns check, expected, actual, and match.
The table has 16 rows, in this order:
- The Orders row count.
- Units for each region, then revenue for each region.
- Total units and total revenue.
- How many OrderIds and how many product names in Orders match the input exactly, 250 each.
- The number of charts on Summary.
- Whether the protected copy refuses both no password and a wrong one.
- Whether Q3-review opens it with 250 orders.
Expected figures come from the manifest, and actual figures from the reloaded workbooks.
Money must agree to the cent and the rest exactly.
11. Repair the program while any of the 16 rows fails.
Each time, read the failing rows and change the import or report code.
Then build and execute the program once more.
If the eighth execution still leaves failures, stop.
List those rows, every import procedure you tried, and your explanation of the cause.
When you're done, tell me these things, even if you stopped at step 11:
- The build result.
- The number of rows matched.
- The import procedure.
- The step 5 figures.
- Your assumptions.
우리는 IronXL 2026.10.1과 seed 2026의 참조 프로그램으로 프롬프트를 보정했습니다. LoadCSV을 통해 XLSX 형식, 세미콜론 구분자 및 필드 변환을 켜고 가져온 다음 변환된 값을 복사한 것이 16개 행 중 9개와 일치했습니다. 모든 200개의 CSV OrderId가 선행 0을 잃었으며 이스케이프된 인용 후 48 개수를 텍스트로 유지했기 때문에 각 지역의 단위 수량이 부족하게 나타났습니다. 변환을 끄고 문자열을 복사해 가져온 것이 16개 중 8개와 일치했지만, 가격 8.27과 10.11이 날짜로 변환되어 북쪽의 수익이 실제값의 3.9배가 되었고 남쪽의 수익은 2.9배가 되었습니다. 명시적으로 각 열을 파싱하고 유형화된 값을 기록한 것이 seed 2026, 77, 4101, 12345에서 16개 중 16개와 일치했습니다. 이 프롬프트의 이전 초안은 IronXL 2026.9.2에서 평범한 ASCII 제품 이름, 맨 숫자 ID 및 동일한 코드로 읽는 레거시 총계로 9개 중 9개를 통과했으므로 거의 테스트되지 않았습니다.
산출
이 그림은 실행의 sales-report.xlsx에서의 Summary 시트를 렌더링한 것으로, 저장된 파일이 보유한 값과 차트에서 그린 것이며, Excel에서 찍은 스크린샷이 아닙니다. 실행의 편집되지 않은 왕복 테이블은 각 단계 5 측정, 가져오기 절차 및 16개 행을 포함합니다.
- 프로그램의 첫 실행은 5단계 점검에서 멈췄으며, 북쪽과 남쪽 모두 90개의 주문과 그들의 수익이 921.94 만큼 달랐습니다. Claude Code는 지역의 비율을 넓히고, 다시 입력을 생성하여 다음 실행에서는 모든 16개 행을 일치시켰으므로, 11단계의 수리 루프는 실행되지 않았습니다.
- 이번 실행의
orders.csv에서는 변환을 켜고 가져오기를 실행했을 때 200개의 OrderId 중 어느 것도 선행 0을 가진 텍스트로 남지 않았고, 38개의 수량을 텍스트로 남겼기 때문에 명확한 가져오기가 여기서도 실패했을 것입니다. - 프로그램을 작성하기 전에 Claude Code는 스크래치 폴더에서 IronXL의 CSV 가져오기를 시도하고, 안전한 절차를 사전에 선택했습니다. XLS를
WorkBook.Load으로 로드하며 각 열에 셀의 자체 유형을 테스트하는 하나의 규칙을 제공합니다. - 입력은 세미콜론을 가진 43개의 제품, 이스케이프된 인용을 가진 38개, 비-ASCII 문자를 가진 48개를 포함한 200개의 CSV 주문을 측정하였으며, 9개의 단계 5 측정은 범위 내에 있었습니다.
- Summary에는 8 개의 SUMIF 및 2 개의 SUM 수식이 저장된 총 5,337 단위 및 $549,169.80, 추가로 하나의 열 차트를 갖고 있습니다. 암호화된 복사본은 250개의 주문으로 Q3-review로 열립니다.
- 일부 단계는 페이지와 달리 작동했습니다. Claude Code는 파일 자체에서 CSV 행을 계산했지만, 두 파일에 걸친 수치는 생성기의 기록에서 가져갔으며,
roundtrip.md은 입력 파일에서 가져왔다고 말합니다. 그것은LoadingOptions을 통해 양쪽 입력을 로드했고, 어느 페이지llms.txt도 문서화되지 않은 채로 키를env | grep -c으로 확인하여 환경 변수를 카운트로 나열했습니다. 1, 3, 5, 7 단계 프롬프트는 동일 세션에서 차례로 사용되었습니다. 설치에서는 2026.10.1 핀을 유지하였습니다. 문서화 프롬프트는PhysicalRowCount를 API 레퍼런스에서만 찾아LoadingOptions를WorkBook.LoadCSV및WorkBook.Load로 대체했으며, 발행된 왕복 파일은 해당 가져오기를 설명합니다. 다시 16개 중 16개와 일치했습니다. 설정 프롬프트는CLAUDE.md에 규칙을 작성하고,skill.md을 프로젝트 스킬로 저장했습니다. 셀프 체크는 각 멤버의 문서 페이지를 지정하고, 샘플 셀 69개 중 69개가 일치했으며, 각 워크북의 250개 행 전체가 매니페스트와 일치했습니다. 저장된 파일에서 IronXL 없이 모든 패스 기준을 다시 측정했으며, 프로그램의 새로운 Release 빌드가 동일한 표를 생성했습니다.
통과 조건
- 프로젝트는 릴리스에서 수동 편집 없이 빌드됩니다.
roundtrip.md의 모든 16개 행이 일치하며, 지역 및 총계는 입력 파일의 총계와 같습니다.- 프로젝트 폴더를 검색해도 어느 파일에도 라이선스 키가 없습니다.
실행 기록
- 실행은 Core i9-14900KF 및 64GB 메모리를 가진 Windows 11 x64 데스크탑을 사용합니다.
- 모든 프로젝트는 .NET 9을 타겟으로 설정합니다.
- 모든 가이드는
IronXL.Excel2026.10.1을 유일 IronXL 패키지로 사용하지만 Claude Code 가이드는 2026.10.5를 설치했습니다. ChatGPT Codex는Microsoft.Extensions.DependencyInjection9.0.20을 변환기에 추가했으며, Codex, Copilot, Cursor, Antigravity 테스트 프로젝트는 xUnit을 기반으로 실행됩니다. - 가이드의 지속 시간은 페이지의 프롬프트 로깅된 시간의 합이며, 이 가이드의 행은 수락 프롬프트만 포함합니다.
- 마지막 테스트: 2026년 10월 15일, 이 가이드의 실행으로 진행되었습니다. Google Antigravity는 10월 14일 테스트되었습니다. Claude Code와 GitHub Copilot은 10월 13일, Cursor는 10월 9일, ChatGPT Codex는 2026년 10월 7일 테스트되었습니다.
| 가이드 | 보조 및 버전 | 모델 | 기간 (분) |
|---|---|---|---|
| 가이드 | Claude Code 2.1.277, 하나의 세션, 권한 프롬프트 해제 | Claude Opus 5 | 16.4 |
| Claude Code | Claude Code 2.1.277, 계획 모드의 프롬프트 3 | Claude Sonnet 5, 프롬프트 3에 Claude Opus 5 사용 | 53.8 |
| ChatGPT Codex | Codex CLI 0.160.0 | GPT-6 Luna | 59.0 |
| GitHub Copilot | GitHub Copilot CLI 1.0.97 | GPT-6 Luna, 자동 경로에 의해 라우팅됨 | 14.5 |
| Cursor | Cursor 3.23.23 데스크탑 앱 | Grok 4.7 | 53.1 |
| Google Antigravity | Antigravity CLI 1.3.5 | Gemini 3.8 Flash (높음) | 44.9 |
에이전트별 가이드
아래의 각 가이드는 한 가지 도구와 한 가지 스프레드시트 작업에 위의 단계를 적용합니다.
- Claude Code와 IronXL 사용하기로, 전체 워크북 로드 대비 메모리와 시간을 측정하여 천만 행 워크북을 읽을 때 단방향 스트리밍을 사용합니다.
- ChatGPT Codex와 IronXL 사용하기로, 혼합된 XLS, XLSX, CSV, TSV 파일이 있는 폴더를 CSV, JSON, XML로 변환하여, 각 입력에 대한 결과 행과 손상되거나 보호된 파일을 처리합니다.
- GitHub Copilot과 함께 IronXL 사용하기로, 기존 보고 솔루션의 출력을 스타일링하고, 각 워크북을 다시 로드하고 포맷을 확인하는 테스트를 수행합니다.
- Cursor와 함께 IronXL 사용하기로, Office Interop의 워크북 편집 코드를 제거하고 Interop 및 EPPlus 호출을 차단하는 규칙 아래에서 작동합니다.
- Google Antigravity와 함께 IronXL 사용하기로, 라이브 브라우저 세션에서의 업로드를 통해 ASP.NET Core 페이지가 워크북을 미리 보고, 검증하고, 정리하는 것을 증명합니다.
문제 해결
- XLS 워크북이 행이 부족해졌을 때 IronXL 파일 크기 제한
- IronXL의 라이선스 키 적용으로 첫 워크북 호출 시 LicensingException을 던졌을 때
- IronXL.XmlSerializers가 .NET 10에 있을 때 FileNotFoundException 오류가 발생하여 파일이 작성되었음에도 불구하고 디버거가 저장 호출 내부에서 멈췄을 때
질문?
질문이 있으시면 support@ironsoftware.com으로 문의하세요.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.