agent-onboarding

Syncfusion オンボーディング

Syncfusion を使う際は、まずこのスキルを利用してください。タスクを公式のフレームワークまたはコンポーネントのスキルに振り分けます。ここで Syncfusion の API を記憶に頼って再現しようとしないでください。Syncfusion はウェブ、デスクトップ、モバイル、ドキュメント処理、ビューアー、エディターの各製品にまたがっており、同じコンポーネント名でも、パッケージ、インポート、登録、ライセンスのルールは製品ごとに異なります。フレームワークをまたいだ推測は、Syncfusion のコードがコンパイルできない最大の原因です。2 番目の原因は、同じプラットフォーム内での名前の衝突です。ユーザーが入力した単語があるコンポーネントに一致していても、求めている動作は別のコンポーネントが担うことがあります。名前だけで判断せず、インベントリの説明と必要な動作を照らし合わせて解決してください。

動作モード

このスキルは 2 つのモードで動作します。どちらのモードも説明的な要約ではなく、実行可能な手順です。必要な証拠を示す成果物を作成せずに最終報告に進んだ場合、そのモードを完了したことにはなりません。手順を説明しただけです。

厳守事項 — スキル名を挙げる前にインベントリを読む

このルールは、セットアップモードのステップ 2（インベントリの導出に使うプラットフォームインデックスを読む）と、タスクモードのステップ 3（保持されたセッションインベントリを使う）に適用されます。どちらのモードを開始する場合も、最初にこのルールを満たさなければなりません。

Syncfusion のコンポーネントスキルについて、名前を挙げたり、インストールしたり、コードを書いたりする前に、このセッション中に https://ai.syncfusion.com/<platform-slug>/inventory.txt のプラットフォームインベントリを読んでおく必要があります。このセッション中に読んでいない場合は、今すぐ読み、先に進まないでください。

ユーザーがコンポーネントを求めた場合、何かをする前に、たとえば「スキル X をインストールします」と言ったりコードを書いたりする前に、次のことを行ってください。

1. 検討した候補スキルを示します（記憶からではなく、インベントリに基づくもの）。
2. ユーザーの依頼から推測した必要な動作を示します。
3. 一致する根拠（該当するインベントリ項目、名前、または説明）を示します。
4. 読んだインベントリファイルを引用します。

その動作に該当するインベントリ項目がない場合は、その旨を明確に伝え、先に進む前に人間に確認してください。直前に読んだインベントリに記載されていないスキル名、パッケージ名、インポートパスを提案してはいけません。名前の根拠が学習データしかない場合は、未検証と明記し、インベントリまたはインストール済みの SKILL.md を引用できるまで中断してください。

厳守事項 — パッケージはマニフェストの編集ではなく、パッケージマネージャーでインストールする

パッケージのインストールとは、パッケージマネージャーの実行、レジストリによる依存関係の解決、ピア依存関係の調整、ロックファイルの更新、そして node_modules などの同等のディレクトリへのパッケージの配置を意味します。マニフェストファイルを手動で編集しても、これらは何も実行されません。

Syncfusion パッケージ、または Syncfusion の変更が依存するプロジェクトのパッケージをインストール、アップグレード、ダウングレード、移行、削除する場合：

• 必ずパッケージマネージャーを実行してください。 React ／ Angular ／ Vue ／ JavaScript では、npm install <pkg>、pnpm add <pkg>、または yarn add <pkg> を使用します。.NET では dotnet add package <pkg>、Flutter では flutter pub add <pkg> を使用します。プロジェクトですでに使用しているマネージャーを使い、別のマネージャーに切り替えないでください。
• マニフェストを手動で編集してはいけません。 パッケージのインストールにあたり、package.json ／ .csproj ／ pubspec.yaml に行を追加してはいけません。パッケージマネージャーを実行せず、マニフェストにパッケージ名を記入した状態は、壊れたインストールです。ピア依存関係の解決も、node_modules ／ obj ／ .dart_tool の作成も、ロックファイルの更新も行われません。次回の npm install ／復元時に、その行が黙って書き換えられるか、処理が失敗します。
• バージョン文字列はエディターではなく、ルールに従って指定してください。 npm ではメジャーバージョン指定子（@33）を使用し、ロックファイルを信頼できる情報源とします。NuGet では毎回 --version <exact> を指定します。Flutter では、既存の制約に基づいて '^X.Y.Z' を渡します。
• 例外は、環境が無効化されている場合のみです。 この環境でパッケージマネージャーを実行できない場合（ネットワークがない、サンドボックス化された実行環境、ユーザーの承認が得られないなど）は、作業を中止し、人間に確認してください。代わりにマニフェストを編集してはいけません。人間がターミナルで実行する正確なコマンドを伝えてください。
• マニフェストは読み取り専用の入力です。 既存のバージョンや手がかりを調べるために確認しますが、インストールの手段ではありません。1 分後に変更を元に戻す予定でも、このルールを適用してください。古いマニフェストの行を残すことも差分の原因となり、後続のエージェントには元に戻す意図が伝わりません。
• 証跡。 レポートに「インストールしたパッケージ」と記載する場合は、マニフェストの差分ではなく、実行した正確なパッケージマネージャーのコマンドと終了ステータスを示す必要があります。マニフェストの差分はインストーラーが生成するものであり、エージェントが生成するものではありません。

