通知:この項目にはレガシー ドキュメントがありません。そのため、現在のドキュメントが表示されています。
PushEngage Agent Skillsは、AIコーディングエージェントにモバイルアプリでのPushEngage SDKの統合とデバッグ方法を教えるプラグインです。バージョン1.0.0は最初のリリースであり、スキルは2つのオープンスタンダード、Agent Skills (SKILL.md) 標準とAgent Plugins形式に従っているため、Claude Code、Cowork、Cursor、Codex、Copilot、Windsurf、VS Codeなど、いずれかをサポートする任意のエージェントで動作します。このガイドでは、その内容とインストール方法について説明します。
開始する前に
- ダッシュボードで設定されたアプリを持つPushEngageアカウントが必要です。
- Agent SkillsまたはAgent PluginsをサポートするAIコーディングエージェントが必要です。Claude Codeを推奨します。
- アカウントツールの場合、プラグインはNode.js 18以降を使用して、
npx経由でバンドルされたMCPサーバーを実行します。
PushEngage Agent Skillsの機能
このプラグインは、エージェントにPushEngage SDKのステップバイステップの知識を提供するため、ドキュメントを探し回ることなく、プッシュ通知を設定およびトラブルシューティングできます。
- iOS、Android、Flutter、React Native向けの完全なSDK統合フロー。
- 診断スキル。これは、壊れた統合を監査し、SDKバージョンを知られている問題のバージョン固定テーブルと比較し、監査で問題が見つからない場合に症状に基づいた意思決定ツリーを案内します。
- プラグイン内にバンドルされたPushEngage MCPサーバー。これにより、エージェントは通知の送信とスケジュール設定、セグメントの構築、分析の読み取りなどのアカウント操作も実行できます。
このプラグインには、連携して機能する6つのスキルが含まれています。
| スキル | 目的 |
|---|---|
エンゲージメントをプッシュ | エントリースキル。プラットフォームを検出し、適切なスキルにルーティングします。 |
pushengage-ios | iOSの統合とデバッグ。 |
pushengage-android | Androidの統合とデバッグ。 |
pushengage-flutter | Flutterの統合とデバッグ。 |
pushengage-react-native | React Nativeの統合とデバッグ。 |
pushengage-debug | 壊れた統合のための共有診断スキル。 |
スキルの仕組み
各スキルは、検出されたプロジェクトに基づいて自動的にアクティブ化されます。エントリースキルがプラットフォームを識別し、一致する統合スキルに引き継ぎます。問題が発生した場合、診断スキルは3つのステージで実行されます。まずセットアップの静的監査、次にSDKバージョンに対する既知の問題との照合、最後に症状に基づいた意思決定ツリーです。それでも問題を解決できない場合は、PushEngageチームに送信できるサポートバンドルをパッケージ化します。
Claude CodeまたはCoworkにインストールする
プラグインマーケットプレイスを追加し、プラグインをインストールします。
/plugin marketplace add awesomemotive/pushengage-skills
/plugin install pushengage
プラグインをインストールすると、公式のPushEngage MCPサーバー(@pushengage/mcp)も構成されます。エージェントがアカウントツールを初めて使用するときに、ブラウザウィンドウが開いてPushEngageアカウントにログインします。ログインするまで、アカウントツールはアイドル状態のままです。
他のエージェントにインストール
Cursor、Codex、Copilot、Windsurf、およびその他のSKILL.md互換エージェントには、skills CLIを使用してください。
npx skills add awesomemotive/pushengage-skills
エージェントプラグインクライアントにインストール
このリポジトリは、plugin.jsonマニフェスト、skills/ディレクトリ、およびmcp.jsonを備えたオープンエージェントプラグイン形式にも準拠しています。エージェントプラグインをサポートするクライアントであれば、プラグインとして読み込むことができます。現在互換性のあるクライアントには、VS Code、Cursor、GitHub Copilot、ChatGPTおよびCodex、Kiro、Hermes Agent、OpenClaw、Grok Bot、NanoClawが含まれます。クライアント固有のプラグインインストールメカニズムを使用して、awesomemotive/pushengage-skillsリポジトリを指定してください。プラグインのmcp.jsonをサポートするクライアントは、公式MCPサーバーも自動的に構成されます。
手動でインストール
スキルはawesomemotive/pushengage-skillsリポジトリのskills/ディレクトリの下にあります。スキルフォルダをエージェントのスキルディレクトリにコピーするか、エージェントにリポジトリを指定してください。各スキルは、検出したプロジェクトタイプに基づいて自動的にアクティブ化されます。
スキルの使用
インストール後、エージェントに平易な言葉で話しかけてください。例:
- 「このアプリにPushEngageを統合するのを手伝って。」これは完全な統合フローを実行します。
- 「PushEngageの通知がiPhoneに届きません。」これは診断フローを実行します。
- 「PushEngageの設定を監査してください。」これは静的監査を実行します。
プラグインはプラットフォームを自動的に検出し、一致する統合またはデバッグスキルに引き継ぎます。MCPサーバーが接続されていると、「USセグメントに「本日終了のセール」というタイトルの通知を送信」や「先週のキャンペーンのパフォーマンスはどうでしたか?」のようにアカウントを操作することもできます。
統合手順を自分で実行したい場合は、PushEngage Mobile SDKドキュメントを参照してください。
よくある質問
どのエージェントで動作しますか?
このスキルは、Agent Skills (SKILL.md) 標準とAgent Plugins形式の両方に準拠しているため、Claude Code、Cowork、Cursor、Codex、Copilot、Windsurf、VS Codeなど、いずれかをサポートするエージェントで動作します。Claude CodeとCoworkはプラグインとしてインストールし、その他のSKILL.mdエージェントはskills CLI経由で追加し、Agent Pluginsクライアントは独自のプラグインインストールメカニズム経由で読み込みます。
どのプラットフォームがサポートされていますか?
このプラグインには、iOS、Android、Flutter、React Nativeの統合およびデバッグフローが含まれています。エントリースキルはプラットフォームを自動的に検出し、一致するスキルに引き継ぎます。
アカウントツール用に何か設定する必要がありますか?
バンドルされているMCPサーバーはnpxで実行されるため、Node.js 18以降が必要です。エージェントがアカウントツールを初めて使用するときに、PushEngageにログインするためのブラウザウィンドウが開きます。それまでは、アカウントツールはアイドル状態のままで、統合およびデバッグスキルは引き続き機能します。
診断スキルは何をチェックしますか?
統合の静的監査を実行し、SDKバージョンを既知の問題リストに対してバージョン固定で照合し、症状の決定木をたどります。原因が見つからない場合は、PushEngageチーム用のサポートバンドルを準備します。
無料で利用できますか?
プラグインはMITライセンスの下でリリースされています。これを使用するには、アプリが設定されたPushEngageアカウントが必要です。
リソース
- GitHubのPushEngage Agent Skills: awesomemotive/pushengage-skills
- GitHubのPushEngage MCPサーバー: awesomemotive/pushengage-mcp
- npmのMCPサーバーパッケージ:
@pushengage/mcp
問題が発生した場合は、ここをクリックしてお気軽にお問い合わせください。サポートチームがお手伝いします。