Cursor와 함께 IronPPT 사용법

Curtis Chau
Curtis Chau
업데이트됨: 2026년 10월 19일

AI 에이전트가 Open XML SDK에서 C# 보고서 덱 생성기를 IronPPT로 번역하여 이동할 때, 새 덱은 이전 덱과 다릅니다. Open XML SDK는 빈 패키지에서 시작합니다. 새로운 IronPPT PresentationDocument는 이미 하나의 슬라이드를 포함하고 있어, 제목 슬라이드와 각 학생당 하나의 슬라이드를 추가하는 직접 포트가 첫 슬라이드가 비어 있는 덱을 저장합니다. 테스트 결과, 같은 포트는 이전 생성기가 16:9를 썼던 곳에서 4:3 슬라이드를 생성했습니다.

Cursor는 VS Code 코드베이스에 구축된 AI 코드 편집기로, 파일을 편집하고 명령을 실행하는 에이전트를 포함하고 있습니다. 아래의 마이그레이션은 두 가지 기능, 에이전트가 읽는 문서링크와 .cursor/rules에 커밋된 프로젝트 규칙을 사용합니다. 학교의 보고서 덱 생성기를 IronPPT로 이동합니다. 생성기는 로스터 파일에서 각 클래스당 하나의 학기 보고서 덱을 작성하며, 제목 슬라이드, 학생당 하나의 슬라이드, 마무리 슬라이드로 구성됩니다. 마이그레이션된 덱은 학교에서 승인한 모든 텍스트를 유지해야 합니다.

관련된 호출에 대해서는 슬라이드 추가 가이드와 텍스트 추가 가이드를 참조하세요.

빠른 시작
NuGetNuGet으로 설치

PM > Install-Package IronPPT

위 명령을 NuGet 패키지 관리자 콘솔에 입력하거나 NuGet 패키지 관리자에서 패키지를 검색하여 IronPPT를 설치하십시오.

ReportDecks 저장소를 연 후, 이 프롬프트를 새로운 에이전트 채팅창에 붙여넣으세요.

@src/ReportDecks/ @TestData/expected/

Add an inspect command to Program.cs that prints the outline of a deck.
It runs as `dotnet run --project src/ReportDecks -- inspect <deck.pptx>`.
Before you write it, check https://ironsoftware.com/ppt/csharp/llms.txt.
From there, open the guides on adding slides and on license keys.

The command opens the deck with IronPPT and prints one line per slide, in this form:
- The slide number, a colon and a space.
- The text of each non-empty paragraph on the slide, in order, joined with " | ".

The outlines in TestData/expected use the same form.

The program reads IRONPPT_LICENSE_KEY from the environment itself.
It sets License.LicenseKey from that value before it opens or saves a deck.
Never show the license key in output, and don't dump the environment variables.
Keep IronPPT on version 2026.10.1 and leave OpenXmlDeckWriter alone for now.

Then build the term report for TestData/classes/7B.json, inspect it and show me what it prints.
Text

라이선스 키를 채팅에 붙여넣지 마세요. 에이전트가 소스 파일, 커밋 또는 빌드 로그로 복사할 수 있습니다. IronPPT 2026.10.1은 자체적으로 IRONPPT_LICENSE_KEY를 읽지 않습니다. 환경 또는 애플리케이션 설정에서 IronPPT.LicenseKey라는 이름의 설정을 찾기 때문에 프롬프트에서 코드 내에 License.LicenseKey를 설정합니다. 키 없이 메모리에서 슬라이드를 빌드하고 덱을 읽는 것이 가능했으며, 파일을 쓰기 전에 Save가 LicensingException을 던졌습니다. 다른 키 저장 장소에 대한 설명은 라이선스 키 가이드에서 확인하세요.



IronPPT 작업을 위한 어떤 Cursor 모델을 사용해야 합니까?

Composer는 Cursor의 독자적 에이전트 모델입니다. 모델 선택자는 또한 Cursor와 공동 개발한 SpaceXAI의 Grok 모델 및 OpenAI, Anthropic, Google 기타 실험실의 모델을 제공합니다. 아래의 테스트 실행에는 Composer 2.5를 사용했습니다.

IronPPT 문서를 Cursor에 어떻게 제공합니까?

