GitHub Copilot과 함께 IronPPT 사용하는 방법

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

부동산 중개소는 매주 금요일마다 구매자의 에이전트들에게 오픈 하우스 목록을 발송합니다. 각 부동산 목록은 최대 세 장의 사진과 함께 하나의 슬라이드를 받으며, 사진은 각기 다른 크기와 모양, 해상도로 휴대폰과 카메라에서 도착합니다. .NET 서비스가 중개소의 저장소에서 데크를 작성하므로, 해당 서비스를 변경하는 모든 보조자들은 변형 없이 각 사진을 프레임 안에 넣어야 합니다.

GitHub Copilot은 Visual Studio와 VS Code의 채팅 및 에이전트 모드를 통해, 터미널의 Copilot CLI 및 할당된 이슈를 풀 리퀘스트로 전환하는 GitHub 클라우드 에이전트를 통해 저장소에 접근합니다. IronPPT는 Microsoft Office 없이 .NET에서 PowerPoint 파일을 생성하고 편집합니다. AddImage는 슬라이드에 그림을 배치하고, Image 클래스는 그것을 크기 조정, 교체 및 제거합니다. 저장소에 커밋된 지침 파일은 이러한 모든 표면에 IronPPT 규칙을 부여합니다.

이 가이드는 Copilot을 사용하여 IronPPT를 통해 사진을 배치하는 소프트웨어 빌드를 지시하는 방법을 다룹니다. 사진을 촬영하고 슬라이드 템플릿을 디자인하는 것은 저장소 밖에서 일어나는 별도의 작업입니다. 이미지 관리 가이드는 목록 데크가 의존하는 IronPPT 호출을 설명합니다.

빠른 시작
NuGetNuGet으로 설치

PM > Install-Package IronPPT

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

저장소 루트에서 터미널을 열고 Copilot CLI를 시작하고 프롬프트를 제출합니다. Copilot CLI는 @와 함께 파일을 첨부하고, Visual Studio의 Copilot Chat은 # 참조를 사용합니다.

Fill in @src/Listings.Deck/ListingDeck.cs so the agency can build its weekly open-homes deck.
The repo already pins IronPPT 2026.10.1 in Directory.Packages.props.

Here is what the deck code needs:
- One public static method, Build(string listingsPath, string photosDir, string outPath).
- Listings come from @data/listings.json.
- Each listing's photos are in photos/<listing id>/, under the file names the JSON gives.
- The cover and every listing slide follow @docs/listing-layout.md.

Then do these in order:
1. Add a build command with an --out <path> option to @src/Listings.Cli/Program.cs.
2. Build the solution.
3. From the repo root, run the CLI with build --out out/listings.pptx.

Tell me how many slides the deck has and how large the file is.
Text

프롬프트는 박스나 좌표를 지정하지 않으며, docs/listing-layout.md가 포인트 단위의 사진 박스와 텍스트 줄 순서를 정의합니다.

Copilot이 실행되는 환경에서 IRONPPT_LICENSE_KEY을 설정합니다. IronPPT는 그 이름을 자체적으로 읽지 않습니다. 우리의 테스트에서는, License.IsLicensed이 해당 변수만 설정했을 때 remain false로 남아 있었습니다. IronPPT는 IronPPT.LicenseKey와 IRONPPT_LICENSEKEY라는 변수는 자체적으로 읽었지만, 샘플 저장소는 전통적인 이름을 License.LicenseKey에 복사합니다. 라이선스 키 가이드는 다른 지원 위치를 나열합니다.



IronPPT의 규칙을 Copilot에 설정하는 방법은?

프로젝트 전역의 규칙을 .github/copilot-instructions.md에 배치합니다. GitHub의 지원 참조는 Visual Studio, VS Code 및 JetBrains IDE의 Copilot Chat과 클라우드 에이전트 및 Copilot 코드 검토에 해당 파일을 나열합니다. Copilot CLI는 동일한 위치에서 그것을 읽습니다. Visual Studio는 사용자 정의 지침 옵션이 선택될 때 그것을 로드하며, 해당 옵션은 기본적으로 켜져 있습니다.

