[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75ZEY00S7NS0FPCAYQ3VCV2":3,"skill-same:01M75ZEY00S7NS0FPCAYQ3VCV2":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M75ZEY00S7NS0FPCAYQ3VCV2","hmos-push-kit",null,"华为Push Kit推送服务集成助手（Master Skill\u002F大路由）。帮助开发者快速集成HarmonyOS推送功能，获取Push Token，\n配置推送服务，开通场景化消息权益。支持发送通知消息、应用内通话消息、后台消息等场景。\n\n============================================================\n触发条件（只有满足以下意图时才触发）：\n============================================================\n\n✅ 正确触发场景（开发者需要接入\u002F开发推送功能）：\n- \"帮我在项目中接入华为推送\"\n- \"我要实现推送通知功能\"\n- \"如何接入push kit\"\n- \"帮我接入voip消息\"\n- \"接入后台消息\"\n- \"发送推送通知\"\n- \"获取push token\"\n- \"配置推送服务\"\n- \"开通推送消息权益\"\n\n❌ 不触发场景（仅为询问、比较、测试、排查等）：\n- 询问对比\u002F优缺点：\"鸿蒙push和苹果push区别\"、\"推送有什么优点\"\n- 否定意图：\"我不想接入推送\"、\"不需要推送\"\n- 仅输入关键词：\"推送\"、\"消息\"、\"后台\"\n- 测试\u002F调试：\"push通知测试\"、\"push调试\"\n- 问题排查：\"push失败\"、\"推送异常\"\n- 配置咨询：\"token怎么配置\"\n- 带引号输入：\"push通知\"、\"推送消息\"\n\n路由规则：\n- 若开发者需要单独获取Push Token → 路由到 hmos-push-kit-token\n- 若开发者需要发送通知消息 → 路由到 hmos-push-kit-notification（先检查Token状态）\n- 若开发者需要实现voip\u002F应用内通话 → 路由到 hmos-push-kit-voip（先检查Token状态）\n- 若开发者需要接入后台消息 → 路由到 hmos-push-kit-background（先检查Token状态）\n- 若开发者请求模糊（未明确场景）→ 必须先询问具体场景，再路由到对应子Skill\n\n⚠️ 重要：主Skill不生成任何场景化消息的具体代码！当开发者请求模糊时，必须先询问具体场景，再路由到对应子Skill生成完整代码。\n\n此技能能够为开发者生成可直接编译通过的ArkTS代码，没有语法错误。","IsKenKenYa\u002Fskills","IsKenKenYa","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F92219680?v=4","01M75Z8AFJBVH1Y9JJWRT35P0Z","是小啃啃呀","01M75Z8AG6RVC5RF6KTJQ7PQKQ",3,"GPL-3.0","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fdevelopment\u002Fpush-kit\u002Fhmos-push-kit\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: hmos-push-kit\ndescription: |\n  华为Push Kit推送服务集成助手（Master Skill\u002F大路由）。帮助开发者快速集成HarmonyOS推送功能，获取Push Token，\n  配置推送服务，开通场景化消息权益。支持发送通知消息、应用内通话消息、后台消息等场景。\n  \n  ============================================================\n  触发条件（只有满足以下意图时才触发）：\n  ============================================================\n  \n  ✅ 正确触发场景（开发者需要接入\u002F开发推送功能）：\n  - \"帮我在项目中接入华为推送\"\n  - \"我要实现推送通知功能\"\n  - \"如何接入push kit\"\n  - \"帮我接入voip消息\"\n  - \"接入后台消息\"\n  - \"发送推送通知\"\n  - \"获取push token\"\n  - \"配置推送服务\"\n  - \"开通推送消息权益\"\n  \n  ❌ 不触发场景（仅为询问、比较、测试、排查等）：\n  - 询问对比\u002F优缺点：\"鸿蒙push和苹果push区别\"、\"推送有什么优点\"\n  - 否定意图：\"我不想接入推送\"、\"不需要推送\"\n  - 仅输入关键词：\"推送\"、\"消息\"、\"后台\"\n  - 测试\u002F调试：\"push通知测试\"、\"push调试\"\n  - 问题排查：\"push失败\"、\"推送异常\"\n  - 配置咨询：\"token怎么配置\"\n  - 带引号输入：\"push通知\"、\"推送消息\"\n  \n  路由规则：\n  - 若开发者需要单独获取Push Token → 路由到 hmos-push-kit-token\n  - 若开发者需要发送通知消息 → 路由到 hmos-push-kit-notification（先检查Token状态）\n  - 若开发者需要实现voip\u002F应用内通话 → 路由到 hmos-push-kit-voip（先检查Token状态）\n  - 若开发者需要接入后台消息 → 路由到 hmos-push-kit-background（先检查Token状态）\n  - 若开发者请求模糊（未明确场景）→ 必须先询问具体场景，再路由到对应子Skill\n  \n  ⚠️ 重要：主Skill不生成任何场景化消息的具体代码！当开发者请求模糊时，必须先询问具体场景，再路由到对应子Skill生成完整代码。\n  \n  此技能能够为开发者生成可直接编译通过的ArkTS代码，没有语法错误。\n---\n\n# Push Kit Master（推送服务主 Skill）\n\n这是 Push Kit 推送服务的 Master Skill，负责根据开发者需求智能路由到具体的子 Skill 实现。\n\n## Skill 架构\n\n```\npush-kit-helper (Master Skill - 大路由)\n├── hmos-push-kit-token (获取Push Token - 核心基础能力)\n│   ├── 判断项目中是否存在getToken代码\n│   ├── 引导开发者开发push token获取功能\n│   ├── 向开发者说明token的意义和价值\n│   └── 可作为单独接入能力使用\n├── hmos-push-kit-notification (发送通知消息)\n│   ├── 先检查是否已接入Token（如未接入，引导先接入Token）\n│   ├── 发送基础通知消息\n│   ├── 配置通知消息样式\n│   ├── 配置点击消息动作\n│   └── 数据传递与接收\n├── hmos-push-kit-voip (推送应用内通话消息\u002Fvoip)\n│   ├── 先检查是否已接入Token（如未接入，引导先接入Token）\n│   ├── 语音\u002F视频来电通知\n│   ├── 呼叫接听界面配置\n│   ├── 应用在前台处理消息\n│   └── 申请voip权益\n└── hmos-push-kit-background (推送后台消息)\n    ├── 先检查是否已接入Token（如未接入，引导先接入Token）\n    ├── 创建 PushMessageAbility 接收消息\n    ├── 配置 skills 标签\n    ├── 应用在前台处理消息\n    └── （可选）配置 proxyData 数据库存储\n```\n\n## 核心路由逻辑\n\n### 路由职责划分\n\n**主Skill职责**：仅做智能路由，根据开发者需求加载对应子Skill。\n**子Skill职责**：各自处理Token检查、具体代码生成、配置指导。\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│                    Master Skill 路由逻辑                             │\n├─────────────────────────────────────────────────────────────────────┤\n│  开发者请求                                                            │\n│     │                                                              │\n│     ▼                                                              │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │ 解析开发者需求 → 确定需要哪些场景化消息 Skill                   │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n│                              │                                      │\n│                              ▼                                      │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │ 按需加载子Skill（可加载多个，按顺序执行）                        │  │\n│  │                                                              │  │\n│  │  - 通知消息场景 → hmos-push-kit-notification                  │  │\n│  │  - 后台消息场景 → hmos-push-kit-background                    │  │\n│  │  - VoIP消息场景 → hmos-push-kit-voip                          │  │\n│  │  - Token获取   → hmos-push-kit-token                          │  │\n│  │                                                              │  │\n│  │  每个子Skill自行处理Token状态检查                              │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n└─────────────────────────────────────────────────────────────────────┘\n```\n\n### 当开发者需求模糊时的处理逻辑\n\n**⚠️ 关键规则：主Skill不生成任何场景化消息的具体代码！**\n\n当开发者请求模糊时（如\"帮接入华为推送服务\"而未明确具体场景），**必须按以下流程处理**：\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│                    模糊需求处理流程                                   │\n├─────────────────────────────────────────────────────────────────────┤\n│                                                                      │\n│  开发者请求模糊（如\"帮接入华为推送\"）                                    │\n│           │                                                          │\n│           ▼                                                          │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │  主动询问开发者具体场景                                        │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n│           │                                                          │\n│           ▼                                                          │\n│  等待开发者回复（如\"后台消息+通知消息\"或\"全部都要\"等）                    │\n│           │                                                          │\n│           ▼                                                          │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │  理解开发者需求，路由到对应子Skill组合                           │  │\n│  │                                                              │  │\n│  │  支持任意组合：                                               │  │\n│  │  - \"只要通知消息\" → notification                                  │  │\n│  │  - \"只要后台消息\" → background                                    │  │\n│  │  - \"通知消息+后台消息\" → notification + background                    │  │\n│  │  - \"全部\" → token + notification + background + voip          │  │\n│  │  - \"通知消息和应用内通话\" → notification + voip                         │  │\n│  │  - ...任意合理组合                                             │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n│                                                                      │\n└─────────────────────────────────────────────────────────────────────┘\n```\n\n**询问示例**：\n\n当开发者说\"帮我在项目中接入华为推送服务\"或类似模糊请求时，AI应该这样回应：\n\n> \"好的，我来帮您接入华为Push Kit推送服务。在开始之前，请告诉我您需要接入哪些推送场景？\n> \n> Push Kit 支持三种场景化消息：\n> - **通知消息**：发送消息提醒、弹窗通知，用户点击可打开应用\n> - **后台消息**：数据静默更新，应用在后台接收消息后处理\n> - **VoIP消息**：语音\u002F视频来电提醒，需要申请VoIP权益\n> \n> 请告诉我您需要哪些场景？例如：\n> - \"只要通知消息\"\n> - \"通知+后台\"\n> - \"全部都要\"\n> - 或者直接描述您的业务需求，我来帮您判断\"\n\n**路由规则**：\n\n| 开发者需求 | 路由目标（按顺序加载） |\n|-----------|----------------------|\n| 通知 | notification |\n| 后台 | background |\n| VoIP\u002F通话\u002F来电 | voip |\n| 通知+后台 | notification → background |\n| 通知+VoIP | notification → voip |\n| 后台+VoIP | background → voip |\n| 全部\u002F都要 | token → notification → background → voip |\n\n**禁止行为**：\n- ❌ 主Skill直接生成通知\u002F后台\u002FVoIP的具体实现代码\n- ❌ 不询问开发者场景就直接生成部分代码\n- ❌ 用主Skill中已有的描述片段代替子Skill的完整代码\n\n## 核心设计理念\n\n### Push Token 的核心地位\n\n**所有推送服务的基础都是获取 Push Token**。无论选择哪种场景化消息（通知、通话、语音），都需要首先完成 Push Token 的获取。\n\n**本 Skill 的设计原则**：\n1. 每个场景化消息 Skill 都需要先检查开发者是否已正确获取 Push Token\n2. 如果没有 Token 或不确定，需要引导开发者先完成 `hmos-push-kit-token` 场景\n3. 这确保了开发者的推送集成工作从一开始就建立在正确的基础上\n\n\n### 场景化消息流程\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│                         Master Skill (路由索引)                     │\n├─────────────────────────────────────────────────────────────────────┤\n│  开发者问询                                                         │\n│     │                                                              │\n│     ▼                                                              │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │ 1. 解析开发者需求 → 确定需要哪些场景化消息 Skill               │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n│                              │                                      │\n│                              ▼                                      │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │ 2. 按需加载一个或多个子 Skill                                 │  │\n│  │    （每个子Skill自行处理Token检查和具体代码生成）              │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n│                              │                                      │\n│                              ▼                                      │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │ 3. 子Skill依次执行，完成对应场景的开发                         │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n└─────────────────────────────────────────────────────────────────────┘\n```\n\n## 快速导航\n\n根据您的需求，选择相应的场景：\n\n### 我想获取 Push Token\n- **触发条件**：开发者首次集成推送、Token 获取失败、询问 Token 相关问题\n- **跳转到**：`hmos-push-kit-token` Skill\n\n### 我想发送通知消息\n- **触发条件**：开发者要实现消息推送、通知功能、消息提醒\n- **跳转到**：`hmos-push-kit-notification` Skill\n\n### 我想发送应用内通话\u002Fvoip消息\n- **触发条件**：开发者要实现 voip、来电提醒、视频通话功能\n- **跳转到**：`hmos-push-kit-voip` Skill\n\n### 我想发送后台消息\n- **触发条件**：开发者要实现数据静默更新、离线缓存功能\n- **跳转到**：`hmos-push-kit-background` Skill\n\n### 我需要接入多个场景\n- **触发条件**：开发者说\"帮接入推送\"、\"接入华为推送服务\"等未明确场景\n- **处理方式**：主动询问具体场景 → 根据回答路由到对应子Skill组合\n- **重要**：主Skill不生成具体代码，必须路由到子Skill\n\n\n\n## 场景化消息权益说明\n\nPush Kit 支持多种场景化消息权益，部分需要申请才能使用：\n\n| 权益名称 | 说明 | 每日推送限制 | 提醒方式 |\n|---------|------|------------|---------|\n| 即时聊天（IM） | 社交通讯类消息 | 无限制 | 锁屏+铃声+振动 |\n| 音视频通话（voip） | 来电通知 | 无限制 | 锁屏+铃声+振动 |\n| 出行提醒（TRAVEL） | 出行相关通知 | 无限制 | 锁屏+铃声+振动 |\n| 健康数据（HEALTH） | 健康运动通知 | 无限制 | 锁屏+铃声+振动 |\n| 工作事项（WORK） | 工作任务提醒 | 无限制 | 锁屏+铃声+振动 |\n| 资讯营销（默认） | 活动和内容推荐 | 2-5条\u002F设备\u002F日 | 静默通知 |\n\n> **重要提示**：未申请自分类权益的应用，默认推送的都是资讯营销类消息，会受到\"每日每设备 2-5 条\"的严格限制！\n\n## 开发流程总览\n\n### Step 1: 开通推送服务（必须）\n\n推送服务需要在 AppGallery Connect 中开通才能使用。这是获取有效 Push Token 的前提。\n\n**操作路径**：AppGallery Connect → 项目 → 应用 → 增长 → 推送服务 → 立即开通\n\n### Step 2: 配置应用签名（必须）\n\n签名配置决定应用能否正常获取 Push Token：\n- **调试阶段**：使用调试证书 + 调试 Profile\n- **发布阶段**：使用发布证书 + 发布 Profile\n- **自动签名**：DevEco Studio 6.0.0+ 支持自动配置\n\n### Step 3: 获取 Push Token（必须）\n\n所有推送的起点，在应用启动时调用 `getToken()`。\n\n### Step 4: 申请场景化消息权益（推荐）\n\n申请对应类型的自分类权益，可以突破每日推送数量限制。\n\n### Step 5: 开发具体功能\n\n根据业务需求，选择对应的场景化消息类型进行开发。\n\n## 常见问题快速排查\n\n| 问题现象 | 可能原因 | 解决方案 |\n|---------|---------|---------|\n| `getToken()` 返回错误码 1000900010 | 推送服务未开通或签名问题 | 检查推送服务是否开通，重新申请 Profile |\n| 收不到推送消息 | Token 过期或签名问题 | 重新获取 Token，检查签名配置 |\n| Token 一直获取失败 | 调试设备未注册 | 注册调试设备 |\n| 每日推送数量受限 | 未申请自分类权益 | 申请通知消息自分类权益 |\n| 推送数量被频控 | 测试阶段未使用 testMessage 参数 | 设置 testMessage 为 true 进行测试 |\n\n## 参考文档\n\n详细配置说明请参考华为官方文档：\n\n### 官方文档链接\n\n| 文档 | 链接 |\n|------|------|\n| Push Kit 简介 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-kit-introduction |\n| 使用入门 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-gettingstart |\n| 开发准备 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-preparations |\n| 获取Push Token | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-get-token |\n| 推送场景化消息 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-scenes |\n| 发送通知消息 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-send-alert |\n| 推送应用内通话消息(voip) | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fhmos-push-kit-voip |\n| 端云调试 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-server |\n| 申请推送场景化消息权益 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-apply-right |\n\n### 本地参考文档\n\n- `references\u002Fpush-error-codes.md` - Push Kit 错误码速查（快速定位问题）\n- `references\u002Fpush-guide.md` - 推送服务配置完整指南\n- `references\u002Fpush-api.md` - Push Kit API 参考\n- `references\u002Fpush-templates.md` - 完整源代码模板\n\n## 代码生成规则\n\n生成代码时必须遵循：\n1. 使用正确的导入路径：`@kit.PushKit`、`@kit.BasicServicesKit` 等\n2. 所有 ArkTS 类型注解必须正确\n3. 使用 Promise 处理异步操作\n4. 添加适当的错误处理\n5. 使用 `hilog` 模块记录日志\n6. 生成的代码必须能够直接编译通过\n7. 遵守 HarmonyOS 应用开发规范","# Push Kit Master（推送服务主 Skill）\n\n这是 Push Kit 推送服务的 Master Skill，负责根据开发者需求智能路由到具体的子 Skill 实现。\n\n## Skill 架构\n\n```\npush-kit-helper (Master Skill - 大路由)\n├── hmos-push-kit-token (获取Push Token - 核心基础能力)\n│   ├── 判断项目中是否存在getToken代码\n│   ├── 引导开发者开发push token获取功能\n│   ├── 向开发者说明token的意义和价值\n│   └── 可作为单独接入能力使用\n├── hmos-push-kit-notification (发送通知消息)\n│   ├── 先检查是否已接入Token（如未接入，引导先接入Token）\n│   ├── 发送基础通知消息\n│   ├── 配置通知消息样式\n│   ├── 配置点击消息动作\n│   └── 数据传递与接收\n├── hmos-push-kit-voip (推送应用内通话消息\u002Fvoip)\n│   ├── 先检查是否已接入Token（如未接入，引导先接入Token）\n│   ├── 语音\u002F视频来电通知\n│   ├── 呼叫接听界面配置\n│   ├── 应用在前台处理消息\n│   └── 申请voip权益\n└── hmos-push-kit-background (推送后台消息)\n    ├── 先检查是否已接入Token（如未接入，引导先接入Token）\n    ├── 创建 PushMessageAbility 接收消息\n    ├── 配置 skills 标签\n    ├── 应用在前台处理消息\n    └── （可选）配置 proxyData 数据库存储\n```\n\n## 核心路由逻辑\n\n### 路由职责划分\n\n**主Skill职责**：仅做智能路由，根据开发者需求加载对应子Skill。\n**子Skill职责**：各自处理Token检查、具体代码生成、配置指导。\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│                    Master Skill 路由逻辑                             │\n├─────────────────────────────────────────────────────────────────────┤\n│  开发者请求                                                            │\n│     │                                                              │\n│     ▼                                                              │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │ 解析开发者需求 → 确定需要哪些场景化消息 Skill                   │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n│                              │                                      │\n│                              ▼                                      │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │ 按需加载子Skill（可加载多个，按顺序执行）                        │  │\n│  │                                                              │  │\n│  │  - 通知消息场景 → hmos-push-kit-notification                  │  │\n│  │  - 后台消息场景 → hmos-push-kit-background                    │  │\n│  │  - VoIP消息场景 → hmos-push-kit-voip                          │  │\n│  │  - Token获取   → hmos-push-kit-token                          │  │\n│  │                                                              │  │\n│  │  每个子Skill自行处理Token状态检查                              │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n└─────────────────────────────────────────────────────────────────────┘\n```\n\n### 当开发者需求模糊时的处理逻辑\n\n**⚠️ 关键规则：主Skill不生成任何场景化消息的具体代码！**\n\n当开发者请求模糊时（如\"帮接入华为推送服务\"而未明确具体场景），**必须按以下流程处理**：\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│                    模糊需求处理流程                                   │\n├─────────────────────────────────────────────────────────────────────┤\n│                                                                      │\n│  开发者请求模糊（如\"帮接入华为推送\"）                                    │\n│           │                                                          │\n│           ▼                                                          │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │  主动询问开发者具体场景                                        │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n│           │                                                          │\n│           ▼                                                          │\n│  等待开发者回复（如\"后台消息+通知消息\"或\"全部都要\"等）                    │\n│           │                                                          │\n│           ▼                                                          │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │  理解开发者需求，路由到对应子Skill组合                           │  │\n│  │                                                              │  │\n│  │  支持任意组合：                                               │  │\n│  │  - \"只要通知消息\" → notification                                  │  │\n│  │  - \"只要后台消息\" → background                                    │  │\n│  │  - \"通知消息+后台消息\" → notification + background                    │  │\n│  │  - \"全部\" → token + notification + background + voip          │  │\n│  │  - \"通知消息和应用内通话\" → notification + voip                         │  │\n│  │  - ...任意合理组合                                             │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n│                                                                      │\n└─────────────────────────────────────────────────────────────────────┘\n```\n\n**询问示例**：\n\n当开发者说\"帮我在项目中接入华为推送服务\"或类似模糊请求时，AI应该这样回应：\n\n> \"好的，我来帮您接入华为Push Kit推送服务。在开始之前，请告诉我您需要接入哪些推送场景？\n> \n> Push Kit 支持三种场景化消息：\n> - **通知消息**：发送消息提醒、弹窗通知，用户点击可打开应用\n> - **后台消息**：数据静默更新，应用在后台接收消息后处理\n> - **VoIP消息**：语音\u002F视频来电提醒，需要申请VoIP权益\n> \n> 请告诉我您需要哪些场景？例如：\n> - \"只要通知消息\"\n> - \"通知+后台\"\n> - \"全部都要\"\n> - 或者直接描述您的业务需求，我来帮您判断\"\n\n**路由规则**：\n\n| 开发者需求 | 路由目标（按顺序加载） |\n|-----------|----------------------|\n| 通知 | notification |\n| 后台 | background |\n| VoIP\u002F通话\u002F来电 | voip |\n| 通知+后台 | notification → background |\n| 通知+VoIP | notification → voip |\n| 后台+VoIP | background → voip |\n| 全部\u002F都要 | token → notification → background → voip |\n\n**禁止行为**：\n- ❌ 主Skill直接生成通知\u002F后台\u002FVoIP的具体实现代码\n- ❌ 不询问开发者场景就直接生成部分代码\n- ❌ 用主Skill中已有的描述片段代替子Skill的完整代码\n\n## 核心设计理念\n\n### Push Token 的核心地位\n\n**所有推送服务的基础都是获取 Push Token**。无论选择哪种场景化消息（通知、通话、语音），都需要首先完成 Push Token 的获取。\n\n**本 Skill 的设计原则**：\n1. 每个场景化消息 Skill 都需要先检查开发者是否已正确获取 Push Token\n2. 如果没有 Token 或不确定，需要引导开发者先完成 `hmos-push-kit-token` 场景\n3. 这确保了开发者的推送集成工作从一开始就建立在正确的基础上\n\n\n### 场景化消息流程\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│                         Master Skill (路由索引)                     │\n├─────────────────────────────────────────────────────────────────────┤\n│  开发者问询                                                         │\n│     │                                                              │\n│     ▼                                                              │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │ 1. 解析开发者需求 → 确定需要哪些场景化消息 Skill               │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n│                              │                                      │\n│                              ▼                                      │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │ 2. 按需加载一个或多个子 Skill                                 │  │\n│  │    （每个子Skill自行处理Token检查和具体代码生成）              │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n│                              │                                      │\n│                              ▼                                      │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │ 3. 子Skill依次执行，完成对应场景的开发                         │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n└─────────────────────────────────────────────────────────────────────┘\n```\n\n## 快速导航\n\n根据您的需求，选择相应的场景：\n\n### 我想获取 Push Token\n- **触发条件**：开发者首次集成推送、Token 获取失败、询问 Token 相关问题\n- **跳转到**：`hmos-push-kit-token` Skill\n\n### 我想发送通知消息\n- **触发条件**：开发者要实现消息推送、通知功能、消息提醒\n- **跳转到**：`hmos-push-kit-notification` Skill\n\n### 我想发送应用内通话\u002Fvoip消息\n- **触发条件**：开发者要实现 voip、来电提醒、视频通话功能\n- **跳转到**：`hmos-push-kit-voip` Skill\n\n### 我想发送后台消息\n- **触发条件**：开发者要实现数据静默更新、离线缓存功能\n- **跳转到**：`hmos-push-kit-background` Skill\n\n### 我需要接入多个场景\n- **触发条件**：开发者说\"帮接入推送\"、\"接入华为推送服务\"等未明确场景\n- **处理方式**：主动询问具体场景 → 根据回答路由到对应子Skill组合\n- **重要**：主Skill不生成具体代码，必须路由到子Skill\n\n\n\n## 场景化消息权益说明\n\nPush Kit 支持多种场景化消息权益，部分需要申请才能使用：\n\n| 权益名称 | 说明 | 每日推送限制 | 提醒方式 |\n|---------|------|------------|---------|\n| 即时聊天（IM） | 社交通讯类消息 | 无限制 | 锁屏+铃声+振动 |\n| 音视频通话（voip） | 来电通知 | 无限制 | 锁屏+铃声+振动 |\n| 出行提醒（TRAVEL） | 出行相关通知 | 无限制 | 锁屏+铃声+振动 |\n| 健康数据（HEALTH） | 健康运动通知 | 无限制 | 锁屏+铃声+振动 |\n| 工作事项（WORK） | 工作任务提醒 | 无限制 | 锁屏+铃声+振动 |\n| 资讯营销（默认） | 活动和内容推荐 | 2-5条\u002F设备\u002F日 | 静默通知 |\n\n> **重要提示**：未申请自分类权益的应用，默认推送的都是资讯营销类消息，会受到\"每日每设备 2-5 条\"的严格限制！\n\n## 开发流程总览\n\n### Step 1: 开通推送服务（必须）\n\n推送服务需要在 AppGallery Connect 中开通才能使用。这是获取有效 Push Token 的前提。\n\n**操作路径**：AppGallery Connect → 项目 → 应用 → 增长 → 推送服务 → 立即开通\n\n### Step 2: 配置应用签名（必须）\n\n签名配置决定应用能否正常获取 Push Token：\n- **调试阶段**：使用调试证书 + 调试 Profile\n- **发布阶段**：使用发布证书 + 发布 Profile\n- **自动签名**：DevEco Studio 6.0.0+ 支持自动配置\n\n### Step 3: 获取 Push Token（必须）\n\n所有推送的起点，在应用启动时调用 `getToken()`。\n\n### Step 4: 申请场景化消息权益（推荐）\n\n申请对应类型的自分类权益，可以突破每日推送数量限制。\n\n### Step 5: 开发具体功能\n\n根据业务需求，选择对应的场景化消息类型进行开发。\n\n## 常见问题快速排查\n\n| 问题现象 | 可能原因 | 解决方案 |\n|---------|---------|---------|\n| `getToken()` 返回错误码 1000900010 | 推送服务未开通或签名问题 | 检查推送服务是否开通，重新申请 Profile |\n| 收不到推送消息 | Token 过期或签名问题 | 重新获取 Token，检查签名配置 |\n| Token 一直获取失败 | 调试设备未注册 | 注册调试设备 |\n| 每日推送数量受限 | 未申请自分类权益 | 申请通知消息自分类权益 |\n| 推送数量被频控 | 测试阶段未使用 testMessage 参数 | 设置 testMessage 为 true 进行测试 |\n\n## 参考文档\n\n详细配置说明请参考华为官方文档：\n\n### 官方文档链接\n\n| 文档 | 链接 |\n|------|------|\n| Push Kit 简介 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-kit-introduction |\n| 使用入门 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-gettingstart |\n| 开发准备 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-preparations |\n| 获取Push Token | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-get-token |\n| 推送场景化消息 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-scenes |\n| 发送通知消息 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-send-alert |\n| 推送应用内通话消息(voip) | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fhmos-push-kit-voip |\n| 端云调试 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-server |\n| 申请推送场景化消息权益 | https:\u002F\u002Fdeveloper.huawei.com\u002Fconsumer\u002Fcn\u002Fdoc\u002Fharmonyos-guides\u002Fpush-apply-right |\n\n### 本地参考文档\n\n- `references\u002Fpush-error-codes.md` - Push Kit 错误码速查（快速定位问题）\n- `references\u002Fpush-guide.md` - 推送服务配置完整指南\n- `references\u002Fpush-api.md` - Push Kit API 参考\n- `references\u002Fpush-templates.md` - 完整源代码模板\n\n## 代码生成规则\n\n生成代码时必须遵循：\n1. 使用正确的导入路径：`@kit.PushKit`、`@kit.BasicServicesKit` 等\n2. 所有 ArkTS 类型注解必须正确\n3. 使用 Promise 处理异步操作\n4. 添加适当的错误处理\n5. 使用 `hilog` 模块记录日志\n6. 生成的代码必须能够直接编译通过\n7. 遵守 HarmonyOS 应用开发规范",{"name":5,"description":7},"main","581098187aec1258c6d9e65e1b9866c2e7381167","skills\u002Fharmonyos\u002Fdevelopment\u002Fpush-kit\u002Fhmos-push-kit",0,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills","https:\u002F\u002Fgithub.com\u002FIsKenKenYa","是小啃啃呀-一个初学者，中国开源共享推动者之一。\r\n未来，会涉及OpenHarmony、HarmonyOS（部分应用开源）、Android Open Sources Project等。\r\n\r\n目前正在学习中，欢迎友善的讨论。","2026-10-08 01:02:25",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add IsKenKenYa\u002Fskills --skill hmos-push-kit",{"tool":38,"command":39},"bunx","bunx skills add IsKenKenYa\u002Fskills --skill hmos-push-kit",{"tool":41,"command":42},"pnpm","pnpm dlx skills add IsKenKenYa\u002Fskills --skill hmos-push-kit","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fdevelopment\u002Fpush-kit\u002Fhmos-push-kit\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M75ZN00W20TC7TJ40TDM7E4X","writing-for-agents","为 agent 撰写文档。当创建或编辑 skill、修改 AGENTS.md 或 CLAUDE.md 时使用。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M75ZMZ63RYMNRTPEXW5T82S6","wait-what","停。上一条消息没讲明白：换个说法再讲一遍。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M75ZMXZT6MGCGFMKRTM6V6GW","to-questionnaire","把你无法独自回答的决策转化成一份问卷，交给别人填写。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fto-questionnaire\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M75ZMWQGNJW3E592V94ZYJMX","teach","在当前工作区内，教会用户一项新 skill 或概念。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fteach\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M75ZMVQREJR3YDK0XED9AJHB","handoff","把当前对话压缩成一份交接（handoff）文档，供另一个代理接手。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M75ZMTQAAFGA7QH26WK9Z936","grilling","就一个计划、决策或想法对用户进行无情的访谈。当用户想压力测试自己的思路，或使用任何 'grill' 触发短语时使用。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[]]