IronPPT의 문서 링크를 요청에 포함하거나 팀 전체가 공유하는 규칙에 저장하세요. IronPPT의 llms.txt는 각 가이드와 API 참조를 나열하고 llms-full.txt는 16개의 문서 페이지를 하나의 파일로 요약합니다. 2026년 10월 기준으로, Cursor의 @ 메뉴는 파일, 폴더, 터미널, 채팅, Git 차이점 및 브라우저를 첨부하므로 요청은 에이전트에게 링크로 IronPPT의 문서를 제공합니다.

슬라이드 추가 가이드는 새 프레젠테이션이 이미 빈 슬라이드를 포함하고 있음을 언급합니다. IronPPT의 skill.md는 같은 객체를 새로운, 빈 프레젠테이션이라고 부르며, llms.txt 링크의 어떤 페이지도 새 덱의 슬라이드 크기를 명시하지 않습니다.

@src/ReportDecks/ParentEveningDeck.cs

Answer five questions about IronPPT, and don't change any files:
1. How many slides does a new PresentationDocument hold before AddSlide is called?
2. Where does AddSlide put the new slide, and what does it return?
3. Where does text passed to PresentationDocument.AddText end up?
4. Can IronPPT set the slide size, and what size does a new deck use?
5. Can IronPPT write speaker notes?

Base every answer on https://ironsoftware.com/ppt/csharp/llms.txt or a page it links to.
Name the page each answer comes from.
If no page answers a question, tell me so rather than guess.
Text

IronPPT 관습을 인코딩하는 프로젝트 규칙을 어떻게 작성합니까?

프로젝트 규칙은 .cursor/rules에 저장되고 저장소와 버전이 관리되는 .mdc 파일입니다. Cursor는 해당 폴더의 보통 .md 파일은 무시합니다. 프론트매터가 없는 파일은 규칙을 언제 로드할지 결정할 방법을 제공하지 않기 때문입니다.

아래 규칙은 globs에 파일 패턴을 콤마로 구분하여 나열하고 alwaysApply를 false로 설정합니다. 그런 다음 Cursor는 덱 코드 또는 테스트와 관련된 요청에 대해 규칙을 로드합니다. .cursor/rules/ironppt-decks.mdc로 저장하세요.

---
description: IronPPT conventions for the report deck code
globs: src/ReportDecks/**/*.cs, tests/**/*.cs
alwaysApply: false
---

Follow these rules in the report deck code:
- Build decks with IronPPT 2026.10.1 from NuGet, namespace IronPPT.
- Don't add another presentation package.
- Look up IronPPT members in https://ironsoftware.com/ppt/csharp/llms.txt and its linked pages.
- The program reads the key from IRONPPT_LICENSE_KEY.
- Never write the key to output or files.
- A new PresentationDocument starts with one slide already, and AddSlide appends after it.
- Fill that first slide, or remove it once the deck has another slide.
- A new PresentationDocument is 4:3.
- For a 16:9 deck with the school's title slide, open TestData/templates/hollybrook-16x9.pptx.
- On slides you add, put the lines in one TextBox as Paragraphs.
- Each AddText call on a slide creates another text box of the same size, with no position.
- PresentationDocument.AddText joins its text to the last paragraph of the last slide.
- Don't use PresentationDocument.AddText.
- Check every deck you save with the inspect command against TestData/expected.
- If an IronPPT member isn't in the docs, say so and cite the page you searched.
Markdown
유의 사항: Cursor는 또한 루트 또는 하위 폴더의 AGENTS.md를 읽습니다. 해당 파일에는 전방 프로세서가 없고 파일 패턴도 없으므로 패턴 기반 규칙은 .cursor/rules에 속해야 합니다.

규칙은 에이전트 요청에 적용됩니다. Cursor의 규칙 페이지는 규칙이 Tab에 영향을 주지 않으며 사용자 규칙이 인라인 수정에 적용되지 않는다고 명시하므로, 규칙과 수동으로 그 제안을 검토하세요.

Open XML SDK 호출을 IronPPT로 어떻게 매핑합니까?

Open XML SDK는 패키지를 부분별로 쓰며, 따라서 이전 생성기는 슬라이드 마스터, 레이아웃, 테마 및 노트 마스터도 생성합니다. IronPPT는 그러한 부분들을 스스로 생성합니다.

