AIコーディングアシスタントとIronPPTを使用する

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

IronPPTは、.NET用のIron SoftwareのPowerPointライブラリです。 Microsoft OfficeやInteropなしで、C#コードからPPTXプレゼンテーションを作成、開く、編集でき、単一パッケージですべての.NET Standard 2.0対応プラットフォームをカバーします。

四半期レビュー用デッキ、コースハンドアウトのセット、またはプロパティリストはすべて、スライドの追加、テキストと画像の配置、送信前の順序変更といった同じ操作に依存しています。 IronPPTのドキュメントがないアシスタントは存在するメンバーのリストを持たず、IronPPT自身のガイドサンプルはコンパイルおよび実行されますが、保存されたデッキは変更されません。

セットアッププロセスはすべてのアシスタントで同じです。 パッケージを追加し、環境からキーを割り当て、アシスタントにIronPPTの機械可読ドキュメントを提供し、タスク完了前に保存されたすべてのデッキを確認してください。 スライドの追加、テキストの追加、画像の管理、スライドの管理に適用されます。

Claude Code AI コーディングアシスタントのロゴChatGPT Codex AI コーディングアシスタントのロゴGitHub Copilot AIコーディングアシスタントロゴCursor AIコードエディターロゴGoogle Antigravity AIコーディングエージェントロゴ

AIアシスタントは単独でPowerPointを扱えないのか?

プレゼンテーションライブラリがない場合、.NETコードはOpen XML SDKを介してPowerPointファイルを作成できます。これにより、プレゼンテーションは部品ごとに構築され、関係を通じて部品がリンクされます。

IronPPTは、そのパッケージ構造を、小さなオブジェクトモデルでラップし、その主なタイプはPresentationDocumentとSlideです。

最初のプロンプトの前に3つの事実が適用されます。

  • 効果のない呼び出しはエラーを引き起こさない: 保存されたファイルを読み取ることでのみ、変更がないことが示されます。IronPPTは、それを再びパスから開くときにその読み取りを行います。
  • パッケージと名前空間のための1つの名前: 両方ともIronPPTです。 攻撃者は、アシスタントが存在しないパッケージに推奨する名前で悪意のあるパッケージを登録します。この実践はslopsquattingと呼ばれるので、プロンプトに正確な名前を含めてください。
  • ライセンスは永続的である: IronPPTライセンスは一度の購入で更新料はなく、ライセンスページには各ティアが許可する開発者の数がリストされています。

ステップ1:IronPPTをインストールする

パッケージが参照されると、アシスタントはIronPPTが提供するタイプを使用します。

Install IronPPT 2026.10.1 from NuGet and restore the project.
Tell me the IronPPT version it references afterwards.
Text

ターミナルから、リリースを明示的に固定します。

dotnet add package IronPPT --version 2026.10.1
SHELL

パッケージにはネイティブのバイナリは含まれておらず、その唯一の依存関係はIronSoftware.CommonとIronSoftware.System.Drawingです。


ステップ 2: ライセンス キーを適用する

キーがない場合、プログラムはメモリ内でデッキを構築し、既存のファイルを開くことができますが、すべてのSaveへの呼び出しは、IronSoftware.Exceptions.LicensingExceptionとメッセージProduction License Requiredと共に失敗します。 メッセージは、7日間の無料開発使用を言及していますが、この記事のプローブで最初の試みで保存に失敗しました。 誤入力されたキーは代わりにLicense Key Not Recognizedを引き起こし、そのメッセージの残りの部分でキーを繰り返します。 短いキーは完全に表示され、1文字変更されたフルキーはその最終32文字で表示されました。 したがって、例外メッセージを記録するコードは、キーの内容をログに書き込みます。 無料のトライアルキーは以下で入手可能です。

無料トライアルで今日からプロジェクトにIronPPTを使用し始めましょう。

初めの一歩:
arrow pointer

