用途
本 Skill 面向 TIMPush（Tencent Cloud IM Push / 腾讯云即时通信推送）的集成与排障，覆盖 Android、iOS、Flutter、uni-app、HarmonyOS 以及服务端 API 场景。其核心思路是把流程编排交给 trtc-push-mcp 的 workflow engine，Skill 侧只负责按引擎下发的当前 prompt 执行单步并提交结构化结果。
主要能力
- 集成引导：命中集成入口（如“集成 push / 接入离线推送”）时，先调用 detect 系列工具判断项目平台，再选择 wizard-android / wizard-ios / wizard-flutter / wizard-uniapp 等 workflow。
- 排障引导：针对 Android / iOS 的 TIMPush 排障，进入对应 troubleshoot-* workflow 的 stage-0 收集症状与证据。
- 知识路由：通过 issues/ROUTER.json 的 match_any / priority / platform 得到候选 target 或 workflow_id，只读命中的 target，避免通读全部知识库。
- 受控兜底：仅在 workflow 连续无法恢复时进入 fallback，且仍遵守 hard-rules 与凭据安全红线。
使用方式
工作流按 list_workflows → get_workflow_state → 按返回的 prompt / required_tool_calls / completion_schema 执行 → complete_workflow_step { run_id, step, output } 的顺序推进，next_state 只能来自引擎返回值。产品使用时每轮向 get_workflow_state 传 user_prompt，调试或无法判断时不传。
MCP 工具不在列表、调用报错或 list_workflows 无预期返回时，最常见原因是 MCP 未启用。此时需按 IDE 指引让用户开启后重载并重新进入流程：Cursor 到侧边栏 Customize → MCP 打开 trtc-push-mcp 开关并重载窗口；Claude Code 重启会话或用 /mcp 批准；CodeBuddy 确认项目根存在 .mcp.json 后重启；Codex 在项目目录运行 codex 并接受 trust 提示。
适用场景
- 在移动端或跨端工程中接入腾讯云 IM 离线推送。
- 排查推送注册、厂商通道、错误码相关问题。
- 需要读取官方 SDK API 与代码模板来编写 Gradle / Application / Podfile / AppDelegate / registerPush 代码。
限制
- 排障默认零写入，未获用户本轮明确授权前禁止修改用户工程文件。
- MCP workflow 的覆盖范围以 list_workflows 返回为准；RN 目前主要通过 issues/ 做排查引导。
- Flutter 与 uni-app 需走各自 wizard，除非用户明确只要改某一原生子工程。
- 具体支持的平台版本、收费与价格信息在提供的资料中暂未说明。