syncfusion-blazor-smart-pdf-viewer について
Blazor開発者向けに、Syncfusion Smart PDF Viewerのドキュメントを基にC#とRazorのコード例を生成するスキルです。参照ファイルに明記されたAPIのみを使い、スマート墨消し、フォーム入力、文書要約、カスタムAIサービス設定を扱います。
主な機能
- 01参照資料に基づくC#とRazorの例を生成
- 02API、プロパティ、メソッドを厳密に確認
- 03AIスマート墨消しとフォーム入力を設定
- 04文書要約とAIアシスタントを設定
- 05カスタムAIサービスを統合
活用シーン
- 01BlazorプロジェクトにSmart PDF Viewerを追加
- 02PDF文書のスマート墨消しを設定
- 03AIフォーム入力を有効化
- 04カスタムチャット推論サービスに接続
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ syncfusion/ pdf-viewer-sdk-skills --skill syncfusion-blazor-smart-pdf-viewerインストール後、Claude Code で/syncfusion-blazor-smart-pdf-viewerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdreferences/custom-ai-service.mddocument-summarizer.mdgetting-started.mdsmart-fill.mdsmart-redaction.md詳細
Syncfusion Blazor Smart PDF Viewer – UI サンプルジェネレーター
NuGet: Syncfusion.Blazor.SfSmartPdfViewer + Syncfusion.Blazor.Themes
名前空間: Syncfusion.Blazor.SmartPdfViewer
ユーザーのプロジェクト向けに C# コードを生成する(デフォルト)
トリガーキーワード: "how to", "add smart pdfviewer", "code sample", "show me", "example", "snippet", "integrate", "component", "create sample", "document summarization", "smart redaction", "smart fill"。
目的: ユーザーが Blazor プロジェクトに直接組み込める、最小限のコピー&ペースト可能な C# および Razor コードを生成します。
ワークフロー:
⚠️ 重大 — 機能サポートポリシー(厳格モード):
基本ルール: リファレンスファイルに明示的に記載されている API とプロパティのみを使用してコードを生成してください。それ以外はすべて違反です。
-
コード生成前の必須確認事項:
- リファレンスファイルで API/プロパティ名を正確に検索します
- メソッドリファレンス、プロパティ、またはイベントの表に記載されていることを確認します
- いずれのリファレンスファイルにも記載されていない場合は、直ちに停止します
- 文書化されていない API を、いかなる状況でも生成または提案してはいけません
-
厳格な適用 — 例外なし:
- カスタムプロパティは禁止 — リファレンスファイルの表にあるプロパティのみ使用します
- メソッドの創作は禁止 — リファレンスファイルの表にあるメソッドのみ使用します
- 未定義 API を使った回避策は禁止
- 文書化されていない動作についての推測は禁止
- 推測に基づく代替実装は禁止
- サポートされていると装うことは禁止
-
未サポート機能に対する必須の応答:
- 要求されたシナリオ/機能/API が、いずれのリファレンスファイルにも記載されていない場合、必ず次のように回答します:
"This feature is not supported in the current Syncfusion Blazor Smart PDF Viewer implementation." - 続けて、該当するリファレンスファイルに記載されているサポート対象を列挙します
- リファレンスファイルに明示的に記載されていない限り、代替案を提案してはいけません
- 要求されたシナリオ/機能/API が、いずれのリファレンスファイルにも記載されていない場合、必ず次のように回答します:
-
リファレンスファイルの優先順位:
- 各リファレンスファイルには、その対象分野に関する完全かつ正式なドキュメントが含まれています
- 表(メソッドリファレンス、プロパティ、イベント)が信頼できる唯一の情報源です
- リファレンスファイル内の表以外の内容は、説明用に限られます
- リファレンスファイルの表に記載されている範囲を超えてはいけません
-
生成内容の監査:
- コードを提示する前に、使用するすべての API がリファレンスファイルの表に記載されていることを確認します
- 各 API の出典となるリファレンスファイルを明記します
- リファレンスファイルの表の項目を引用できない場合は、そのコードを削除します
-
これは重大な要件です。 違反すると、このスキルの完全性と信頼性が損なわれます。
ステップ 1 — アプリケーションの種類を検出する(必須 — 省略禁止)
- file_search および read_file ツールを使用して、ワークスペース内のプロジェクトファイルを確認します:
.csprojファイル(プロジェクト設定)Program.cs(起動設定)_Imports.razor(名前空間のインポート)App.razor(ルートコンポーネント)- Components/Pages 内にある既存の
.razorファイル
- 出力: 次に進む前に、検出したアプリケーションの種類(例:「Blazor WebApp」または「Blazor Server」)を確認します。
ステップ 2 — リファレンスファイルのみからコードを生成する (必須)
- 生成する前に: ステップ 1 が完了していることを確認します
- 要求された機能に関連する
references/*.mdファイルを読みます - すべての API、プロパティ、メソッドをこれらの表と照合します
- 宣言のみのアプローチ(必須 — ライフサイクルメソッドは禁止):
- Razor マークアップでは、類似のライフサイクルメソッドではなく、プロパティバインディングのみを使用します。
- すべての Smart PDF Viewer プロパティをコンポーネント属性として直接設定します
- 必須: コードを生成する前に、リファレンスファイルが存在し、アクセス可能であることを確認します
- 適切なリファレンスファイルを読みます(要求された機能に応じて選択):
- 関連する
references/*.mdファイルに対してread_fileツールを使用します - ファイルに Methods/Properties/Events の表が含まれていることを確認します
- 表が完全で、読み取り可能であることを確認します
- 関連する
- リファレンスファイルが見つからない場合、または読み取れない場合:
- コード生成を停止します
- 次のように回答します:"Reference file for this feature is not available. Please ensure all reference files are present in the
references/directory." - 不足しているリファレンスファイル名を列挙します
- このステップは必須の前提条件です: リファレンスファイルの検証なしでは先に進めません
- API/プロパティがリファレンスファイルの表に記載されていない場合は、使用しないでください
- リファレンスファイルに明記されていない API、メソッド、プロパティ、クラス、名前空間を作り出したり、推測したり、提案したりしないでください
コードリファレンス
すべてのテンプレートと操作スニペットは references/*.md にあります。各ファイルには、エージェントがサンプルを生成する際に組み合わせる、特定の用途に絞ったスニペットまたはテンプレートが含まれています。
| ファイル | 用途 |
|---|---|
| getting-started.md | 基本的なセットアップと最小構成の Smart PDF Viewer コンポーネントです。NuGet パッケージのインストール、サービス登録、Azure OpenAI の設定、セットアップに必要な前提条件一式が含まれます。 |
| smart-redaction.md | AI を活用したスマート墨消しの設定です。墨消しの有効化/無効化、カスタム墨消しパターン(人物名、メールアドレス、電話番号、クレジットカード番号など)、デフォルトのパターン定義について説明します。 |
| smart-fill.md | スマートフォーム入力の設定です。AI を活用した PDF フォームフィールドの自動入力に使う SmartFillSettings クラス、有効化/無効化の制御、統合ガイドラインについて説明します。 |
| document-summarizer.md | ドキュメントの要約と AI アシスタントの設定です。ShowPromptSuggestions、Prompt バインディング、PromptChanged コールバック、Placeholder、MinLength、リアルタイム AI 応答のための StreamResponse など、AssistViewSettings のパラメーターが含まれます。 |
| custom-ai-service.md | カスタム AI サービスの統合ガイドです。IChatInferenceService インターフェースの実装、Program.cs でのサービス登録、ErrorDialogService を使ったエラー処理、カスタムチャットクライアントの統合パターンについて説明します。 |
クイックスタートの例
@rendermode InteractiveServer
コンポーネントを追加:
<SfSmartPdfViewer Height="100%" Width="100%" DocumentPath="@DocumentPath">
</SfSmartPdfViewer>