アプリケーションスタートアップ時に一度ライセンスキーを割り当て、任意のIronPPTの呼び出しを行う前に行います。 リポジトリに保存されないようにするため、環境変数から取得します。

IronPPT.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPPT_LICENSE_KEY");
C#

有効なキーが割り当てられた後、IronPPT.License.IsLicensedはtrueに設定され、IronPPT.License.IsValidLicenseはキー文字列が有効かどうかを報告します。 上記の割り当てがない限り、IronPPTはIRONPPT_LICENSE_KEYを無視します。 いかなるコードもなしに、IronPPT.LicenseKeyやIRONPPT_LICENSEKEYという名前の環境変数を読み込みます。

注意してください: IronPPTライセンスキーでは、appsettings.jsonでのキーの設定方法も説明しています。

ステップ3:アシスタントをIronPPTのLLMドキュメントに向ける

  • llms.txtはその15ページのそれぞれに1行のエントリを含みます。
  • llms-full.txtは16のドキュメントページの要約を1つのファイルで提供します。
  • llms-full-catalog.txtはブログ記事を含むインデックスを拡張します。
  • APIリファレンスは各メンバーのシグネチャをリストします。
  • スキルファイルをサポートするツールはskill.mdを使用できます。これにはセットアップ、ライセンス、レシピ、および共通のエラーが含まれます。
  • AIプロダクトファクトシートはサポートされているプラットフォームと主要なユースケースを概説します。

セッションの開始時にインデックスを提供してください。

Open https://ironsoftware.com/ppt/csharp/llms.txt before you write more IronPPT code.
Keep to what its linked pages document.

The IronPPT object model works like this:
- PresentationDocument is the deck, and a new one already holds one blank slide.
- AddSlide appends a Slide.
- Slide.AddText, Slide.AddParagraph and Slide.AddImage fill a slide.
- Slide.Remove deletes a slide, and setting Slide.Show to false hides it.
- Save writes the .pptx file, and the constructor that takes a path opens one.

For a member those pages leave out, do this:
1. Search https://ironsoftware.com/ppt/csharp/object-reference/api/ for it.
2. Build once to prove it compiles.
3. If you still can't confirm it, say so instead of guessing.

After that, list the IronPPT calls in this project that the docs don't cover.
Text

「ドキュメント化されていない」と回答する許可により、アシスタントにメソッドを発明する以外の選択肢を与えます。


ステップ4:プロジェクトにIronPPTのコンテキストを追加する

IronPPTのルールをプロジェクトの指示ファイルに保存し、すべての新しいセッションがそれを読み取れるようにします。 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を読みます。 単一のテキストブロックはすべてに互換性がありますが、CursorルールファイルにはMDC前置きも含まれます。 以下から開始します。

Every deck in this project is built with IronPPT, under these rules:
- `IronPPT` is both the NuGet package name and the namespace.
- Begin with the llms.txt index, https://ironsoftware.com/ppt/csharp/llms.txt.
- Tools that read skill files load https://ironsoftware.com/ppt/csharp/skill.md.
- Set `IronPPT.License.LicenseKey` from IRONPPT_LICENSE_KEY when the app starts.
- The program reads that variable itself and never lists environment variables.
- Keep the key out of output, logs, exception text, and source control.
- A wrong key's `LicensingException` message repeats the key. Log only its first line.
- A new `PresentationDocument` already has one slide. Use `Slides[0]` as the title slide.
- Add text, paragraphs, and images through `Slide` methods.
- Build slides in their final order, or set `Slide.Index` to move one.
- Edits to the `Slides` list do not change the deck.
- Remove a slide with `Slide.Remove()` and hide one with `Show = false`.
- On a deck opened from disk, replace a picture by removing it and adding the new image.
- Do not add the Open XML SDK or another presentation library.
- When IronPPT lacks a feature, report that rather than working around it.
Markdown