このルールで防止できる失敗例：

• package.json にパッケージが記載されていても、ロックファイルで解決されていない → 次回の npm install で黙って元に戻され、エージェントはインストールが成功したと思い込む。
• package.json でバージョンが固定されている一方、node_modules には別のバージョンがある → ローカルではテストに合格するが、CI では復元時に失敗する。
• .csproj に <PackageReference> が記載されているのに dotnet restore が実行されていない → 最初のビルドで NU1605／NU1105 が発生し、開発者が同じ壊れたワークフローを再実行する。
• pubspec.yaml に syncfusion_flutter_* が記載されているのに flutter pub get が実行されていない → コンパイル時には兆候が現れず、実行時に「パッケージが見つからない」となる。
• パッケージマネージャーが実行されていないため、エージェントが把握できないピア依存関係の不整合（例：@syncfusion/ej2-react-grids の react の不一致）。

セットアップモード

ユーザーが次のことを依頼した場合に開始します。

• Syncfusion をセットアップする
• プロジェクトのオンボーディングを行う
• AI エージェントを準備する
• Syncfusion スキルを設定する

セットアップモードではスキルのインストールを実行します。説明するだけではありません。 手順 8 の検証に合格していない状態で「インストールします」や「インストールするスキル」という言葉を含む応答は、セットアップモードが完了しておらず、不完全です。手順 10 が合格するまで最終レポートを作成してはいけません（レポート自体に、手順 4 の Fresh Version Gate の行と、手順 8 のディスク上の証跡を含める必要があります）。

各手順にはゲートがあります。次の手順に進む前に、各手順の必須の証跡を作業出力に示す必要があります。証跡がない場合は、作業を中止してその手順を修正してください。

