IronPPT를 ChatGPT Codex와 함께 사용하는 방법
영업 운영 팀은 매주 월요일마다 같은 자료를 보냅니다. 템플릿은 슬라이드를 제공하고, 그 주의 수치는 이를 채웁니다. 단일 지역 슬라이드는 지역별 한 슬라이드가 되고, 오래된 홍보 슬라이드는 제거되며, 부록은 파일에 남지만 슬라이드쇼에는 나오지 않습니다. 슬라이드 작업이 조용히 실패할 때, 자료는 여전히 저장되고 작업 로그는 여전히 성공을 보고합니다. 지역 관리자들은 6월 30일에 종료된 홍보 요약을 그 주의 하이라이트보다 한 슬라이드 앞서 받습니다.
ChatGPT Codex는 OpenAI의 코딩 에이전트입니다. 리포지토리에서 작동하여 파일을 편집하고 dotnet run 같은 명령을 실행하며 변경 사항을 보고합니다. 같은 에이전트가 터미널, IDE 확장, ChatGPT 데스크톱 앱 및 클라우드에서 실행됩니다. IronPPT는 Iron Software의 .NET 라이브러리로, Microsoft Office 없이 .pptx 파일을 생성, 열기, 편집 및 저장합니다.
Codex는 주간 영업 템플릿, 규칙 파일 및 2주의 지역 데이터를 받습니다. 보고된 각 슬라이드 수는 같은 턴에 작성된 CSV에서 오고, 각 슬라이드 작업은 배치 코드가 그것에 의존하기 전에 저장된 자료에서 테스트됩니다.
빠른 시작.NET 9 콘솔 프로젝트에서 Codex를 시작합니다. 이 프로젝트에는 템플릿과 데이터 폴더가 포함되어 있습니다.
$ironppt Install IronPPT 2026.10.1 in this console app and list the slides of the sales template.
Program.cs opens Templates/weekly-sales-template.pptx and saves nothing.
Each slide gets a row in out/quickstart.csv, with these columns:
- number, counting from 1
- heading, the first text on the slide
- texts, how many text items the slide holds
- shown, yes or no from the slide's Show property
Program.cs reads IRONPPT_LICENSE_KEY itself and copies it into License.LicenseKey.
Never print the key or write it to a file or log, and don't list environment variables.
If three builds or runs fail, stop and show me the last error.
Otherwise, read the slide count back from the CSV and tell me the number.
$ironppt 언급은 Codex가 코드를 작성하기 전에 IronPPT의 기술을 로드합니다.
최소 워크플로우(5단계)
- NuGet에서 C# PowerPoint 라이브러리 다운로드
- IronPPT의 기술을 .agents/skills/ironppt/SKILL.md로 저장하여
$ironppt언급이 해결되도록 하십시오. - 덱 규칙을 명명하고 열린 덱만 증거로 수용하는 AGENTS.md를 커밋하십시오.
Remove()를 사용하여 슬라이드를 제거하고 이동하거나 반복되는 슬라이드를 새 슬라이드로 작성하십시오.- 저장된 덱을 다시 열고 모든 슬라이드를 계획과 비교하십시오.
.NET 프레젠테이션 작업에 ChatGPT Codex는 무엇이고 어디에 적합합니까?
/permissions 명령은 Codex가 파일을 편집하거나 명령을 실행할 때 물어보지 않고 그렇게 하도록 설정합니다. Codex CLI 문서는 설치 및 터미널 사용을 다루고, 오픈 소스 리포지토리는 릴리스를 게시합니다.
IronPPT에 대한 Codex의 지식은 학습 데이터와 제공된 파일에서 나옵니다. IronPPT에 없는 멤버 이름은 빌드를 실패시킵니다.
IronPPT는 .NET Standard 2.0 어셈블리를 제공하며, 그 NuGet 패키지는 Windows, Linux 및 macOS를 나열합니다. 테스트 실행은 Windows에서 프로젝트를 빌드했습니다.
IronPPT 프롬프트를 작성하고 Codex를 설정하는 방법은 무엇입니까?
아래 프롬프트는 템플릿과 데이터(Templates/weekly-sales-template.pptx 및 Data/week-41.csv)와 규칙(Data/README.md, 순서, 생략 및 숨긴 슬라이드와 스타일을 지정하는)을 명명합니다.
Codex는 작업 디렉토리에서 리포지토리 루트까지의 모든 폴더에서 .agents/skills를 스캔합니다. 각 기술은 이름과 설명을 정의하는 SKILL.md를 포함하는 폴더입니다. IronPPT의 skill.md를 .agents/skills/IronPPT/SKILL.md로 저장하면 $ironppt 언급이 해결됩니다. 이 기술은 IronPPT 2026.8.1과 비교되어 확인되었다고 말하지만, 이 가이드는 2026.10.1을 설치합니다.
Codex는 작업을 시작하기 전에 AGENTS.md를 읽습니다. 리포지토리 루트에서 작업 폴더로 내려가면서 각 디렉토리에 최대 한 파일을 가져오고, 더 깊숙한 파일이 더 얕은 파일을 덮어쓰도록 합니다. /init 명령은 첫 번째 초안을 생성합니다.
Write an AGENTS.md in the repository root, under a heading called Weekly sales deck.
Put these rules in it, one per line:
- IronPPT 2026.10.1 is the only PowerPoint library here. Package and namespace are both IronPPT.
- Don't add DocumentFormat.OpenXml or any other Office package.
- Data/README.md defines the deck, and it wins over anything else.
- Templates/ and Data/ are read-only.
- Look up IronPPT members in the ironppt skill under .agents/skills/ironppt/.
- A probe on a saved deck outranks both the skill and the installed IronPPT.xml.
- A deck counts as built only once it's saved, reopened from disk and checked.
- Every count you report comes from a CSV written in that turn. The reply names that CSV.
- The key stays in IRONPPT_LICENSE_KEY.
Show me the finished file.
IronPPT를 추가하고 라이센스를 확인하도록 Codex에 요청하는 방법은 무엇입니까?
Show me the IronPPT PackageReference in WeeklySalesDeck.csproj and the version NuGet resolved.
Then quote the full output of dotnet list package with --include-transitive.
Don't change any package references.
IronPPT 2026.10.1은 IronSoftware.Common 2026.4.2 및 IronSoftware.System.Drawing 2026.8.2에 의존하며, 테스트 실행의 패키지 목록은 30개의 간접 패키지를 보여주었으며, 그 중 SixLabors.ImageSharp 3.1.12 및 Grpc.Net.Client 2.62.0이 포함되어 있습니다. 릴리스를 고정하기 전에 IronPPT 변경 로그를 검토하십시오.
키 없이 IronPPT는 덱을 열고 텍스트를 읽고, 슬라이드와 텍스트를 추가하며, 슬라이드를 숨깁니다. Save만 라이센싱 예외 "Production License Required" 메시지를 생성하며 파일은 작성되지 않았습니다. IronPPT는 IronPPT.LicenseKey 또는 IRONPPT_LICENSEKEY 환경 변수에서 스스로 키를 읽지만 IRONPPT_LICENSE_KEY는 무시합니다. 동일한 이름으로 키를 유지하는 코드는 첫 번째 저장 전에 License.LicenseKey를 할당합니다. 라이센싱 예외 유형은 IronPPT 2026.10.1에서 공용이 아니므로 핸들러가 Exception을 포착하고 유형 이름을 확인합니다.
Move the key line into Startup.ApplyIronPptKey and call that method first in Program.cs.
It sets License.LicenseKey from IRONPPT_LICENSE_KEY, then prints License.IsLicensed.
Next, test what IronPPT does without a key.
Start the program three times as child processes, each with a --licence-check option:
1. Clear IRONPPT_LICENSE_KEY for that child only.
2. Keep the variable set, and pass a --no-startup flag that skips the Startup call.
3. Keep the variable set and the Startup call in place.
Each child opens the template, replaces {{WEEK}} with 41 and saves out/licence-check-N.pptx.
Write each call to out/licence-check.csv, with run, call, result, exception type and message.
Add a column that says whether each pptx file exists afterwards.
If three repair attempts fail, stop there.
Tell me which of the three runs saved a file.
라이센스 키 페이지는 키를 제공하는 다른 방법을 나열합니다.
가이드의 슬라이드 코드가 덱을 변경하지 않는 이유는 무엇입니까?
슬라이드 관리 가이드는 Slides.RemoveAt으로 슬라이드를 제거하고, Slides.Remove와 Slides.Insert를 이어서 사용하여 하나를 이동하며, IronPPT 기술은 Slides를 변경 가능한 목록으로 설명합니다. IronPPT 2026.10.1에서 PresentationDocument.Slides은 읽을 때마다 새로운 목록을 반환하며, 이러한 호출은 오직 그 사본만 변경합니다. 게이지에서, Slides.RemoveAt(0)을 로드된 6슬라이드 덱에서 적용했을 때 갯수가 6으로 남아 있었고, 이동 후 저장된 덱은 원래 순서를 유지했습니다. 코드는 컴파일되고 예외를 발생시키지 않으며 제거할 슬라이드를 저장합니다.
기존 슬라이드에서 세 가지 작업이 덱에 도달합니다. 슬라이드 자체에 Remove()을 호출하면 저장된 파일에서 삭제되고, Show = false은 파일에 남는 숨은 슬라이드를 작성합니다. Slide.Index을 설정하면 슬라이드가 이동하며, 별도의 검사가 새로운 순서로 저장된 덱을 다시 엽니다.
Probe which slide operations survive a save, in a console app at scratch/slides-probe/.
Run it yourself on a copy of the template in scratch/, and apply the key the way Startup does.
Add a Compile Remove item that keeps scratch/** out of WeeklySalesDeck.csproj.
Give each case its own try block and its own saved file.
Reopen each saved file and measure these cases:
- Slides.RemoveAt(4), and whether the slide count drops
- Slides.Remove, then Slides.Insert(1, ...) on Highlights, and the order that results
- Remove() on the Q2 Promotion Recap slide itself
- Clone() on the region slide
- AddSlide(new Slide()) with AddText, and where the new slide ends up
- Show = false on the appendix
Then have the explorer agent read IronPPT.xml and the ironppt skill, writing nothing.
It reports what each source says about the Slides collection and about Clone.
Put every finding in out/slides-probe.csv, quoting the probe output, the XML or the skill.
Mark the rows where the skill and the probe disagree, and tell me which they are.
편집된 리스트 객체와 비교한 검사는 통과합니다. 그 사본이 변경되었기 때문입니다.
템플릿에서 주간 자료를 구축하는 방법은 무엇입니까?
슬라이드 관리 가이드는 슬라이드 복제를 다루지 않습니다. IronPPT 2026.10.1에서 슬라이드에 Clone()을 호출하면 MissingMethodException을 던지고 동일한 슬라이드 객체를 두 번 추가해도 저장된 파일에 추가 슬라이드가 없습니다. 슬라이드를 제거하고 끝에 다시 추가하면 이전 위치에 비어 있는 슬라이드가 남았습니다. 작동하는 방법은 각 출력 슬라이드를 위한 새로운 Slide을 추가하고, 자료가 필요한 순서대로 새로운 텍스트로 채운 다음 템플릿 원본에서 Remove()을 호출하는 것입니다.
로드된 덱에서 스타일을 복사하는 것도 실패합니다. 게이지에서, 36pt 머리글이 속성별로 복사되었을 때 3,600pt에 작성되었고, 색상 #1F4E79는 검정색이 되었습니다. 따라서 요청이 README의 스타일을 모든 텍스트에 설정합니다.
README의 슬라이드 목록에는 템플릿이 있는데, Q2 홍보 요약이 다섯 번째로, 하이라이트가 여섯 번째에 있습니다.
weekly-sales-template.pptx 다운로드
테스트 실행에서 사용된 주간 영업 템플릿으로, 지역 토큰을 가진 한 지역 슬라이드가 있습니다.
Have the worker agent write Services/DeckAssembler.cs. It builds the deck Data/README.md describes.
DeckAssembler accepts these options:
- --week, which picks Data/week-NN.csv and Data/week-NN.tokens
- --template, defaulting to Templates/weekly-sales-template.pptx
- --plan, which writes out/deck-plan.csv and saves no deck
- --build, which saves out/week-NN.pptx
The probe showed which calls reach the saved file.
Build the deck with those calls, in these steps:
1. Open the template and find each slide by its heading.
2. For every output slide, add a new slide with AddSlide and write its texts with AddText.
3. Set the README's house style on every text you write.
4. Set Show = false on the new appendix slide.
5. Call Remove() on the eight template slides, then save.
The plan CSV has one row per output slide, with position, template heading, final heading and shown.
Run --plan --week 41, then give me the row count and the hidden slides from the CSV.
Codex가 저장한 덱을 어떻게 확인합니까?
Run --build --week 41, then check the saved deck with code that's separate from the build.
The check reopens out/week-41.pptx and writes out/week-41-check.csv with these columns:
- position and heading
- shown
- the slide's full text, joined with " | "
- whether any {{ is left
Compare the check CSV with out/deck-plan.csv row by row.
Tell me which rows differ, and whether Q2 Promotion Recap appears anywhere in the deck.
산출
DeckAssembler는 주간 41을 위한 덱을 아래와 같이 저장했으며, 변경 없이 게시되었습니다.
IronPPT가 저장한 주간 41 영업 덱입니다.
템플릿이 변경되었을 때 무슨 일이 발생합니까?
Show me that DeckAssembler refuses Templates/weekly-sales-template-v2.pptx.
Marketing sent it with Highlights renamed to Wins This Week.
Run --build --week 41 --template Templates/weekly-sales-template-v2.pptx.
The existing out/week-41.pptx has to stay the same, byte for byte.
Record the attempt in out/template-check.csv with these columns:
- exit code and message
- the headings the build found
- the SHA-256 of out/week-41.pptx before and after
Tell me whether the two hashes match.
스크린샷에서 슬라이드를 어떻게 확인합니까?
Codex는 이미지를 컨텍스트로 수용합니다. 세션 시작 또는 재개 시 -i 플래그(긴 형식 --image)와 함께 전달하거나 상호작용 작곡기에 붙여 넣습니다.
Check the screenshot I attached with -i against the data and the deck.
A regional manager sent it and says the West revenue is wrong.
Don't change any code, and work through these steps:
1. Read the region and its three figures from the image.
2. Compare them with Data/week-41.csv and Data/week-40.csv.
3. Compare them with the West slide in out/week-41.pptx, using its text in out/week-41-check.csv.
4. Write the comparison to out/screenshot-check.csv.
Tell me which week the screenshot shows, and whether out/week-41.pptx is right.
잘못된 덱 출력을 처음부터 끝까지 디버그하는 방법은 무엇입니까?
Find out why the week 40 deck went out wrong. Data/week-40-complaint.md lists four problems.
Logs/week-40/deck.log says every step worked. Output/week-40.pptx is the deck that was sent.
Have the explorer agent read Jobs/LegacyWeeklyDeck.cs, the log and the deck before anything else.
A throwaway script under scratch/ may read the deck.
Don't edit any code outside scratch/.
Write out/week-40-diagnosis.md and cover these points in it:
- the line behind each of the four problems
- why the log reported success anyway
- the smallest fix for each, based on what the probe showed
Then give me one line per problem.
수정을 허용하기 전에 진단을 검토하십시오. 레거시 작업은 호출이 반환된 후 각 로그 라인을 작성하고 덱을 다시 열지 않았습니다.
1회성 코드를 재사용 가능한, 테스트된 구성요소로 어떻게 변환하나요?
Ask the worker agent for a DeckService class that meets these conditions:
- It resolves from a Microsoft.Extensions.DependencyInjection container.
- A DeckOptions record configures it, with week, template, plan-only and output folder.
- It keeps the README rules, the heading check and the house style from DeckAssembler.
- DeckService.cs stays below 150 lines, and its public members have XML doc comments.
- Nothing calls Jobs/LegacyWeeklyDeck.cs.
Then build week 41 with DeckService into out/final/week-41.pptx.
Check that deck the way you checked out/week-41.pptx, into out/final/week-41-check.csv.
Compare the two check files and list every difference.
리팩터링은 헤딩 검사를 제거해도 컴파일할 수 있습니다.
Add an xUnit project at tests/WeeklySalesDeck.Tests, in the same solution as the main project.
Exclude tests/** from what the main project compiles.
The tests get the key through Startup.ApplyIronPptKey.
Each test builds a deck in a temp folder and reopens it.
Between them, the tests check these conditions:
- week 41 gives 11 slides, with Highlights second and the appendix hidden
- the five region slides follow the CSV order
- East shows Revenue: $0 and still has its slide
- no {{ is left anywhere, and Q2 Promotion Recap is gone
- the v2 template is refused, and the message names the missing heading
Run dotnet test with --logger trx and --results-directory out/tests/.
Read the trx file and tell me how many tests passed and failed.
API 질문에는 설치된 IronPPT.xml이 AddSlide, Remove, Clone, Index 및 Show와 같은 슬라이드 멤버를 문서화합니다. 탐사 결과는 이들이 저장된 덱에 도달하는지를 보여줍니다.
$ironppt List the members in the installed IronPPT.xml that add, remove, move, copy or hide slides.
For each member you find, tell me these two things:
- what the XML says it does
- whether out/slides-probe.csv or the trx file in out/tests/ shows it working on a saved deck
Then write one compiling line per member in a probe project under scratch/api-probe/.
Build that probe with dotnet build, but don't run it.
다른 덱에 이러한 프롬프트를 재사용하는 방법은 무엇입니까?
템플릿, 데이터 파일 및 README 규칙이 변경되면, 같은 프롬프트가 이사회 자료, 프로젝트 상태 덱 또는 고객 리뷰에 적용됩니다. 모든 어시스턴트에 적용되는 설정은 IronPPT AI 코딩 어시스턴트 가이드를 참조하십시오.
실제 실행에서 프롬프트가 무엇을 생성했습니까?
위의 프롬프트는 Codex로 한 세션에서 순서대로 전달되었습니다. 디버깅 프롬프트 전에 레거시 작업, 로그 및 덱이 추가되었습니다. 개별 스크립트는 저장된 모든 덱을 다시 열고 파일에서 각 슬라이드를 읽었습니다.
- 실행 전, 템플릿은 모두 표시된 8개의 슬라이드를 보유했습니다.
- 변수를 지우고, 저장이 라이센싱 예외를 던졌고 이후 출력 파일이 존재하지 않았습니다.
- 변수를 설정하고 시작 호출을 건너뛰어 저장이 동일한 방식으로 실패했습니다.
- 탐사에서 Slides.RemoveAt(4)는 저장된 파일에 모든 8슬라이드를 남겼습니다.
- 지역 슬라이드에서 Clone()이 MissingMethodException을 던졌습니다.
- Codex는 세 개의 하위 에이전트를 시작했으며, 디버깅 프롬프트는 탐사 프롬프트에서 탐색 에이전트를 재사용했습니다.
- 저장된 주간 41 덱은 README 순서로 11개의 슬라이드를 보유했으며, 5개의 지역 슬라이드는 CSV 순서에 있었습니다.
- 10개의 슬라이드가 표시되었으며, 부록은 숨긴 상태로 저장되었습니다.
- Q2 홍보 요약은 덱에서 부재했습니다.
- East는 $0의 수익을 가진 슬라이드를 유지했습니다.
- 거부된 v2 템플릿은 기존 덱의 SHA-256 해시를 변경하지 않았습니다.
- Codex는 스크린샷을 주간 40의 West 수치와 매칭했습니다.
- 진단은 주간 40의 네 가지 문제를 레거시 작업의 줄과 연결했습니다.
- 진단은 Slides.Last()가 반환한 재사용된 지역 슬라이드로 숨긴 North 슬라이드를 추적했습니다.
- DeckService로 구축된 덱은 모든 슬라이드에서 첫 번째 빌드와 일치했습니다.
- Codex의 실행과 우리의 실행에서 모든 5개의 테스트가 통과했습니다.
- 일부 단계는 페이지와 달리 작동했습니다. NuGet 패키지는 실행 전 복원된 캐시에서 가져왔습니다. 샌드박스에 네트워크가 없었기 때문입니다.
GitHub Copilot 가이드는 이미지 관리 가이드의 Replace 호출이 로드된 덱에서 오래된 사진을 남긴 유사한 실패 사례를 측정합니다. Google Antigravity 가이드는 동시에 웹 요청을 위한 덱을 구축하며, IronPPT는 IronPPT 호출을 모든 호출에서 단일 잠금으로 보호할 때만 올바르게 제공했습니다. 공유된 실행 기록은 Codex 버전, 모델, 타이밍 및 테스트 기계를 제공합니다.
문제 해결
Show으로 슬라이드를 숨기고 파일에 유지하기 위한 슬라이드 관리 방법- 로드된 덱에서 복사하는 대신 새 텍스트에 텍스트 스타일을 설정하기 위한 슬라이드 요소
- 모든 저장이 "Production License Required"로 실패하는 경우 라이센스 키 적용
질문?
질문이 있으시면 support@ironsoftware.com으로 문의하세요.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.