スキルファイルにはIronPPT 2026.8.1がテストされたリリースとして記載されており、その単一ファイルの例はそのリリースを固定します。 また、Slidesをスライドを並べ替えるために編集できるリストとして説明し、有効なキーが必要なSave前の7日間の開発期間を約束します。 2026.10.1のプローブは両方の声明に矛盾しました。


ステップ5: ワンショットセットアッププロンプト

ステップ1から4まではプロジェクトの開始時やセッションの最初のメッセージとして一緒に送ることができます。

Set this project up for PowerPoint work with IronPPT, following these rules:
- Reference the IronPPT package at version 2026.10.1.
- Assign IRONPPT_LICENSE_KEY to IronPPT.License.LicenseKey first thing at startup.
- The code reads that variable itself. Don't list environment variables.
- The key never shows up in the console, a log, or a committed file.
- Before coding, go through https://ironsoftware.com/ppt/csharp/llms.txt, then keep to it.
- Look up anything it doesn't cover at https://ironsoftware.com/ppt/csharp/object-reference/api/.
- Compile before relying on a member found there.
- Load https://ironsoftware.com/ppt/csharp/skill.md if the tool accepts skill files.
- When the skill file and the compiler disagree, believe the compiler.
- Put content on slides with Slide methods, not with PresentationDocument.AddText.
- Create the slides in their final order, since editing the Slides list changes nothing.

Save these rules to the instructions file your next sessions read.
Tell me which file you wrote and what else you changed.
Text

ステップ6: 作業コードを生成するプロンプトパターン

スライド、順序、および各スライドの内容を指定してください。

曖昧 IronPPTで四半期ごとのデッキを作成します。

より良い タイトルにはSlides[0]を使用し、その後、各地域に1つのスライドを追加し、収入順に並べ、32ポイントの太字見出しと3つの段落を付け、quarterly.pptxを保存します。

IronPPTのリリースとターゲットフレームワークを指定します。 メンバーはリリース間で変更される可能性があります。

より良い .NET 9でIronPPT 2026.10.1を使用し、最初のIronPPT呼び出し前にIronPPT_LICENSE_KEYからキーを割り当てます。

完全なファイルをリクエストします。 スニペットはusing IronPPT.Models;ディレクティブを省略することができ、それはSlide、Text、Imageを提供します。

より良い そのままビルドできるusingディレクティブとライセンス行が含まれたProgram.cs全体を返します。


ステップ7: 戻ってきたものを確認する

以下の各ミスは2026.10.1で再現可能です。

  • AddSlideでタイトルスライドを追加する: 各新しいPresentationDocumentは1つのスライドを最初から保持し、タイトルレイアウトに基づいて構築されています。 独自のタイトルスライドを追加するプログラムは、空白スライドを開くデッキを保存します。Slides[0]にタイトルを書き込むか、最初にすべてのスライドを追加してからオリジナルを削除してください。デッキの最後のスライドを削除するとInvalidOperationExceptionが発生します。
  • ドキュメントを通じてテキストを追加する: PresentationDocument.AddTextは最後のスライドの最後の段落にテキストを追加し、PresentationDocument.AddTextBoxはテキストボックス用の新しいスライドを作成しました。 コンテンツをSlideメソッドを通じて追加します。
  • 文字列引数付きAddTextの結果をスタイリングする: 返されたテキストにはスタイルオブジェクトがないため、それにプロパティを設定するとNullReferenceExceptionがスローされます。 スキルファイルのスタイリングレシピはその呼び出しを行います。 代わりに新しいTextStyleを割り当ててください。
  • FontFamilyでフォントを選ぶ: 保存された実行はフォントを持っていませんでした。 LatinFontはファイルにフォントを書き込みました。

IronPPTで再開されたデッキは、スライドの数とテキストを正しく返します。 スライドのXMLから位置、サイズ、整列、色を読み取ります。ppt/slides/slideN.xmlにあります。 リロード後、IronPPTは中央揃えのテキストを左として報告し、プローブは#C00000と#FFC000を#00000000として読み戻しました。位置、サイズ、フォントサイズはテキストと画像の出力の下で説明されたEMUスケールで戻ってきました。