#	手順	次の手順に進む前に必要な証拠となる成果物
1	リポジトリのマニフェスト（package.json、*.csproj、pubspec.yaml、*.sln、syncfusion.config.json）からプラットフォームを検出します。	Platform: <slug> と、判定に使用したマニフェストの情報を示す1行の記述。
2	プラットフォームのインデックス https://ai.syncfusion.com/<platform-slug>/llms.txt を読みます。	読み込んだプラットフォームインデックスファイルのパス。
3	プロジェクトのマニフェストを調べ、既存の Syncfusion パッケージを確認します。	package.json／*.csproj／pubspec.yaml からそのまま取得した name@version の箇条書き。
4	最新バージョンの確認ゲート — 必須。 プロジェクトのマニフェストとロックファイルを再度読み込みます。references/version-resolution.md のパッケージマネージャーのルールに従い、プロジェクトの Syncfusion バージョンを特定します。npm = 共通メジャーバージョン、NuGet = 正確なバージョン、pub.dev = 正確な制約です。記憶を頼りにバージョンを推測しないでください。Syncfusion がまだインストールされていない場合は、no existing packages と記録し、プラットフォームのファミリー内で最新の安定版を使用します。	Project Syncfusion version (package-manager rule): <value> という1行の記述（npm の場合：npm shared major=<N>、NuGet の場合：exact=<X.Y.Z>、Flutter の場合：constraint=<^X.Y.Z>、または no existing packages）。競合がある場合は、停止して報告してください。
5	検出された Syncfusion のコンポーネント、コントロール、ライブラリ、ビューアー、エディター、SDK、または移行タスクごとに、npx skills add syncfusion/<repo> --skill <detected-component-skill> を実行します。コンポーネント1つにつき npx skills add を1回実行します。まとめて実行しないでください。	実行した正確なコマンドと、ターミナルの終了ステータス／出力の抜粋。
6	Syncfusion のパッケージが存在しない場合は、コンポーネントスキルをインストールしないでください（Setup Mode で「インストールしない」唯一のルールです）。セットアップ中に Syncfusion 製品パッケージをインストールしないでください。後で Syncfusion 製品パッケージを追加、アップグレード、ダウングレード、または削除する場合（Task Mode）は、必ずパッケージマネージャー（npm install、pnpm add、yarn add、dotnet add package、または flutter pub add）を呼び出し、マニフェスト、ロックファイル、依存関係ツリーを更新させてください。マニフェストを直接編集しないでください。	Packages detected: <list or "none"> という1行の記述と、手順5のコマンド、またはインストールしないという明示的な判断。Task Mode でパッケージを追加／アップグレードする場合、証拠となるのは実行した正確なパッケージマネージャーのコマンドと終了ステータスであり、マニフェストの差分ではありません。
7	MCP が利用可能かどうかを検出します（syncfusion.config.json の mcp ブロックと、ホストエディターの MCP 設定ファイルがあればそれを読み込みます）。	読み込んだファイルパスを添えた MCP の状態。
8	インストールによってファイルが書き込まれたことを確認します。 対象のスキルディレクトリを一覧表示し、インストールされたすべての SKILL.md が存在することを確認します。	ディスク上の SKILL.md のパスが示された ls／dir／Get-ChildItem の出力。インストールに失敗した場合、またはファイルが書き込まれていない場合は、停止して失敗を報告してください。手順9に進まないでください。
9	プラットフォームレジストリのインデックス https://ai.syncfusion.com/r/<platform-slug>/registry.json を取得します（プラットフォームにレジストリがない場合はスキップします）。個々のバリアントファイルは取得しないでください。これは Task Mode で行います。	Registry index fetched: <url or "no registry for platform"> という1行の記述。
10	以下の必須出力テンプレートを使用して、Setup Mode のレポートを作成します。	すべてのフィールドが記入され、ディスク上のすべてのパスが明記された、テンプレートに沿ったレポートそのもの。

手順5（スキルのインストール）のコマンドフラグ：

• インストール時にプロンプトで停止しないよう、非対話モードの -y を使用します。
• ホストのエージェントが判明している場合（例：--agent codestudio、--agent cursor、 --agent claude-code）は --agent <name> を使用します。共有の .agents/skills/ ディレクトリにインストールする場合は省略します。
• ホストで必要な場合は、ネットワークを使用するインストールの前にホストの認証ルールに従ってください。
• 検出されたコンポーネント1つにつき npx skills add を1回実行します。まとめて実行しないでください。

セットアップモード — 必須の出力テンプレート

ステップ 10 の最終報告では、以下のテンプレートを使用する必要があります。すべての項目が必須です。**項目を省略しないでください。項目を「上記を参照」で要約しないでください。**該当しない項目には <reason> と記載してください。

## Setup Mode report

Platform: <slug from /llms.txt platform-slug table>

Project Syncfusion version (Fresh Version Gate, step 4 — package-manager rule):
- <npm shared major=<N> | NuGet exact=<X.Y.Z> | pub.dev constraint=<^X.Y.Z> | no existing packages>

Detected Syncfusion packages (from project manifest):
- <name>@<version>   (source: <manifest file>)

Packages installed (Task Mode only — list commands executed by the package manager):
- <exact npm install / pnpm add / yarn add / dotnet add package / flutter pub add command>   (exit code: <N>)

Installed skills (on-disk proof, from step 8):

Skill install commands executed:
- <exact npx skills add … command>

Installed skills (on-disk proof, from step 8):
- <absolute path to installed SKILL.md>   (ls/dir output: <one-line snippet>)

Registry index: <url fetched | "no registry for platform">

MCP status: <integrated | not integrated>
  - config file read: <path or "none">
  - server name(s): <sf-<platform>-mcp>

Licensing status: <license key present | license key absent>
  - license registration site: <https://…>
  - registerLicense call site: <file:line or "not present">

Human action required: <bulleted list, or "None — setup is autonomous">

このテンプレートに一致しない応答では、セットアップモードは完了していません。

新規プロジェクト

プロジェクトに Syncfusion パッケージが含まれていない場合があります。

この場合：

