syncfusion-dotnet-powerpoint

PowerPoint（PPTX）プレゼンテーションの処理

概要

Syncfusion Presentation Library を使用して、PowerPoint（.pptx）ファイルを作成、編集、変換します。 このスキルでは、C# コードをユーザーのプロジェクト用に生成するモードと、CSX スクリプトを使ってタスクを直接実行するモードの、2 つの操作モードをサポートしています。

主な機能

• 作成・編集： プレゼンテーション（.pptx）、スライド（複製と結合）、段落、テキストボックス、表、図形、画像、リスト、コネクタ、ハイパーリンク、ヘッダー／フッター、コメント、ドキュメントのプロパティ、セクション
• 高度な機能： カスタムアニメーションとスライド切り替え、マスタースライドのレイアウト、発表者ノート、SmartArt、OLE オブジェクト、検索と置換、マクロ、グラフの作成と編集、グラフから画像への変換
• 変換： PowerPoint から PDF、PowerPoint から画像（PNG、JPEG）
• セキュリティ： プレゼンテーションの暗号化と復号、書き込み保護の設定と解除

前提条件

• .NET SDK 8+ と dotnet-script：dotnet tool install -g dotnet-script
• 無料ライセンス：https://www.syncfusion.com/products/communitylicense

クイックスタートの例

例 1：コードの生成（モード 1）

ユーザー：「シンプルな棒グラフを含む PowerPoint プレゼンテーションの作成方法を教えてください」

**結果：**C# コードのスニペットが表示されます（ファイルは作成されません）

例 2：タスクの実行（モード 2）

ユーザー：「output/SalesChart.pptx にシンプルな棒グラフを含む PowerPoint プレゼンテーションを作成してください」

**結果：**グラフを埋め込んだファイルが output/SalesChart.pptx に作成されます

2 つのモード — ユーザーの意図に応じて選択

モード 1：ユーザーのプロジェクト用に C# コードを生成 (デフォルト)

ユーザーが PowerPoint の処理に関連する C# コードを閲覧、記述、レビュー、リファクタリング、または変更したい場合は、このモードを使用します。

トリガーとなるキーワード：「方法を教えて」「方法」「どうすれば」「どうやって」「コードを提供して」「例を提供して」「例を示して」「実演して」「コードスニペット」「サンプルコード」「例」「サンプル」「教えて」「見せて」「Program.cs」「コード例」「コードを生成して」「codesnippet」。

ワークフロー：

ステップ 1 — アプリケーションの種類を検出し、必要な NuGet パッケージを提案する

• ワークスペースのプロジェクトファイル（.csproj、web.config、App.config、Startup.cs、Program.cs など）を調べ、references/nuget-packages.md の検出シグナルの表を使用してアプリケーションの種類を判断します。
• 検出したアプリケーションの種類に基づいて、references/nuget-packages.md から適切な NuGet パッケージを特定し、コードを生成する前にインストールするようユーザーに案内します。

ステップ 2 — 参照ファイルのみを使ってコードを生成する

参照ファイルに明記されていない API、メソッド、プロパティ、クラス、または名前空間を、作り上げたり、推測したり、提案したりしないでください。