This repo builds the weekly open-homes deck with IronPPT. These rules apply to all of it:
- Use IronPPT, the NuGet package and namespace. Don't add another presentation or Open XML package.
- Edit the IronPPT entry in Directory.Packages.props only when the task is an IronPPT upgrade.
- Give other packages their versions in Directory.Packages.props as well.
- The code reads IRONPPT_LICENSE_KEY itself, because IronPPT doesn't look at that name.
- Copy the key into License.LicenseKey before the code saves a deck.
- Never print the key, and never list environment variables.
- docs/listing-layout.md is the contract.
- If the layout doc looks wrong, say so in your reply and leave the file as it is.
- The IronPPT docs index for agents is https://ironsoftware.com/ppt/csharp/llms.txt

Tests follow two more rules:
- A test saves a deck, reopens it and checks its pictures and text.
- Never compare the bytes of two decks.
Markdown

IronPPT는 각 그림을 Picture 86115와 같은 랜덤 숫자로 이름을 지어, 동일한 목록에서의 두 번의 빌드가 바이트별로 달랐습니다. 테스트는 그 이유로 사진과 텍스트를 비교합니다.

데크 코드에 자체 규칙을 부여하는 방법은?

.github/instructions/deck.instructions.md 같은 파일은 applyTo 패턴이 이름을 붙이는 트리의 부분에 대한 규칙을 보유하며, 여기서는 소스와 테스트 프로젝트입니다. GitHub의 문서에 따르면, Copilot CLI는 해당 패턴 중 하나와 일치하는 파일에서 작동할 때만 파일을 포함합니다. 테스트 실행에서는 Copilot이 첫 번째 프롬프트와 이슈의 별도 세션에서 다른 파일들 전에 이 파일을 열었습니다.

---
applyTo: "src/**,tests/**"
---

These rules cover IronPPT pictures and slides in the deck code and its tests:
- Every new PresentationDocument already has a slide. Make the cover from that slide.
- Don't add another slide in front of the cover.
- Give every picture an explicit Width, Height and Position, in points.
- Without them, IronPPT sizes a photo from its pixels and DPI.
- At 72 dpi, a 4032 x 3024 photo comes out 56 x 42 inches.
- The default slide is 10 x 7.5 inches.
- Setting Width leaves Height as it was, and the reverse.
- Work out both from the photo's pixel size to keep its aspect ratio.
- On a deck loaded from a file, call Replace on document.Images, not on a slide's Images list.
- Replace resets the picture to the new photo's own size.
- So set Width, Height and Position again after each Replace.
- Width, Height and Position read from a reopened deck are 12,700 times the value in points.
- AddImage with an AnyBitmap stores the picture as an uncompressed BMP.
- To store a resized photo as a JPEG, encode it first and pass the stream.
Markdown

그 파일의 각 규칙은 IronPPT 2026.10.1의 프로브에서 나옵니다.

IronPPT는 목록 사진을 얼마큼 크게 만드나요?

크기 없이 AddImage는 사진의 픽셀 수를 인치 단위로 DPI로 나눈 프레임을 부여하며, 위치를 기록하지 않습니다. 기본 슬라이드는 10 x 7.5인치로, 720 x 540포인트입니다.

  • 72 dpi로 저장된 4032 x 3024 휴대전화 사진은 56 x 42인치의 프레임을 받았습니다.
  • 동일한 2048 x 1536 사진은 300, 72, 96 dpi로 저장되어 각각 6.8, 28.4, 21.3인치의 너비를 가진 프레임을 받았습니다. DPI가 없는 PNG는 96 dpi로 크기 조정되었습니다.
  • 헤더에 단위가 없는 1 x 1 밀도의 JPEG는 1 dpi로 크기 조정되어 4032픽셀 사진은 4032인치 넓이가 되었습니다.
  • 너비, 높이 및 위치는 포인트를 받습니다. 너비를 400으로만 설정했을 때, 높이는 변하지 않아 프레임이 사진의 종횡비를 잃었습니다.

docs/listing-layout.md의 적합성은 따라서 사진의 픽셀 크기에서 시작합니다. 스케일링 요인은 박스 너비를 사진 너비로 나눈 것과 박스 높이를 사진 높이로 나눈 것 중 작은 것이며, 스케일링된 프레임은 박스 중앙에 배치됩니다.

저장된 데크에서 사진을 교체하는 방법은?

Swap the hero photo of L-1044 in out/listings.pptx for photos/reshoot/L-1044-front.jpg.
The photographer reshot the front, and the new photo is portrait.
Change the saved deck itself. Don't rebuild it from the JSON.

Add the swap to the CLI as a swap command with these options:
- --deck <path> names the deck to change.
- --listing <id> and --photo <n> pick the picture, counting photos from 1.
- --file <path> is the new photo.

