IronPPTをChatGPT Codexで使用する方法
営業オペレーションチームは毎週月曜日に同じデッキを送信します。 テンプレートがスライドを提供し、週の数値がそれを埋めます。 単一の地域スライドが1つのスライドあたり1つの地域になり、古くなったプロモーションスライドが削除され、付録はファイル内に残りますがスライドショーからは除かれます。 スライド操作が静かに失敗した場合でも、デッキは保存され、ジョブログは成功を報告します。 地域マネージャーは6月30日に終了したプロモーションの概要を受け取りますが、これは今週のハイライトより1スライド前です。
ChatGPT CodexはOpenAIのコーディングエージェントです。 これはリポジトリで動作し、ファイルを編集し、dotnet runのようなコマンドを実行し、変更内容を報告します。 同じエージェントがターミナル、IDE拡張機能、ChatGPTデスクトップアプリ、クラウドで動作します。 IronPPTはMicrosoft Officeを使用せずに.pptxファイルを作成、開く、編集、保存します。
Codexは毎週の営業テンプレート、規則ファイル、2週間分の地域データを取得します。 報告されるスライドカウントは、同じターンで書かれたCSVから取得され、バッチコードがそれに依存する前に、各スライド操作が保存されたデッキでテストされます。
クイックスタート.NET 9のコンソールプロジェクトでTemplatesとDataフォルダーを含む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()を使用してテンプレートスライドを削除し、移動または繰り返されたスライドを新しいスライドとして作成します。 - 保存されたデッキを再度開き、すべてのスライドを計画と比較します。
ChatGPT Codexとは何で、.NETプレゼンテーション作業にどのように適合するのですか?
/permissionsのコマンドは、Codexがファイルを編集したり、コマンドを実行したりする際に確認を求める設定を行います。Codex CLI ドキュメントはインストールとターミナル利用をカバーし、オープンソースリポジトリがそのリリースを公開しています。
CodexのIronPPTに関する知識は、訓練データと提供されたファイルから得られています。 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を読み込みます。 リポジトリのルートから作業フォルダーまで下り、ディレクトリあたり最大1つのファイルを選び、より深いファイルがより浅いものを上書きします。 /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は読み取るたびに新しいリストを返し、それらの呼び出しはそのコピーだけを変更します。 キャリブレーション中に、6スライドのデッキに対してSlides.RemoveAt(0)を適用してもカウントは6のままで、移動後に保存されたデッキは元の順序を保持しました。 コードはコンパイルし、例外を発生させず、削除予定だったスライドを保存します。
既存のスライドに対する3つの操作はデッキに到達します。 スライド自体に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をスローし、同じスライドオブジェクトを2度追加しても保存されたファイルには余分なスライドはありません。スライドを削除して末尾に再追加すると、古い位置に空のスライドが残りました。 機能する方法は、各出力スライドに新しいSlideを追加し、デッキが必要とする順序で新しいテキストでそれを満たし、テンプレートオリジナルにRemove()を呼び出すことです。
ロードされたデッキからスタイリングをコピーすることも失敗します。 キャリブレーションでは、プロパティごとにコピーした36ポイントの見出しが3,600ポイントで書かれ、その色#1F4E79は黒になりました。 したがって、プロンプトはREADMEのハウススタイルをすべてのテキストに設定します。
テンプレートはREADMEのスライドリストに従い、第5にQ2 Promotion Recap、第6にHighlightsが記載されています。
weekly-sales-template.pptxをダウンロード
テストランで使用された週次営業テンプレートで、地域トークンを保持する1つの地域スライドがあります。
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の長い形式)で1つ渡すか、インタラクティブコンポーザに貼り付けます。
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.
編集を許可する前に診断を見直してください。 レガシージョブは呼び出しが返った後に各ログ行を書き、デッキを再び開きませんでした。
一度限りのコードを再利用可能でテスト済みのコンポーネントに変えるにはどうすればよいですか?
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に送り、1つのセッションで行われました。 レガシージョブ、そのログ、およびそのデッキはデバッグプロンプトの前に追加されました。 別のスクリプトが保存されたすべてのデッキを再び開き、ファイルから各スライドを読み取りました。
- 実行前にはテンプレートが8枚のスライドを持ち、すべてが表示されていました。
- 変数をクリアした状態で保存はライセンス例外をスローし、その後出力ファイルは存在しませんでした。
- 変数を設定し、スタートアップコールをスキップした状態でも、保存は同じ方法で失敗しました。
- プローブでは、Slides.RemoveAt(4)が保存されたファイルに8枚全部のスライドを残しました。
- 地域スライドに対するClone()はMissingMethodExceptionをスローしました。
- Codexは3つのサブエージェントを開始し、デバッグプロンプトでプローブプロンプトからエクスプローラーエージェントを再利用しました。
- 保存された週41のデッキは、READMEの順序で11枚のスライドを保持し、5枚の地域スライドはCSV順でした。
- 10枚のスライドが表示され、付録は隠しとして保存されました。
- Q2 Promotion Recapはデッキから欠落していました。
- 東は$0の収益を持つスライドを保持しました。
- 拒否されたv2テンプレートは既存のデッキのSHA-256ハッシュをそのままにしました。
- Codexはスクリーンショットを週40の西の数値に一致させました。
- 診断は、週40の4つの問題それぞれをレガシージョブの行に結びつけました。
- 診断は、隠された北のスライドを、Slides.Last()が返した再利用された地域スライドに追跡しました。
- DeckServiceで作成されたデッキが、最初のビルドとすべてのスライドで一致しました。
- Codexの実行と当社の実行で5つのテストすべてが合格しました。
- 一部のステップはページと異なる方法で実行されました。 サンドボックスにはネットワークがなかったため、NuGetパッケージは実行前に復元されたキャッシュから取得されました。
GitHub Copilotガイドは、画像についての同様の失敗を測定し、管理画像ガイドのReplaceコールがロードされたデッキに古い写真を残す場合を示します。 Google Antigravityガイドは、IronPPTがすべての呼び出しに単一のロックを使用して正しく処理する場合にのみ、同時にWebリクエストのためのデッキを構築します。 共有された実行記録は、Codexのバージョン、モデル、タイミング、テストマシンを示します。
トラブルシューティング
Showでスライドを隠し、ファイルに保持するためのスライド管理- ロードされたデッキからスタイルをコピーする代わりに新しいテキストにテキストスタイルを設定するためのスライド要素
- プロダクションライセンスが必要であるため、すべての保存が失敗する場合のライセンスキーの適用
質問ありますか?
質問がある場合は、support@ironsoftware.com にお問い合わせください。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。