エージェントに自身の作業を検証させる

アシスタント自身がこれらのチェックを実行し、結果を提示できます。

Do a clean Release build and run the app once more.

Then show me the evidence:
- The IronPPT types and members the code calls, each with its documentation page.
- The value of IronPPT.License.IsLicensed.
- Each saved deck's slide count and every slide's first line of text, read back from the file.
- Any hidden slide.
- Every shape's a:off, a:ext, algn and solidFill values, taken from ppt/slides/slideN.xml.
- Any image or text whose position, size, alignment or color differs from what the code set.

Read those four properties from the XML, never from a deck reopened with IronPPT.
End by saying whether each deck matches what the code meant to build.
Text

IronPPTでのスライド編集

スライドの順序、削除、画像の置換の挙動は、スライド管理ガイドと画像管理ガイドで示されているものとは異なります。 この記事のプローブは各変更を保存し、PPTX部品を読み戻しました。

  • PresentationDocument.Slidesは各呼び出しに新しいリストを返します。 そのリスト上のRemove、Insert、RemoveAt、Addは保存されたデッキに何も変更を加えなかったので、ガイドの再注文サンプルは元の順序のままです。
  • Slide.Remove()はスライドを削除しました。メモリ内とファイルからロードされたデッキのいずれでも。
  • Showをfalseに設定すると、スライドはファイル内で保持され隠れてマークされます。
  • Slide.Clone()はMissingMethodExceptionをスローするため、スライドを複製できません。
  • 削除されたスライドをAddSlideで元に戻すと、空白のスライドが作成されました。
  • Slide.Indexの設定は新しいデッキでもディスクから開いたものでもスライドを移動させ、保存されたファイルは新しい順序を保持しました。
  • Slide.ImagesはIImage値を保持していますので、ガイドのImages[0].Replace(image)呼び出しは一般要素Replaceメソッドにバインドされます。 その呼び出しはメモリ内で構築されたデッキの画像を置き換え、ディスクから開いたデッキでは古い画像を残しました。
  • 画像をImageにキャストすることでImage.Replaceに到達し、再オープンされたデッキでは機能し、メモリ内デッキではNullReferenceExceptionがスローされました。
  • 画像を削除しAddImageで新しい画像を追加することでどちらの場合も機能しましたが、保存されたパッケージは未使用のメディア部品として古い画像を保持しました。

IronPPTでのテキストと画像の出力

保存されたスライドXMLおよびOpen XML SDK 3.5.1のバリデーターが以下の結果を示しました。

  • 各Slide.AddText呼び出しは、それ自身の150x100ポイントのテキスト形状を作成し、位置を設定しなかったため、形状はスライドレイアウトからその配置を継承します。
  • AddParagraphはスライドの最後のテキスト形状にその段落を追加しました。
  • 新しいデッキの最初のスライドは、AddTextが追加したテキストの横に空白のタイトルおよびサブタイトルプレースホルダーを保持しました。
  • 画像Position、Width、Heightはポイント単位です。 解像度が設定されていない400x200ピクセルのPNGはサイズなしで追加されると、300x150ポイントに変わり、96DPIでのピクセルサイズになります。
  • 再オープンされたデッキでは、同じプロパティが設定された値の12,700倍でEMUとして保存された値として返されました。
  • FontSizeにPointを32で設定することで、32ポイントサイズが書き込まれ、IsBoldは太字が書き込まれました。
  • TextStyle.Colorでカラーされたすべての実行は、不正な子要素エラーでバリデーションに失敗しました。名前付きカラーでも16進値でも同様です。色付けされていないテキストのデッキはエラーなしで検証されました。

再現可能な結果

テストは1つのプロンプトで構成されており、コードは一切書きません。 空のフォルダーで新しいセッションを開き、プロンプトを貼り付け、結果を合格基準と比較します。