• プラットフォームを検出します。
• コンポーネントスキルをインストールしないでください。
• Syncfusion 製品パッケージをインストールしないでください。
• 上記のテンプレートを使用して、既存の Syncfusion の使用が検出されなかったことを報告します。Detected Syncfusion packages: none および Human action required: None — no Syncfusion usage detected と記載してください。これはセットアップモードの完了であり、回避ではありません。

次の場合にのみコンポーネントスキルをインストールします：

• 既存の Syncfusion の使用が検出された場合、または
• ユーザーが新しい Syncfusion 機能をリクエストした場合。

タスクモード

ユーザーが Syncfusion のコード、コンポーネント、コントロール、ライブラリ、アップグレード、移行、トラブルシューティングを依頼した場合に開始します。

作業を進める前に：

1. プロジェクトのマニフェストを読み直します。
2. **最新バージョンゲート — 必須。**マニフェストとロックファイルを読み直します。references/version-resolution.md のパッケージマネージャーのルールを使用して、プロジェクトの Syncfusion のバージョンを特定します：npm = 共通メジャーバージョン、NuGet = 正確なバージョン、pub.dev = 正確な制約。記憶を頼りにバージョンを推測しないでください。このルールを満たすバージョンでない限り、Syncfusion パッケージをインストールしないでください。新しいパッケージをインストールする場合は、このルールを満たす最新の公開リリースをインストールします。競合がある場合は作業を中止して報告し、自分でバージョンをそろえないでください。必須の証拠成果物：Project Syncfusion version (package-manager rule): <value>。
3. 保持されているセッションインベントリから、該当するコンポーネントスキルの候補を特定します。ユーザーが入力した単語ではなく、必要な動作に基づいて照合します。ハードルールで指定されたとおり、候補、必要な動作、根拠（該当するインベントリエントリー）を明示します。同じセッション内でインベントリがこのリクエストをすでに解決している場合に限り、この手順を省略します。
4. 必要に応じて不足しているスキルをインストールします。検出したコンポーネントごとに npx skills add --skill <name> を 1 回実行します。プラットフォームパック全体をインストールしないでください。
5. プラットフォームレジストリを参照し、該当するバリアントがあれば、選択したテンプレートに適用します。
6. 選択したコンポーネントの SKILL.md を最後まで読み、タスクに必要な参照資料のみを読みます。
7. パッケージをインストールする前に、バージョン解決ポリシーに従います。
8. 実装を続行します。

まずルートを特定する

ほとんどの場合、最も速く正確な手順は次のとおりです。

1. リポジトリのマニフェストからプラットフォームを特定します。
2. そのプラットフォームの https://ai.syncfusion.com/<platform-slug>/llms.txt を取得します。これだけで必要な情報がそろいます。 スキルパック、パッケージ、ライセンス登録、完全なサンプル、検証チェックリストが含まれています。
3. プラットフォームのインベントリ（https://ai.syncfusion.com/<platform-slug>/inventory.txt）は、セットアップ時に一度だけ読み込みます。リクエストごとに読み込む必要はありません。そこから、各コンポーネントスキルのカテゴリ、パッケージ、説明が対象とする動作をまとめたセッションインベントリを作成します。セッションのメモリーが保持される間は、以降のセッション中、このセッションインベントリをルーティング情報源として使用します。
4. セッションインベントリから候補となるコンポーネントスキルを列挙し、必要な動作に基づいてスキルを選択します。
5. プラットフォームのレジストリを取得し、最も近いバリアントを選んで適用します。テンプレートが要件に合わない場合に限りスキップし、コンポーネントスキルを使って、その理由を明記します。
6. Syncfusion パッケージのインストール、アップグレード、ダウングレード、またはコード生成を行う前に、Fresh Version Gate を実行します。マニフェストとロックファイルを再読込します。references/version-resolution.md のパッケージマネージャー別ルールに従って、プロジェクトの Syncfusion バージョンを特定します。npm は共通のメジャーバージョン、NuGet は正確なバージョン、pub.dev は正確な制約を使用します。記憶を頼りにバージョンを推測したり、NuGet や Flutter で npm 方式の「同じメジャーバージョン」を既定で使用したりしないでください。競合がある場合は中断して報告し、自分でバージョンをそろえてはいけません。
7. プラットフォームをまたぐ場合だけでなく、プラットフォーム内でも、キーに触れる前に https://ai.syncfusion.com/licensing.md を読みます。「イベントを表示するカレンダー」は、Calendars スキル（日付選択入力）と Scheduler スキル（イベントや予定の管理）の両方に該当します。
8. ユーザーが入力した単語ではなく、必要な動作に基づいて選択し、前述の「Hard rule」チェックリストの要件どおりに、候補、選択、根拠を明記します。候補が2つ残り、その選択によって実装が変わる場合は、短い質問を1つだけして中断します。
9. 検出された Syncfusion の使用状況または現在のタスクに必要なコンポーネントスキルのみをインストールします。
10. キーに触れる前に https://ai.syncfusion.com/licensing.md を読みます。

