カーソルを使用したIronPPTの使い方

Curtis Chau
Curtis Chau
更新日: 2026年10月19日

AIエージェントがOpen XML SDKからIronPPTにC#レポートデッキジェネレーターを各スライドコールを直接翻訳して移行すると、新しいデッキは古いものと異なります。 Open XML SDKは空のパッケージから始まります。 新しいIronPPT PresentationDocument にはすでに1つのスライドが含まれているため、タイトルスライドと生徒ごとに1スライド追加する直接ポートは、最初のスライドが空白のデッキを保存します。 私たちのテストでは、同じポートも古いジェネレーターが16:9を書いたところに4:3スライドを生成しました。

CursorはVS Codeのコードベースに基づいて構築されたAIコードエディタであり、ファイルを編集しコマンドを実行するエージェントを持ちます。 ここでのマイグレーションは、エージェントが読むドキュメントのリンクと.cursor/rulesにコミットされたプロジェクトルールの2つの機能を使用します。 それは学校のレポートデッキジェネレーターをIronPPTに移行します。 ジェネレーターは、名簿ファイルからクラスごとに1学期のレポートデッキを構築し、タイトルスライド、生徒ごとに1スライド、終了スライドがあり、移行されたデッキは学校が承認したテキストのすべての行を保持する必要があります。

スライドを追加するガイドとテキストを追加するガイドを参照してください。

クイックスタート
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を使用しました。

CursorにIronPPTのドキュメントをどうやって渡しますか?

要求にIronPPTのドキュメントリンクを含めるか、チーム全体が共有するルールに保存します。 IronPPTのllms.txtには各ガイドとAPIリファレンスが記載されており、llms-full.txtは16ページのドキュメントを1つのファイルに圧縮しています。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ファイルを無視し、フロントマターなしのファイルではルールを読み込むタイミングを決定できません。

以下のルールは、Cursorのルールページで指定されたように、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 を読み込みます。 そのファイルには frontmatter やファイルパターンがないため、globs に依存するルールは .cursor/rules に属します。

ルールはエージェントリクエストに適用されます。 Cursorのルールページには、ルールはタブには影響を与えず、ユーザールールはインライン編集には適用されないと記載されているため、その提案をルールに対して手動で確認してください。

Open XML SDKのコールをIronPPTにマップする方法

Open XML SDKはパッケージをパーツごとに書き込みます。したがって、古いジェネレーターもスライドマスター、レイアウト、テーマ、ノートマスターを作成します。 IronPPTはそれらのパーツを自分で作成します。

Open XML SDKIronPPT
PresentationDocument.Create プレゼンテーションパート、マスター、レイアウト、テーマと共にnew PresentationDocument()、またはテンプレートパス付きのコンストラクタ
プレゼンテーションパートに追加され、SlideIdListにリストされたSlidePartAddSlide(new Slide())、スライドを追加
TitleとbodyのプレースホルダがA.ParagraphおよびA.Runで埋められたものSlide.AddChild TextBoxを用いたもので、1行につきParagraph
既存のプレースホルダ内のテキスト読み込まれたテンプレートのスライドでのTexts[i].Text
SlideSize は12192000×6858000に設定相当するものがないのでサイズはテンプレートから来ます
スライドごとのNotesSlidePart同等のものはありません
Save ファイルまたは任意のStreamへSave(string)、ファイルパスのみ

IronPPT.dllはOpen XML SDKタイプを内部に持ち、プロジェクトは移行中に両パッケージが参照される状態でビルドされました。

新しいIronPPTデッキが余分なスライドで始まる理由

新しいPresentationDocumentの組み込みスライドはタイトルとサブタイトルのプレースホルダが空のタイトルレイアウトを使用しています。 AddSlide はその後に追加され、与えられたスライドを返すので、直接ポートのすべてのスライドは承認されたアウトラインの1つ後の位置に表示されます。

そのスライドを早期に削除することは失敗します。 それが唯一のスライドである間にRemoveを呼び出すと、プレゼンテーションには少なくとも1つのスライドが含まれていなければならないとするInvalidOperationExceptionを投げました。2つ目のスライドが存在した後、同じ呼び出しは成功しました。

スライドサイズが2番目の違いです。 新しいデッキは9144000×6858000 EMUの4:3スライドでした。APIリファレンスはSlide.WidthとSlide.Heightをサンプルで記載していますが、どちらのプロパティもデッキのスライドサイズを変更しません。 これらを960×540ポイントに設定すると、スライドの形状の余幅に12192000×6858000 EMUを記述し、ppt/presentation.xml内のスライドサイズを9144000×6858000 EMUのままにしました。 16:9のファイルから読み込んだデッキは、保存を通じて12192000×6858000 EMUを保ち、プレースホルダとノートを持ち続けました。 したがって、リポジトリは学校のタイトルスライドをTestData/templates/hollybrook-16x9.pptxに維持します。

IronPPTへの移行を計画して実行する方法

チャット入力でShift+Tabを押して計画モードが選択されるまで押し、次に下記のリクエストを送信します。 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