Open XML SDKIronPPT
PresentationDocument.Create 프레젠테이션 부분, 마스터, 레이아웃 및 테마와 함께new PresentationDocument(), 또는 템플릿 경로가 있는 생성자
프레젠테이션 부분에 추가되고 SlideIdList에 나열된 SlidePart슬라이드를 추가하는 AddSlide(new Slide())
A.Run 및 A.Paragraph로 채워진 제목 및 본문 플레이스홀더TextBox, 한 Paragraph마다 한 줄씩 있는 Slide.AddChild
기존 플레이스홀더의 텍스트로드된 템플릿 슬라이드의 Texts[i].Text
SlideSize도 12192000 by 6858000으로 설정됨대응되는 것이 없으므로, 조정 크기가 템플릿에서 입력됨
슬라이드당 하나의 NotesSlidePart동등한 것 없음
파일이나 어떤 Stream에든 저장되는 Save파일 경로에만 있는 Save(string)

IronPPT.dll은 Open XML SDK 타입의 자체 사본을 삽입하며 모두 내부적으로 되어 있어, 마이그레이션 동안 양쪽 패키지가 참조되었습니다.

새로운 IronPPT 덱이 추가 슬라이드로 시작하는 이유는 무엇입니까?

새 PresentationDocument의 내장 슬라이드는 제목과 부제목 플레이스홀더가 비어 있는 제목 레이아웃을 사용합니다. 그 후에 AddSlide가 추가되어 제공받은 슬라이드를 반환하므로, 직접 포트의 모든 슬라이드는 서명된 개요보다 한 위치 후에 나타납니다.

그 슬라이드를 너무 일찍 제거하려고 하면 실패합니다. 유일한 슬라이드인 동안에 Remove를 호출하면 프레젠테이션에는 최소한 하나의 슬라이드가 포함되어 있어야 한다는 InvalidOperationException이 발생합니다. 두 번째 슬라이드가 존재하면, 같은 호출이 성공적으로 이루어졌습니다.

슬라이드 크기가 두 번째 차이점입니다. 새로운 덱은 9144000 by 6858000 EMU로 측정되었으며, 이는 4:3 슬라이드입니다. API 참조에는 예제가 포함되어있으며, Slide.Width 및 Slide.Height로서 너비를 960 포인트로 설정하지만, 어느 속성도 덱의 슬라이드 크기를 변경하지 않습니다. 960 by 540 포인트로 설정하는 것은 슬라이드의 도형의 크기에 12192000 by 6858000 EMU를 썼지만, ppt/presentation.xml의 슬라이드 크기는 9144000 by 6858000 EMU로 남겼습니다. 16:9 파일에서 로드된 덱은 저장 시 12192000 by 6858000 EMU를 유지하고, 동시에 해당 플레이스홀더와 노트를 유지했습니다. 따라서 저장소는 TestData/templates/hollybrook-16x9.pptx에 학교의 제목 슬라이드를 유지합니다.

IronPPT로 마이그레이션을 계획하고 실행하는 방법은 무엇입니까?

채팅 입력에서 Shift+Tab을 눌러 Plan Mode가 선택될 때까지 진행한 후, 아래 요청을 보내세요. Cursor는 계획을 편집 가능한 Markdown 파일로 작성합니다.

@src/ReportDecks/OpenXmlDeckWriter.cs @TestData/expected/7B-term-report.txt

Plan how to move the term report deck from the Open XML SDK to IronPPT.
Don't write any code until I approve the plan.
Leave ParentEveningDeck out of it, since it already uses IronPPT.

The plan needs to answer these questions:
- Which IronPPT call replaces each Open XML SDK step the writer takes?
- How does the deck keep 16:9 slides and avoid an extra blank slide?
- Where do the tutor comments go, given that they're speaker notes today?
- How does the build command keep its arguments and its output path?

Roster.cs and DeckText.cs stay as they are.
End with a list of the assumptions you made.
Text

계획의 오류를 수정하세요. 그런 다음 Plan Mode에서 계획을 구축하거나, Agent로 전환하여 이 요청을 보내세요.

@ironppt-decks

Go ahead with the approved plan.

If IronPPT can't write speaker notes, the tutor comments go in a text file beside the deck:
- For out/7B-term-report.pptx, the file is out/7B-term-report.comments.txt.
- It holds one "Name: comment" line per pupil, in roster order.

Work through these steps in order:
1. Build and inspect the 7B term report.
2. Count the lines that match TestData/expected/7B-term-report.txt.
3. Replace OpenXmlDeckWriter with an IronPPT class named TermReportDeck.
4. Remove DocumentFormat.OpenXml from the project file.
5. Build the solution, then build, inspect and count again.

Tell me both match counts, before and after, and show me the diff.
Text

@ironppt-decks 언급은 이름으로 규칙을 첨부합니다.