同じセッション内の以降のリクエストは、セッションインベントリを使って解決します。インベントリを再取得しないでください。これは、「Grid を追加して」のような直接的なリクエストにも、「PDF ファイルを表示して」「ドキュメントを編集して」「カレンダーにイベントを表示して」のようにコンポーネント名ではなく目的を説明するリクエストにも当てはまります。説明された動作を、各スキルについてマップに記録された動作と照らし合わせてください。ユーザーの言葉にキーワードを当てはめる方法では、コンテキストを無駄にし、誤ったコンポーネントを選んでしまいます。セッションインベントリでリクエストを解決できない場合に限り、インベントリを再取得します。たとえば、その動作を扱う候補がない場合、実装が変わる形で候補が2つ同等の場合、またはマップに含まれていないコンポーネントをリクエストで指定された場合です。そのコンポーネントはセットアップ時の読込後に追加されたか、別のプラットフォームスラッグに属している可能性があります。

コンポーネントレジストリ

コンポーネントレジストリは、プラットフォームごとに整備された JSON テンプレートのインデックスです。各テンプレートには、ソース、正確なパッケージバージョン、ライセンスの適用方針を含む、完全かつ検証済みの実装がまとめられています。コンポーネントコードを記述する前に、必ずプラットフォームのレジストリインデックスを取得してください。最も近いテンプレートを出発点として使用します。要件がどのテンプレートにも記載されている内容の範囲外の場合に限りスキップし、その理由を明記してください。

現在、レジストリには Angular、React、Vue、aspnet-core、aspnet-mvc、Blazor、JavaScript、.NET MAUI、WinForms、WPF、WinUI のテンプレートが登録されています。それ以外のプラットフォームでは、スキルパックのみを作業に使用します。

エンドポイント

• プラットフォームごとのレジストリインデックス：https://ai.syncfusion.com/r/<platform-slug>/registry.json
• テンプレートごとのソース：https://ai.syncfusion.com/r/<platform-slug>/<variant>.json
• React の場合は言語セグメントを含めます：https://ai.syncfusion.com/r/react/<js|ts>/<variant>.json

レジストリを参照するタイミング

リクエストを満たすための通常の手順として、レジストリを扱います。次のいずれかに該当する場合は参照してください。

1. ユーザーが既知のバリアントを指定している場合 — たとえば、「グループ化機能付きの Grid を追加する」「積み上げ縦棒グラフを表示する」「注釈付きの PDF ビューアーを表示する」などです。バリアントが特定できるため、記憶を頼りに生成するよりも、該当するテンプレートを取得する方が正確です。
2. ユーザーのコンポーネントに関するリクエストが曖昧な場合 — たとえば、「チャートを追加する」「スケジューラーが必要です」「データグリッドを追加する」などです。意図に最も合う name または description を持つテンプレートを選び、プロジェクトに合わせて調整します。調整する前に、選んだテンプレートを明示してください。
3. リクエストが利用可能なテンプレートのいずれかに明確に当てはまる場合。 そのテンプレートを出発点として使用します。フレームワーク、言語、テーマ、パッケージのバージョンに合わせて調整し、プロジェクトの規約と異なる場合は、そのまま貼り付けないでください。

レジストリを参照しないタイミング

要件がどのテンプレートにも記載されていない場合（カスタム動作、アプリケーションレベルの構成、バリアントとして存在しないワークロード）は、レジストリを参照しないでください。その場合、レジストリは一切使用せず、プラットフォームのスキルパックに切り替えて、その理由を明示してください。

コードを書く前の手順