注意してください: テストには.NET 9 SDK、ネットワーク接続、ターミナルコマンドを実行できるアシスタント、およびIRONPPT_LICENSE_KEYでのIronPPTトライアルまたは本番キーが必要です。

プロンプト

Create a .NET 9 console app that builds a quarterly regional deck with IronPPT.
If this directory isn't empty, tell me and stop.
Don't ask questions. Note your choice for each missing detail.
Keep every deliverable in this directory.

Work in this order:
1. Add IronPPT 2026.10.1 from NuGet.
2. Study https://ironsoftware.com/ppt/csharp/llms.txt, its license key page and four how-to guides.
3. Follow these code rules:
- Use only members those pages or the API reference document.
- At startup, the program itself assigns IRONPPT_LICENSE_KEY to IronPPT.License.LicenseKey.
- Never print the key, save it, or list environment variables.
- Stop with a message if IronPPT.License.IsLicensed is false.
- Print only the first line of a licensing error from Save.
4. Before building slides, the code writes qbr-data.json in thousands of dollars:
- Revenue/target: North 1240/1100, South 860/950, East 1410/1300, West 720/900.
- Three commentary lines of your own per region, under 60 characters each.
5. Draw each region's revenue and target as an 800 by 400 pixel PNG bar chart:
- Save charts/<region>.png and a grey background copy, charts/<region>-board.png.
- Encode the PNGs yourself, with no package or imaging library.
6. Build qbr.pptx with these seven slides in order, none blank:
- Title: "Quarterly Business Review" in bold 40 point, "Q3 2026" in 24 point.
- A slide headed "Agenda" listing the four regions.
- One slide per region, highest revenue first.
- A last slide headed "Next steps" with a "South: 90K below target" line per region below target.

Each region slide has:
- Its name as a bold 32 point heading, then one paragraph per commentary line.
- "Revenue 1410K against a target of 1300K" with its figures.
- That line in Color.Green if the target is met, otherwise Color.Red.
- Its chart at x 360, y 140, 320 by 160, all in points.
7. Reopen qbr.pptx from disk and save a board version, qbr-board.pptx, like this:
- Drop the agenda slide.
- Hide "Next steps" without removing it.
- Move the region with the largest shortfall right after the title.
- Swap that region's chart for its -board.png.
- Keep the rest in original order.
- Work around and note any change the save loses.
- As a last resort, rebuild from your data in the new order.
8. Build and run in Release.

The app fills readback.md only from both saved decks, reopened with IronPPT:
- A table per deck of each slide's position, first text line, visibility and image count.
- A section on each step where the guides' approach didn't work.

Its checks give expected, actual and match for both decks:
- Slide count and region order.
- Revenue line color, chart position and size per region slide.
- The board deck's moved region chart against its -board.png, by image bytes.
9. Fix each failed check and rerun, or describe an IronPPT cause nothing gets around and move on.
10. Report the Release build result, checks matched out of total, and your assumptions.
Text

出力

アプリの未編集readback.mdは、そのスライドテーブルとチェックを一覧にし、両方のデッキがアプリが保存したままで入手可能で、qbr.pptxとqbr-board.pptxがあります。 以下の数値は、保存されたPPTX部品の独立した読み取りによるものです。

西部地域の収入を目標に対して描画された棒グラフ、生成されたアプリによる