計画の誤りを修正してください。 その後、計画モードで計画を構築するか、エージェントに戻ってこのリクエストを送信します。

@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機能が各変更に適していますか?

変更の範囲に基づいて機能を選択してください。 タブは開発者が開始した編集を完了します。 説明ができる1文で説明可能な選択にはインライン編集(Ctrl+K)を使用してください。 エージェントは複数のファイルにわたる変更とビルドが必要な作業を処理し、計画モードはエージェントがコードを変更する前にレビューするための計画を追加します。

このリクエストをエージェントに送信してください。 変更するメソッドの名前を付けるため、エディタで選択する必要はありません。

@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はスライドが追加するテキストをどのように配置しますか?

1スライド上での5つのSlide.AddTextの呼び出しは、同じボディプレースホルダ上に1905000×1270000 EMUの5つの形状を生成しました。 AIエージェントハブはそのような形状が1つの位置を共有する理由を説明しています。 1行ごとに1つのParagraphを保持するTextBoxが、行を順に並べた1つの形を与えます。 アウトラインチェックは、デフォルトサイズに残されたボックスを検出しません。なぜなら、それはテキストのみを読み込むからです。

PresentationDocument.AddText はスライドメソッドとは異なる動作をします。 それは最後のスライドの最終段落の末尾に空白や改行のない新しい実行としてテキストを追加しました。 Slide.Texts を通じて戻ると、2つの実行が別々のアイテムとして表示されます。 Slide.Paragraphs は視聴者が見る行を返します。これがinspectコマンドが段落を読み取る理由です。

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

出力

以下の図は、修正前のデッキから1つの予定スライドと修正後のデッキからの1つのスライドを示しています。

修正前の保護者の夜のデッキのスライド3。2つの重なるテキストシェイプを持つ4:3スライド。

修正前の保護者の夜のデッキのスライド3。保存されたファイルのXMLから描画されたもの。4:3スライドは同じ位置に2つのテキストシェイプを保持しています。図面はPowerPointのレンダリングではなく、格納されたジオメトリを示しています。

修正後の保護者の夜のデッキのスライド2。1つの小さなテキストボックスを持つ16:9スライド。

修正後の保護者の夜のデッキのスライド2。保存されたファイルのXMLから描画されたもの。16:9スライドは1905000×1270000 EMUの1つのテキストボックスを保持しています。図面はPowerPointのレンダリングではなく、格納されたジオメトリを示しています。

デッキの回帰テストを書く方法

@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×6858000 EMUの16:9スライドを保持しました。
  • Cursorはテンプレートのタイトルスライドを埋めましたので、7Bデッキは8スライドを保持し、空白のスライドはありませんでした。
  • 各生徒のスライドは、独自の位置を持たない1905000×1270000 EMUの単一のテキストボックスにそのテキストを保持しました。
  • Open XML SDKデッキは6つのノートスライドを保持し、IronPPTデッキはありませんでした。
  • 6つの指導者のコメントは7B-term-report.comments.txtに送られ、生徒ごとに名簿順で一行入力されました。
  • Cursorは引用されたページから5つのドキュメントの質問に回答し、ファイルを変更しませんでした。
  • PresentationDocument.AddTextがそのテキストをどこに配置するかを示すページはCursorが見つかりませんでした。
  • スライドサイズについて、CursorはSlide.WidthとSlide.Heightを引用しました。 その回答は誤っていました。
  • 出力チェックは、空の生徒エントリを含む名簿を拒否し、「スライド2にはテキストがない」と印刷し、コード3で終了しました。
  • 修正前の夕方のデッキは7行中0行と一致し、4:3スライドを使用していました。
  • 修正後の夕方のデッキは16:9スライドで7行中7行と一致しました。
  • Cursorが報告した一致カウントは両方のデッキで独立したチェックとの一致がありました。
  • xUnitスイートは9件中9件のテストに合格し、7つの要求されたケースをカバーしました。
  • すべてのリリースビルドでエラーは0件、テストプロジェクトには1件のxUnitアナライザー警告が追加されました。
  • 一部のステップはページと異なる方法で実行されました。 7つのプロンプトはすべて1つのヘッドレスセッションでCursor CLIを通過しました。 CLIは、プロンプト03でのスピーカーノートおよびプロンプト05でのエラー出力に関するCursorの質問をスキップしました。プロンプト05から07はセッション再開時に計画モードで実行され、フォローアップメッセージ「Planをビルドします。」が各計画を実行しました。 プロンプト04のdiffについて、Cursorはコードの変更を表示する代わりに予期されたファイルとアウトラインを比較しました。

GitHub Copilotガイドは、パス固有のガイドラインファイルでソースおよびテストプロジェクトに限定してIronPPTのコンベンションの一部を保持します。 Claude Codeガイドもデッキジェネレーターが書かれる前に計画を承認します。 実行記録には、この実行のCursorバージョン、モデル、および期間、そしてテスト機の一覧が表示されます。


トラブルシューティング


質問ありますか?

質問がある場合は、support@ironsoftware.com にお問い合わせください。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 7,110バージョン:2026.11ちょうどリリースされました