1. マニフェストから対象のプラットフォームを特定します（「プロジェクトコンテキストの確認」を参照）。
2. 関連するコンポーネントスキルを先にインストールします（「パス A — 公式エージェントスキル」を参照）。スキルパックでは統合とライセンスのルールを説明し、レジストリアイテムではそれらのルールを特定の実装に適用します。
3. セッションごとに一度、https://ai.syncfusion.com/r/<platform-slug>/registry.json を取得します。
4. 意図に合うテンプレートを選びます。複数のテンプレートが一致する場合は、behaviors がユーザーの明示したニーズに最もよく合うものを優先します。
5. https://ai.syncfusion.com/r/<platform-slug>/<variant>.json（または React の js|ts バリアント）を取得し、ソース全体、正確な依存関係のバージョン、パッケージ名、ライセンス条件を確認します。
6. ソースをプロジェクトに貼り付ける前に、レジストリ URL と一致したテンプレート名を示します。
7. テンプレートを調整します（フレームワーク、言語、テーマ、パッケージのバージョン、プロジェクトの規約）。
8. 検証チェックリストを実行します（「検証」を参照）。

プラットフォームインベントリとの関係

inventory.txt と registry.json は用途が異なります。相互に置き換えられるものとして扱わないでください。

• inventory.txt は ルーティング用の情報 です。プラットフォーム上のすべてのコンポーネントスキルについて、カテゴリ、パッケージ、動作を対応付けます。セットアップ中に一度読み込み、その後はセッション中のインベントリとして保持します。
• registry.json は既知のバリアントに対する 作業用の情報 です。ルーティングマップではなく、検証済みの完全な実装テンプレートを返します。

リクエストが目標（「PDF ファイルを表示する」「カレンダーに予定を表示する」）を示している場合は、インベントリから始めます。コンポーネントまたはバリアントが指定されている場合は、レジストリに直接進みます。

フォールバック

プラットフォームにレジストリがない場合、一致するテンプレートがない場合、または一致したテンプレートで要件を部分的にしか満たせない場合は、プラットフォームのスキルパックに切り替え、不足している点を明示してください。つまり、どのプラットフォームか、どのリクエストか、そしてレジストリを適用できなかった理由です。同じ動作をカバーするテンプレートが存在するのに、訓練時の記憶から黙って生成することは決して避けてください。

ナレッジの情報源

情報源は2つあります。実際に参照している情報源を選び、主張する際はそのことを明示してください。