Cursor의 어떤 기능이 각 변경에 적합합니까?

변경의 범위에 따라 기능을 선택하세요. Tab은 개발자가 시작한 편집을 완료합니다. 한 문장으로 설명할 수 있는 선택 항목에는 인라인 편집을 사용하세요(Ctrl+K). Agent는 여러 파일에 대한 변경 및 빌드가 필요한 작업을 처리하며, Plan Mode는 Agent가 코드를 변경하기 전에 검토할 계획을 추가합니다.

이 요청을 Agent에 보내세요. 변경되는 메서드를 명명하기 때문에 에디터에서 선택이 필요하지 않습니다.

@src/ReportDecks/

Make TermReportDeck.Write check its own output once it saves the deck:
- Reopen the saved deck with IronPPT.
- Throw if the slide count isn't the pupil count plus 2.
- Throw if any slide has no text, with that slide's number in the message.

Have the build command print that message and exit with code 3.
Then build the decks for TestData/classes/7B.json and TestData/classes/8A.json.
Show me what each build prints.
Text

IronPPT가 슬라이드가 추가한 텍스트를 어떻게 배치합니까?

하나의 슬라이드에서 다섯 Slide.AddText 호출은 동일한 본문 플레이스홀더에 1905000 by 1270000 EMU의 다섯 모양을 생성했습니다. AI 에이전트 허브는 왜 그러한 모양이 한 위치를 공유하는지 설명합니다. 한 Paragraph당 하나의 TextBox은 정렬된 순서로 라인을 가진 하나의 모양을 줍니다. 기본 크기에 남겨진 박스는 개요 검사에서 감지되지 않으며, 이는 텍스트만 읽기 때문입니다.

PresentationDocument.AddText은 슬라이드 방법과 다르게 동작합니다. 이는 마지막 슬라이드의 마지막 단락 끝에 새 실행으로 텍스트를 추가했으며, 공간이나 줄 바꿈이 없습니다. Slide.Texts를 다시 읽을 경우, 두 실행은 별도의 항목으로 나타납니다. Slide.Paragraphs는 뷰어가 보는 라인을 반환하며, 이는 점검 명령이 단락을 읽는 이유입니다.

IronPPT가 이미 작성한 덱을 디버그하는 방법은 무엇입니까?

부모 상담 덱은 마이그레이션 전부터 IronPPT를 사용하고 있었습니다.

@src/ReportDecks/ParentEveningDeck.cs @TestData/expected/7B-parents-evening.txt

Find out why none of the 7B evening deck's lines match 7B-parents-evening.txt.
The office also reports black bars at the sides when the hall screen shows it.

Diagnose it before you touch any code:
1. Build the evening deck, inspect it and compare it with the expected outline.
2. List each line that differs.
3. Explain what in ParentEveningDeck causes each difference.

After that, fix ParentEveningDeck and keep it on IronPPT.
Add the output check the term report has, with pupils plus 1 as the slide count.
Inspect the deck again and tell me how many lines match before and after the fix.
Text

산출

아래 그림은 수정 전의 덱에서 한 약속 슬라이드를, 그리고 수정 후의 덱에서 한 슬라이드를 보여줍니다.

수정 전 부모 상담 덱의 슬라이드 3은 두 개의 겹치는 텍스트 도형을 가진 4:3 슬라이드입니다.

수정 전 부모 상담 덱의 슬라이드 3은 저장된 파일의 XML에서 그려졌으며, 4:3 슬라이드는 같은 위치에 두 개의 텍스트 도형을 포함합니다. 그림은 저장된 기하학을 보여주며, 파워포인트 렌더링이 아닙니다.

수정 후 부모 상담 덱의 슬라이드 2는 작은 텍스트 박스를 가진 16:9 슬라이드입니다.

수정 후 부모 상담 덱의 슬라이드 2는 저장된 파일의 XML에서 그려졌으며, 16:9 슬라이드는 1905000 by 1270000 EMU의 하나의 텍스트 박스를 포함합니다. 그림은 저장된 기하학을 보여주며, 파워포인트 렌더링이 아닙니다.

덱에 대한 회귀 테스트를 작성하는 방법은 무엇입니까?

@src/ReportDecks/ @TestData/

Write xUnit tests in tests/ReportDecks.Tests and add that project to the solution.