The new photo goes in the hero box and follows the fit rules in docs/listing-layout.md.
Leave every other picture and all the text as they are.

Run the command, reopen the deck and show me the hero's position and size in points.
Text

프로브에서 Replace이 세 가지 다른 결과를 주었습니다.

  • 메모리에서 빌드된 데크에서는 Replace가 사진을 교체하고 프레임을 새로운 사진 자체 크기로 설정하였으나 위치는 없었습니다.
  • 로드된 데크에서 슬라이드의 Images 리스트를 통해 호출된 Replace는 어떤 프로브에서도 요청된 사진을 변경하지 않았습니다. 한 사진이 있는 슬라이드는 기존 사진을 유지하고 새 사진을 사용하지 않은 채 파일에 저장했습니다. 두 사진이 있는 슬라이드에서는 첫 번째 사진에 대한 호출이 두 번째 사진을 교체하였습니다.
  • document.Images을 통해, 로드된 데크의 Replace는 올바른 사진을 교체했습니다. 호출 후 너비, 높이 및 위치를 설정하여 프레임에 올바른 크기와 위치를 부여했습니다.

이미지 관리 가이드의 교체 샘플은 로드된 데크에서 Slides[0].Images[0]를 통해 Replace를 호출하며, 이는 기존 사진을 제자리에 남겨둔 경로입니다.

산출

테스트 실행은 교체 전후에 220 Mill Road의 슬라이드를 저장했습니다.

교체 전 220 Mill Road의 목록 슬라이드에는 가로 방향의 히어로 사진과 하나의 섬네일이 있습니다.

슬라이드 4는 첫 번째 프롬프트에서 각 그림이 저장된 위치와 크기로 그려졌으며, 텍스트는 그려지지 않았으며, 사진은 생성된 테스트 이미지입니다.

교체 후 220 Mill Road의 목록 슬라이드에는 세로 방향으로 다시 촬영한 히어로 박스 중앙에 배치된

교체 명령 후 슬라이드 4는 동일한 방식으로 그려졌습니다.

데크를 테스트하는 방법은?

Shift+Tab을 사용하여 Copilot CLI를 계획 모드로 전환한 후 이 프롬프트를 제출합니다.

Plan an xUnit project at tests/Listings.Deck.Tests, and put it in the solution.
Show me the plan first, and hold the code until I say go.

Each test builds a deck from data/listings.json in a temp folder and checks one of these:
- The deck has a cover plus one slide per listing, in the order of the JSON.
- Each listing slide holds one picture per photo, in the box the layout doc gives that photo.
- Every picture keeps its photo's aspect ratio within 0.5% and stays inside its box.
- The address, the price and the bed and bath line are on the right slide.
- The swap command changes the chosen picture and no other.

Once I say go, write the tests and keep running dotnet test until they pass.
Then tell me how many tests passed.
Text

박스에 대한 테스트는 IronPPT가 잘못 보고하는 크기를 읽어야 합니다. 재개방된 데크에서 읽은 너비, 높이 및 위치는 포인트의 12,700배로 반환되며 이는 PPTX 파일이 저장하는 단위인 EMU입니다. 480포인트 프레임은 6,096,000으로 읽혔습니다. 실행의 테스트는 레이아웃과 비교하기 전에 읽어온 값을 12,700으로 나누었습니다.

판매 표시가 남아있어 사진이 남아 있는 이유는?

이 시나리오에서는 팀 동료의 SoldUpdate.cs가 루프에서 판매된 목록의 사진을 제거합니다.

Find out why marking a listing sold leaves photos behind, then fix it.
@src/Listings.Deck/SoldUpdate.cs edits a saved deck.
It should strip the listing's photos from its slide and add a SOLD line.

Work through these steps before you touch SoldUpdate.cs:
1. Write a test that builds a deck, marks L-1042 sold and counts the pictures left on its slide.
2. Read how https://ironsoftware.com/ppt/csharp/how-to/manage-image/ removes all images.
3. Tell me what Slide.Images returns in IronPPT that explains the leftover photos.

The fix has to meet these conditions:
- It changes SoldUpdate.cs and no other source file.
- The new test expects no pictures on the slide.
- dotnet test passes.

Last, mark L-1042 sold in a copy of out/listings.pptx.
Tell me the copy's size before and after.
Text