• セッションインベントリ — inventory.txt およびインストール済みスキルの SKILL.md / references/*.md から保持されているルーティングマップです。コンポーネントのパッケージ、インポート、動作に関する主張にはこれを使用します。ファイルとセクションを引用してください。
• 学習済みメモリ — モデルに組み込まれたパターンです。引用できません。セッションインベントリの不足を補うために使用しないでください。代わりに、「まずルートを確認する」に記載された再取得の条件に従ってください。

プラットフォームのスラッグ：react angular javascript vue blazor aspnet-core aspnet-mvc flutter maui maui-toolkit winforms wpf winui document-sdk xamarin-to-maui-migration

マスターインデックス：https://ai.syncfusion.com/llms.txt

ネットワークにアクセスできない場合でも、このスキルとそのリファレンスがあれば作業を進められます。

プロジェクトのコンテキストを把握する

ユーザーに、リポジトリ内ですでに確認できる情報を尋ねる前に、リポジトリを調べてください。次の項目を特定します。

• フレームワーク、言語、ランタイム、パッケージマネージャー
• 既存の Syncfusion パッケージと正確なバージョン（Fresh Version Gate で使用します。マニフェストまたはロックファイルに記載されていないバージョンを指定しないでください）
• 要求されたコンポーネントまたは SDK と、実際に必要な機能
• 新規導入、編集、アップグレード、移行、トラブルシューティングのいずれに該当するか
• 既存のテーマと CSS の設定、アプリケーションのブートストラップ、テストおよびビルドのコマンド
• 既存のスキルディレクトリと MCP の設定
• ライセンス登録の証拠（キーを表示または漏洩させないこと）

マニフェストから判断できる情報：React、Angular、Vue、JavaScript では package.json、Blazor、 ASP.NET Core、ASP.NET MVC、MAUI、WPF、WinForms、WinUI では .csproj、Flutter では pubspec.yaml を使用します。

リポジトリからプラットフォームを特定できず、その選択によって実装が変わる場合は、短い質問を1つだけして作業を止めてください。

2つのスラッグがどちらも正しい場合があります。ブラウザーで PDF を表示し、.NET サーバーで署名する React アプリケーションには、pdf-viewer-sdk と document-sdk が必要です。UI フレームワークのスラッグが2つ必要になることはありません。

パスを選択する

必要な作業	パス
Syncfusion コードを生成または変更する	A — 公式エージェントスキル
現行 API、リリースでの変更、または高度な設定を確認する	B — 最新のドキュメント
ライセンス設定またはライセンス警告を解決する	C — ライセンス
プロジェクトを変更する前に Syncfusion を評価する	D — 調査のみ

一般的な実装では A を使用し、不確かな点は B を参照し、作業中は C に従い、最後に検証を行います。

パス A — 公式エージェントスキル

Syncfusion は、セットアップ、インポート、モジュールとサービス、プロパティ、イベント、テーマ設定、アクセシビリティに関するガイダンス、実装パターン、さらに重要な、公開ドキュメントに記載されていない失敗例を含む、コンポーネントに対応したスキルを公開しています。

1. 対応するスキルがエージェントのスキル保存場所にすでにインストールされているか確認します。
2. 見つからず、インストールがユーザーの依頼の範囲内であれば、保持されているインベントリーのルーティングマップから、動作に基づく上記の比較を使って、最も範囲の狭い公式パックまたはコンポーネントスキルを選びます。確認済みのリポジトリ名とコマンドについては、references/skill-packs.md を読みます。
3. ネットワークを使ったインストールの実行やプロジェクトレベルのエージェント設定の変更を行う前に、ホストの認可ルールに従います。
4. 実装する前に、選択したコンポーネントの SKILL.md を最後まで読みます。必要な機能に関連する補足リファレンスだけを読みます。
5. 記憶しているスニペットより、インストール済みのスキルに従います。Syncfusion パッケージのインストール、アップグレード、ダウングレード、移行、コード生成の変更を行う前に、毎回 Fresh Version Gate を実行します。references/version-resolution.md を参照してください。バージョンの照合ルールはパッケージマネージャーごとに異なります。npm はメジャーバージョンの一致、NuGet は正確なバージョン、Flutter は正確な制約を使用します。バージョンを記憶から選ばないでください。Fresh Version Gate に合格するまで、パッケージをインストールしたり Syncfusion コードを生成したりしないでください。ユーザーが明示的なアップグレード方針を選択していない限り、プロジェクトで使用中のバージョンに合わせます。

検出された Syncfusion の使用状況または現在のタスクに必要なコンポーネントスキルだけをインストールしてください。

プラットフォームが検出されたことや、将来の作業が見込まれることだけを理由に、プラットフォームのインベントリーにあるすべてのコンポーネントスキルをインストールしないでください。プロジェクト内にインストールすると、リポジトリに合わせた状態を保ち、チームで共有できます。

エージェントスキルをインストールしても、Syncfusion 製品のパッケージはインストールされません。コンポーネントスキルで実際のランタイム依存関係を確認し、それらは別途インストールしてください。

パス B — 最新のドキュメント

最新の API、最近リリースされた機能、特定のパッケージ、移行時の動作、トラブルシューティングの詳細に回答が依存する場合に使用します。

1. 利用可能であれば、設定済みの Syncfusion MCP サーバーとそのドキュメント検索ツールを使用します。
2. それ以外の場合は、対象のフレームワーク、コンポーネント、インストール済みバージョンを指定して、公式ドキュメントを検索します。
3. 公式デモとリポジトリはドキュメントを補うために使用してください。一般検索で見つかった、別のフレームワーク向けのスニペットは決して使用しないでください。

スキルはコード生成を支援し、MCP サーバーは最新のドキュメントを取得します。両者は相互に補完するものであり、MCP は任意です。API キーが必要ですが、匿名での利用も API キーなしで機能する必要があります。references/mcp-setup.md を参照してください。

最新のドキュメントで確認した詳細については、その旨を伝えてください。信頼できる情報を得られない場合は、API を捏造せず、確認できなかった内容を明記してください。

Path C — ライセンス

Syncfusion のエージェントスキルをインストールして読むのに、ライセンスは必要ありません。Syncfusion のコンポーネントライブラリやドキュメント SDK の使用には、該当する商用、Community、トライアル、またはその他の製品ライセンスが適用されます。

• ライセンスキーや MCP API キーを生成、推測、ログへの記録、出力、コミットしてはいけません。
• パッケージがビルドできる、またはスキルがインストールされているという理由で、プロジェクトがライセンスを取得していると主張してはいけません。
• プロジェクトで既に使用されているシークレット管理の方法を再利用してください。プラットフォームの公式な登録方法でアプリケーションレベルの登録が明示的に必要とされる場合を除き、シークレットをソース管理やクライアントから見える出力に含めないでください。
• 正確なフレームワークとインストール済みバージョンに対応するライセンスページを使用してください。仕組みはプラットフォームやリリースによって異なります。
• ライセンスのバナーや警告を抑制、非表示、または CSS で隠してはいけません。
• キーやアカウント操作が必要な場合は、人間が何を取得または承認する必要があるかを説明し、そこで作業を止めてください。
• ライセンス条項を権威あるものとして扱ってください。確認せずに、トライアルまたは Community ライセンスから本番環境での使用権を推測してはいけません。

MCP API キーは、ドキュメントアシスタント用の認証情報です。製品ライセンスキーではありません。 詳細なルール：references/licensing.md

Path D — 調査のみ

ユーザーが Syncfusion を評価している場合は、何もインストールしないでください。パッケージ、スキル、MCP 設定はいずれも対象外です。対象のフレームワークとワークロードを特定してから、関連する公式製品、ドキュメント、デモ、デプロイモデル、ライセンス要件を比較してください。確認済みの事実と推奨事項は区別してください。

実装

1. プロジェクトのフレームワークのバージョン、アーキテクチャ、フォーマット、依存関係の規約を維持します。
2. 選択したコンポーネントと機能に必要なパッケージのみをインストールします。
3. コンポーネントスキルに記載された、必要なすべてのインポート、モジュールまたはサービスの注入、プロバイダー、ハンドラー、タグヘルパー登録、テーマスタイルシート、ランタイムアセット、サーバー依存関係を含めます。
4. 現実的な型付きデータを使い、リクエストされた動作を示す、最小限のエンドツーエンドの実装を行います。
5. ファイル全体を出力します。省略記号、「残りのコードはそのまま」などの記述や、主な出力として不完全な差分を提示してはいけません。
6. 該当する場合は、読み込み中、空、エラー、主要な操作の各状態を検証します。
7. コンポーネントに関するすべての主張の出典として、セッションのインベントリまたはインストール済みの SKILL.md を示します。出典を示せない内容は記述しないでください。

検証

コンパイルできたことだけを根拠に成功を報告してはいけません。チェックリスト全体は references/verification.md にあります。

最低限、コンポーネントがレンダリングまたは実行されること、リクエストされた機能の動作を確認できること、ライセンス警告が表示されないこと、ランタイムログにモジュールやアセットの不足に関するエラーがないこと、差分にキーが含まれていないことを確認してください。環境でランタイム検証ができない場合は、未検証の項目を正確に伝え、簡潔な手動確認方法をユーザーに提示してください。

次の順序でトラブルシューティング

1. フレームワークと Syncfusion パッケージのバージョン互換性
2. パッケージ、ピア依存関係、モジュール、サービス、プロバイダー、ハンドラー、インポートの不足
3. テーマ CSS、フォント、スクリプト、静的アセット、または必要なサーバー側エンドポイント
4. データの形状、識別子、日付と数値の解析、非同期ライフサイクル
5. インストール済みのコンポーネントスキルに記載された、機能固有の設定
6. 現在の公式ドキュメント、または MCP による検索
7. 無関係なアプリケーションコードを削除した最小限の再現例

元のエラーテキストを保持してください。製品の不具合と、統合または設定の問題を区別してください。最小限の再現例でもドキュメントに記載された動作に反して失敗する場合は、Syncfusion Support を利用してください： https://support.syncfusion.com/

提案する修正にはすべて、「実装」と上記の「厳守事項」に従って出典を示してください。

参照資料

| 参照資料 | 使用する場面 | | --- | --- |. 必須です。一致ルールはパッケージマネージャーによって異なります（npm = メジャーバージョンの一致、NuGet = 完全一致のバージョン、Flutter = 制約の完全一致）。 | references/skill-packs.md | パックを選択またはインストールする場合。検証済みのリポジトリ名が必要な場合 | | references/mcp-setup.md | MCP サーバーを設定する場合、または MCP サーバーが必要かどうかを判断する場合 | | references/licensing.md | キー、シークレット、CI、またはアカウントに関する質問 | | references/version-resolution.md | Syncfusion パッケージのインストール、アップグレード、ダウングレード、またはコード生成の前に使用します。一致ルールはパッケージマネージャーによって異なります | | references/verification.md | 実装が動作することを報告する前に使用します |