アプリが独自のPNGエンコーダーで描いた西部チャートのグレーのボードバージョンをqbr-board.pptxに配置、未編集。

  • net9.0のReleaseビルドが警告やエラー無しで完了しました。
  • qbr.pptxは、要求された順序で7枚のスライドを保有しており、どれも空白ではありませんでした。
  • ガイドのリスト呼び出しでは効果がなかった後に、Removeを呼び出すことで新しいデッキが開始したスライドをアプリが削除しました。
  • すべての地域見出しは32ポイントで太字でした。
  • 各収入線は北と東が緑、南と西が赤でした。
  • 2つのデッキのすべての8つの地域スライドは、x 360、y 140ポイントにグラフを配置し、サイズが320x160ポイントでした。
  • qbr-board.pptxはタイトルのすぐ後に180Kの未達地域、西部を直接含む6枚のスライドを保持しました。
  • ボードデッキの中で唯一次のステップスライドが隠されていました。
  • アプリはディスクから開いたqbr.pptxからボードデッキを構築し、西部をそのスライドのIndexプロパティを設定することで移動させました。
  • ボードデッキの西部スライドはアプリが書き込んだPNGのチャートの正確なバイトを保持していました。
  • アプリのリードバックは22のチェックのうち22を一致させました。
  • 独立したリーディングは、60のチェック全てを一致させました。
  • Open XML SDKバリデーターは、各デッキで6つのエラーを報告しました。色付けされた_Run_ごとに1つ。
  • プロジェクトフォルダーのファイル、Gitの履歴、またはClaude Codeセッションファイルのいずれもライセンスキーを含んでいませんでした。
  • セットアッププロンプトは新しいCLAUDE.mdにその11のルールを書き込み、skill.mdをプロジェクトスキルとしてインストールしました。
  • 一部のステップはページと異なる方法で実行されました。 ステップ1、3、5、および7のプロンプトは、同じセッションで受理プロンプトの後に実行されました。

合格条件

  • リリースビルドは手動編集無しで完了します。
  • qbr.pptxはステップ6で設定された順序で7枚のスライドを持ち、どれも空白ではなく、ファイルを自分で読んだ時それを確認しました。
  • 各地域スライドはその見出し、3つのコメント段落、収入線、および要求された位置とサイズに1つのグラフを保持しています。
  • qbr-board.pptxは6枚のスライドを保持し、目標に最も大きく未達の地域がタイトルのすぐ後にあり、次のステップスライドが隠されていました。
  • readback.mdは保存されたデッキから全ての実際の値を取り出し、異なるアプローチが必要だったそれぞれのステップを名前付けします。
  • プロジェクトフォルダーの検索でライセンスキーを含むファイルは見つかりません。
注意してください: 異なるリリースをテストするには、ステップ1のバージョンを編集し、IronPPTの変更履歴を変更について確認してください。

実行記録

  • すべての実行は、Core i9-14900KFと64 GBのメモリを備えたWindows 11 x64デスクトップ1台で行われました。
  • このガイドのプロジェクトはnet9.0をターゲットとし、IronPPT 2026.10.1を固定しています。
  • ガイドの期間はそのページのプロンプトのログ時間の合計であり、このガイドの行は受理プロンプトのみを数えます。
  • 最終テスト日 2026年10月16日、テーブル内のすべてのガイドに対して。
ガイドアシスタントとバージョンモデル期間(分)
このガイドClaude Code 2.1.277、一つのセッション、許可プロンプトオフClaude Opus 518.2
Claude CodeClaude Code 2.1.277、計画モードでのプロンプト3Opus 5を使ったソネット5の計画33.3
ChatGPT CodexCodex CLI 0.160.0GPT-6 Luna22.2
GitHub CopilotCopilot CLI 1.0.98、計画モードでのプロンプト3、課題本文とレビューをそれぞれのセッションでGPT-6 Luna、Auto選択16.1
CursorCursor CLI 2026.10.14、ヘッドレスモード、プロンプト3が計画モードに留まった状態、プロンプト5~7の間に持続Composer 2.515.4
Google AntigravityAntigravity CLI 1.4.0、許可プロンプトをスキップGemini 4 Argon (中)47.4

エージェント固有のガイド

以下の各ガイドは、1つのツールと1つのプレゼンテーションタスクにこれらのステップを適用します。


トラブルシューティング


質問ありますか?

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

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

もっと読む

準備はできましたか?

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