注意:此项目没有可用的旧版文档,因此您看到的是当前文档。
PushEngage Agent Skills 是一个插件,用于教 AI 编码代理如何在您的移动应用中集成和调试 PushEngage SDK。1.0.0 版本是第一个发布版本,这些技能遵循两个开放标准: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 服务器,因此您的代理还可以操作您的账户,例如发送和安排通知、构建细分受众以及读取分析数据。
该插件附带六个协同工作的技能。
| 技能 | 目的 |
|---|---|
pushengage | 入口技能。检测您的平台并路由到正确的技能。 |
pushengage-ios | iOS 集成和调试。 |
pushengage-android | Android 集成和调试。 |
pushengage-flutter | Flutter 集成和调试。 |
pushengage-react-native | React Native 集成和调试。 |
pushengage-debug | 用于有问题的集成的共享诊断技能。 |
技能工作原理
每个技能会根据检测到的项目自动激活。入口技能会识别您的平台并将其移交给匹配的集成技能。当出现问题时,诊断技能会分三个阶段运行:首先是对您的设置进行静态审核,然后与您 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 集成到此应用中。” 这将运行完整的集成流程。
- “我的 iPhone 收不到 PushEngage 通知。” 这将运行诊断流程。
- “审核我的 PushEngage 设置。” 这将运行静态审核。
该插件会自动检测您的平台,并将其移交给匹配的集成或调试技能。连接 MCP 服务器后,您还可以操作您的帐户,例如,“发送一个标题为‘促销今晚结束’的通知到我的美国细分市场”或“上周的活动表现如何?”
如果您希望自己遵循集成步骤,请参阅 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 的集成和调试流程。入口技能会自动检测您的平台并移交给匹配的技能。
我需要为帐户工具设置任何东西吗?
您需要 Node.js 18 或更高版本,因为捆绑的 MCP 服务器通过 npx 运行。您的代理首次使用帐户工具时,会打开一个浏览器窗口让您登录 PushEngage。在此之前,帐户工具将保持空闲状态,集成和调试技能仍然可用。
诊断技能检查什么?
它会运行您的集成的静态审核,将您的 SDK 版本与版本固定的已知问题列表进行匹配,并遍历症状决策树。如果找不到原因,它会为 PushEngage 团队准备一个支持包。
免费使用吗?
该插件在 MIT 许可下发布。您仍需要一个已配置应用程序的 PushEngage 帐户才能使用它。
资源
- GitHub 上的 PushEngage Agent Skills:awesomemotive/pushengage-skills
- GitHub 上的 PushEngage MCP 服务器:awesomemotive/pushengage-mcp
- npm 上的 MCP 服务器软件包:
@pushengage/mcp
如果您遇到任何问题,请随时通过单击此处联系我们。我们的支持团队将能够帮助您。