• 要求された機能に関連する references/*.md ファイルを読みます
• それらのファイルに記載された API とスニペットのみを使って C# コードを作成します
• ステップ 1 で検出したアプリケーションの種類に応じて、適切なスニペットの種類を選択します：
  • Windows 固有のアプリ（WinForms、WPF、.NET Framework Console、ASP.NET MVC4/5）→ Windows 固有のスニペットを使用
  • クロスプラットフォームアプリ（ASP.NET Core、.NET Core/.NET 5+ Console、Blazor、MAUI）→ クロスプラットフォーム／.Net.Core スニペットを使用
• .csx スクリプトを作成または実行しないでください

---

モード 2：CSX スクリプトで実行 (プロジェクトファイルには触れません)

ユーザーが実行、ファイル生成、または完成した PPTX ファイルなどの完全な出力を明示的に要求した場合に限り、このモードを使用します。

トリガーとなるキーワード：「プレゼンテーションを作成して」「プレゼンテーションを作って」「プレゼンテーションを生成して」、.pptx ファイルを「開く」「編集する」「変更する」、 「プロジェクトを変更せずに」、「csx スクリプトを実行して」、またはユーザーがファイルパス（例：output/report.pptx）を提示した場合。

ワークフロー：

ステップ 1 — 一時 CSX スクリプトを作成する

• references/template.csx をベースとして使用します
• {skill-root}/syncfusion-dotnet-powerpoint/scripts/temp-{uniqueId}.csx に作成します（例：skill-root = .codestudio/skills）
• 一意のファイル名にはランダムな GUID を使用します（例：temp-a3f7b2c1.csx）。ワークスペースのルートには絶対に作成しないでください

ステップ 2 — リファレンスファイルを基にスクリプトを作成

• リファレンスファイルに記載されていない API／メソッドを作り出さないでください
• 関連する references/*.md ファイルを読み、コードスニペットを抽出してください
• すべてのプレースホルダー（ファイルパス、ドキュメントのプロパティ、データ値、フィールド名など）を置き換えてください

ステップ 3 — スクリプトを実行

• 実行：dotnet script {skill-root}/syncfusion-dotnet-powerpoint/scripts/temp-{uniqueId}.csx
• 実行が成功したことを確認し、エラーがあれば記録してください

ステップ 4 — クリーンアップして報告

• 実行後、テンポラリーの .csx ファイルを削除してください
• SUCCESS／ERROR と、出力ファイルのパス、および修正方法を含むエラーメッセージを報告してください

---

コードリファレンス

すべてのテンプレートとスニペットは references/ フォルダーにあります。

ファイル	内容
template.csx	基本的な CSX スクリプト構造（モード 2 のみ）
presentation-structure.md	プレゼンテーションの作成／保存／終了、スライドレイアウト、ページサイズ、ドキュメントのプロパティ
slides.md	PowerPoint スライドの追加、削除、サイズ変更、カスタマイズ、スライドの印刷
layout.md	マスタースライドとレイアウトスライドへのアクセス、カスタマイズ、作成
paragraph.md	テキストボックスや図形での段落の追加、書式設定、管理
sections.md	プレゼンテーション内のセクションの作成と変更
tables.md	プレゼンテーション内の表の作成と変更
shapes.md	プレゼンテーション内の図形（オートシェイプ、画像、テキストボックス、グループ化された図形）の追加、反復処理、書式設定、削除
connectors.md	図形間のコネクタの追加、編集、更新、削除
image.md	SVG 対応を含む画像の追加、置換、トリミング、削除
list.md	番号付きリスト、箇条書きリスト、画像リスト、複数レベルのリストの作成
chart.md	プレゼンテーション内のグラフの作成と編集
animation-transition.md	プレゼンテーション内のスライド切り替えとアニメーション効果の追加、変更
comments.md	プレゼンテーション内のコメントの追加、返信、変更、削除
header-footer.md	スライド番号や日付を含むヘッダーとフッターの追加、編集、削除
notes.md	プレゼンテーションの発表者ノートの追加、編集、書式設定、削除
ole-objects.md	スライドへの OLE オブジェクト（Excel、Word、Visio）の挿入、抽出、管理
conversions.md	プレゼンテーションの画像および PDF への変換
encrypt-decrypt.md	セキュリティ：プレゼンテーションの読み取り／書き込みアクセス時の保護、暗号化、復号
find-and-replace.md	特定のスライドまたはプレゼンテーション内での検索と置換、検索とハイライト表示
smartart.md	PowerPoint プレゼンテーションでの SmartArt の作成、ノードの追加、編集、削除
hyperlinks.md	Web、メール、ブックマーク、ファイル、画像へのハイパーリンクの追加または変更
macros.md	プレゼンテーション内のマクロの読み込み、保存、削除、管理
markdown-conversion.md	PowerPoint プレゼンテーションと Markdown の相互変換、画像のエクスポートパスのカスタマイズ、Markdown のエンコードオプションの設定

---

ルール

• 出力ファイルは ./output/ ディレクトリに保存してください
• テンポラリーの .csx スクリプトは {skill-root}/syncfusion-dotnet-powerpoint/scripts/ 内に作成してください。ワークスペースのルートや顧客の scripts/ フォルダーには作成しないでください
• Python ライブラリ（例：python-pptx）は使用しないでください
• 実行後、テンポラリーの .csx ファイルを残さないでください