Slide.Images는 매번 액세스 시 새로운 리스트를 작성합니다. 각 반복에 대해 위 slide.Images을 다시 읽는 루프는 인덱스가 증가함에 따라 매 제거 후 사진 하나를 건너뛰게 됩니다. 사진 4장이 있는 슬라이드에서 2장을 제거하였으며, 3장이 있는 목록 슬라이드에서 2장을 제거하고 하나를 남겼습니다. 사진을 카운트다운하는 루프는 이미지 관리 가이드의 remove-all 샘플과 같이 모든 사진을 제거하였고, 하나의 리스트 복사본에 대한 foreach도 모든 사진을 제거했습니다.

제거는 또한 사진의 바이트를 파일에 남깁니다. 사진 4장을 13,766,065바이트 데크에서 제거하면 13,765,502바이트의 파일이 저장되었습니다.

클라우드 에이전트가 작동할 수 있는 문제는 무엇입니까?

이슈가 Copilot에 할당되면, GitHub는 에이전트에게 이슈의 제목, 설명, 해당 시점의 댓글 및 할당 시 주어진 지침을 전달합니다. 나중에 추가된 댓글은 에이전트에게 전달되지 않으므로, 이슈 본문은 전체 요청을 포함해야 합니다.

Title: Shrink the weekly deck so it can be emailed

Files: src/Listings.Deck/ListingDeck.cs and tests/Listings.Deck.Tests
Versions: IronPPT 2026.10.1 on net9.0

Expected: out/listings.pptx is under 4 MB, and the deck code works like this:
- IronPPT gets a scaled copy of any photo wider or taller than 1600 pixels.
- The copy is 1600 pixels on its long side and is stored as a JPEG at quality 85.
- Every picture keeps the box, position and size it has now.

Actual: IronPPT stores each photo file as it is, so the deck is over 15 MB.

Constraints: the change stays inside these limits:
- Keep the Build signature.
- Follow .github/instructions/deck.instructions.md.
- Add no packages.
- Leave the files in photos/ untouched.

Acceptance: the issue is done when all of this holds:
- The existing tests pass.
- A new test builds the deck and opens each photo stored under ppt/media in the saved file.
- That test fails if any stored photo is over the 1600-pixel limit.

Summary: give the deck's size before and after the change.
Markdown

IronPPT는 각 사진 파일을 바이트마다 데크에 복사하며, 사진이 세 번 추가되면 세 번 저장됩니다. AddImage에 AnyBitmap로 전달된 스케일된 사진은 1600 x 1200픽셀 크기의 7,680,122바이트 무압축 BMP로 저장되었습니다. 동일한 픽셀을 품질 85의 JPEG로 인코딩하고 스트림으로 전달한 것은 337,813바이트로 저장되었습니다.

클라우드 에이전트의 테스트가 IronPPT 프로젝트에서 실패하는 이유는?

클라우드 에이전트는 저장소가 달리 선택하지 않는 한 Ubuntu Linux에서 실행됩니다. IronPPT는 .NET Standard 2.0을 대상으로 하며, 복원하는 패키지 중 원본 파일을 포함한 것이 없어 설치 단계는 .NET SDK 외에는 아무것도 설치하지 않습니다.

러너 또한 라이선스 키가 없습니다. 라이선스 키 없이, IronPPT는 메모리에서 데크를 빌드하고 저장된 데크를 읽었지만 Save은 라이선싱 예외를 발생시키고 파일을 작성하지 않았습니다. 그래서 데크를 저장하는 각 테스트는 러너에서 실패합니다.

GitHub는 copilot-setup-steps 작업을 .github/workflows/copilot-setup-steps.yml에서 에이전트 시작 전, 파일이 기본 브랜치에 있을 때만 실행합니다. 설치 단계가 실패하면 Copilot은 그 후의 단계를 건너뜁니다.

Add a workflow at .github/workflows/copilot-setup-steps.yml to prepare the cloud agent's machine.
GitHub reads only a job named copilot-setup-steps from that file.

Set the job up this way:
- It runs on ubuntu-latest with contents: read as its one permission.
- It triggers on workflow_dispatch and on any pull request that edits this file.

Give it these steps, in order:
1. Check out the repo.
2. Set up .NET 9.
3. Run dotnet restore.
4. Run dotnet build -c Release.
5. Check for the license key.

IRONPPT_LICENSE_KEY is an Agents secret.
GitHub's docs say copilot-setup-steps.yml can use Agents secrets.

The key check handles a missing key in two ways:
- A pull_request or workflow_dispatch run gets a warning, and the step still succeeds.
- Any other run fails, and the error names the missing secret.