The tests cover these cases:
- The 7B term report matches every line of TestData/expected/7B-term-report.txt.
- The 7B evening deck matches every line of TestData/expected/7B-parents-evening.txt.
- Both decks are 16:9, which is 12192000 by 6858000 EMU in ppt/presentation.xml.
- Every slide after the first keeps its text in one text box.
- The 8A term report has 5 slides, with pupils in roster order.
- The comments file has one line per pupil, in roster order.
- The output check throws for a saved deck with an empty slide and names that slide.

If the output check has no method of its own that takes a saved deck, add one.
Write test decks to a temp folder, not to out/.
Run dotnet test, then give me the pass and fail totals.
Text

Slide.Width 및 Slide.Height는 새 덱과 열려 있는 16:9 덱에서 빈 값을 반환하여, 크기 테스트는 ppt/presentation.xml을 읽습니다.

실제 실행에서 프롬프트가 무엇을 생성했습니까?

아래의 모든 빌드 및 검사는 코드가 변경된 모든 커밋의 새 릴리스 빌드에서 반복되었으며, 별도의 스크립트는 저장된 모든 덱을 읽었습니다.

  • 이동 전 Open XML SDK 덱은 승인된 개요의 모든 8줄과 일치했습니다.
  • IronPPT로 이동한 후, 학기 보고 덱도 모든 8줄과 일치했습니다.
  • 마이그레이션된 덱은 학교의 템플릿을 열어 12192000 by 6858000 EMU의 16:9 슬라이드를 유지했습니다.
  • Cursor는 템플릿의 제목 슬라이드를 채워 7B 덱은 8개의 슬라이드를 가지고 빈 슬라이드가 없었습니다.
  • 각 학생 슬라이드는 자체 위치가 없는 1905000 by 1270000 EMU 텍스트 박스에 텍스트가 포함되었습니다.
  • Open XML SDK 덱에는 6개의 노트 슬라이드가 있었고, IronPPT 덱에는 없었습니다.
  • 여섯 개의 튜터 코멘트는 7B-term-report.comments.txt로 갔으며, 로스터의 순서로 학생당 한 줄씩이었습니다.
  • Cursor는 인용된 페이지의 5개의 문서 질문에 대답했으며 파일을 변경하지 않았습니다.
  • Cursor는 PresentationDocument.AddText가 텍스트를 어디에 놓는지를 명시한 페이지를 찾지 못했습니다.
  • 슬라이드 크기에 대해 Cursor는 Slide.Width와 Slide.Height를 인용했습니다. 그 답변은 틀렸습니다.
  • 출력 검사는 빈 학생 항목이 있는 로스터를 거부하고, "슬라이드 2에 텍스트가 없음"이라고 인쇄한 후 코드 3과 함께 종료했습니다.
  • 수정 전 저녁 덱은 7개 줄 중 0개와 일치하며 4:3 슬라이드를 사용했습니다.
  • 수정 후 저녁 덱은 7개의 7개 줄 모두 16:9 슬라이드와 일치했습니다.
  • Cursor가 보고한 일치 수치는 두 덱 모두에서 독립적인 검사와 일치했습니다.
  • xUnit 스위트는 요청된 7개의 케이스를 포함하여 9개의 테스트 중 9개를 통과했습니다.
  • 모든 Release 빌드는 오류가 없었고 테스트 프로젝트는 1개의 xUnit 분석기 경고를 추가했습니다.
  • 일부 단계는 페이지와 달리 작동했습니다. 모든 7개의 프롬프트는 하나의 헤드리스 세션에서 Cursor CLI를 통해 진행되었습니다. CLI는 03 프롬프트의 발표자 노트와 05 프롬프트의 오류 출력에 대한 Cursor의 질문을 건너뛰었습니다. 세션이 재개될 때 프롬프트 05에서 07은 Plan Mode에서 실행되었으므로, 후속 메시지인 "계획을 빌드합니다."가 각 계획을 수행했습니다. 04 프롬프트에서의 차이에 대해, Cursor는 코드 변경을 보여주는 대신 예상 파일과 개요를 비교했습니다.

GitHub Copilot 가이드는 글로벌과 마찬가지로, 출처 및 테스트 프로젝트와 경로별 지침 파일에 제한된 일부 IronPPT 관습을 제한합니다. Claude Code 가이드 또한 덱 생성기가 작성되기 전에 계획을 승인합니다. 런 레코드는 이 실행의 Cursor 버전, 모델 및 지속 시간, 그리고 테스트 기계를 나열합니다.


문제 해결


질문?

질문이 있으시면 support@ironsoftware.com으로 문의하세요.

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 7,110버전:2026.11방금 출시