Write the file and print the YAML for me.
Then tell me how the key check reads the key, and cite the GitHub page you followed.
Text

키를 Agents 비밀에 저장하세요: GitHub에 따르면, 클라우드 에이전트는 Actions, Codespaces 또는 Dependabot 비밀에 접근할 수 없습니다. 저장소의 설정에서 보안 섹션에서 비밀 및 변수를 열고, 에이전트를 선택하고 비밀 탭에 IRONPPT_LICENSE_KEY를 추가합니다. GitHub의 문서에는 Agents 비밀을 읽는 설치 단계의 예제가 없습니다.

병합 전에 무엇을 확인해야 합니까?

코드를 작성한 세션 외부에서 별도의 copilot -p 명령으로 검토를 실행합니다.

/review this branch against main.

Compare the code with these three sources and list each spot where they disagree:
- the rules in .github/copilot-instructions.md
- the rules in .github/instructions/deck.instructions.md
- IronPPT.xml, which ships inside the IronPPT package in the NuGet cache

Also check for two patterns that no rule file covers:
- a loop that removes pictures while its index counts up
- a line that prints the message of a licensing exception

Tell me what you find, and say so if nothing turns up. Don't change any file.
Text

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

일곱 개의 프롬프트가 이 가이드를 위해 빌드된 목록 저장소에서 Copilot CLI의 무인 모드로 실행되었습니다. 별도의 검사는 저장된 데크와 저장소에서 아래의 모든 수치를 읽었습니다.

  • 실행 전, ListingDeck는 빈 클래스였고 CLI는 사용법 라인을 출력하고 코드 1로 종료했습니다.
  • 첫 번째 프롬프트 후, 데크는 표지와 네 개의 목록 슬라이드를 보관하고 있으며, 모두 15,150,897바이트입니다.
  • 모든 10장의 사진이 박스 안에 종횡비, 크기 또는 중앙 정렬의 측정 가능한 오류 없이 들어가 있었습니다.
  • 교체는 document.Images를 통해 220 Mill Road 히어로를 교체했습니다.
  • 세로 방향으로 다시 촬영한 사진은 히어로 박스 중앙에 243 x 324포인트로 측정되었습니다.
  • 다른 9장의 사진이나 슬라이드 텍스트는 교체 중에 변경되지 않았습니다.
  • 계획 모드에서는 Copilot이 계획을 작성했으며 파일을 변경하지 않고 승인 메시지를 기다렸습니다.
  • 수정은 SoldUpdate.cs의 루프를 역전시켰습니다.
  • 이후 18 Alder Court를 판매로 표시했을 때는 슬라이드에 사진이 남지 않았습니다.
  • Copilot은 남아있는 사진을 리스트 내부에서의 항목 이동에 기인한다고 하며 Slide.Images를 읽을 때마다 새로운 리스트가 작성된다는 것은 언급하지 않았습니다.
  • 제거된 3장의 사진은 총 6,469,676바이트로 판매 사본에 남아 있었습니다.
  • 이슈의 세션은 가까운 쪽을 1600픽셀로 SixLabors.ImageSharp를 사용하여 9장의 사진을 스케일링했고, IronPPT는 이미 포함하고 있으며 패키지를 추가하지 않았습니다.
  • 재구축된 데크는 1,198,644바이트로 측정되었습니다.
  • 모든 사진은 크기와 위치를 유지했습니다.
  • 키가 설정된 상태에서 7개의 모든 테스트는 통과했습니다. 설정되지 않은 상태에서는 라이선싱 예외로 인해 7개의 모든 테스트가 실패했습니다.
  • 리뷰 세션은 브랜치와 메인을 비교하였으며, 불일치를 보고하지 않았고 파일을 변경하지 않았습니다.
  • 일부 단계는 페이지와 달리 작동했습니다. 이슈 본문은 테스트 저장소에 GitHub 원격이 없으므로 새로운 Copilot CLI 세션으로 이동했습니다. 설치 워크플로우는 작성되었지만 동일한 이유로 실행되지 않았습니다.

Cursor는 또한 커밋된 규칙 파일을 일치하는 경로에 적용하며, Claude Code는 또한 코드를 편집하기 전에 승인에 대한 계획을 보유합니다. 공유 실행 기록은 Copilot CLI 릴리스, 선택된 모델 Auto, 지속 시간 및 테스트 머신을 나열합니다.


문제 해결


질문?

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

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

더 읽기

시작할 준비 되셨나요?

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