@tencent-rtc/trtc-agent-skills 0.1.6 → 0.1.8

package/AGENTS.md

@@ -2,7 +2,7 @@
 
 Reply in the user's language.
 
-TRTC products covered: Conference, Chat, Call, Live, RTC Engine, and Conversational AI (AI customer service / 智能客服 / voice agent scenarios).
+TRTC products covered: Conference, Chat, Call, Live, RTC Engine, Conversational AI (AI customer service / 智能客服 / voice agent / AI oral coach / 口语陪练 / speaking coach scenarios), and TIMPush (离线推送).
 
 For any TRTC-related request, read and follow `skills/trtc/SKILL.md` first.
 This file is an installed host bootstrap. The actual TRTC skill lives under

package/CLAUDE.md

@@ -2,7 +2,7 @@
 
 Reply in the user's language.
 
-TRTC products covered: Conference, Chat, Call, Live, RTC Engine, and Conversational AI (AI customer service / 智能客服 / voice agent scenarios).
+TRTC products covered: Conference, Chat, Call, Live, RTC Engine, Conversational AI (AI customer service / 智能客服 / voice agent / AI oral coach / 口语陪练 / speaking coach scenarios), and TIMPush (离线推送).
 
 For any TRTC-related request, read and follow `skills/trtc/SKILL.md` first.
 This file is an installed host bootstrap. The actual TRTC skill lives under

package/CODEBUDDY.md

@@ -2,7 +2,7 @@
 
 Reply in the user's language.
 
-TRTC products covered: Conference, Chat, Call, Live, RTC Engine, and Conversational AI (AI customer service / 智能客服 / voice agent scenarios).
+TRTC products covered: Conference, Chat, Call, Live, RTC Engine, Conversational AI (AI customer service / 智能客服 / voice agent / AI oral coach / 口语陪练 / speaking coach scenarios), and TIMPush (离线推送).
 
 For any TRTC-related request, read and follow `skills/trtc/SKILL.md` first.
 This file is an installed host bootstrap. The actual TRTC skill lives under

package/README.md

@@ -2,72 +2,23 @@
 
 **English** | [简体中文](README.zh.md)
 
-An agent skill provided by [TRTC](https://trtc.io) (Tencent Real-Time Communication) to help developers integrate real-time audio/video, live streaming, and instant messaging into their apps — from first setup to production-ready code.
+An agent skill provided by [TRTC](https://trtc.io/?utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=HIzH2eVJ) (Tencent Real-Time Communication) to help developers integrate real-time audio/video, live streaming, instant messaging, and TIMPush offline push into their apps — from first setup to production-ready code.
 
 Instead of reading through long documentation, you describe what you want to build in plain language. The skill routes your request to the right knowledge, asks a few clarifying questions, and walks you through the integration step by step.
 
-You can use it to build scenarios like video conferencing, live streaming rooms, 1-on-1 video consultations, online classrooms, or customer support chat — across Web, iOS, Android, Flutter, and more.
+You can use it to build scenarios like video conferencing, live streaming rooms, 1-on-1 video consultations, online classrooms, customer support chat, or mobile offline push — across Web, iOS, Android, Flutter, and more.
 
 ---
 
 ## About Tencent RTC
 
-[Tencent RTC](https://trtc.io) (Real-Time Communication) powers real-time audio, video, and conversational AI experiences for thousands of businesses worldwide. With a global edge network spanning 200+ countries and regions, TRTC delivers sub-300ms ultra-low latency at scale.
+[Tencent RTC](https://trtc.io/?utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=HIzH2eVJ) (Real-Time Communication) powers real-time audio, video, and conversational AI experiences for thousands of businesses worldwide. With a global edge network spanning 200+ countries and regions, TRTC delivers sub-300ms ultra-low latency at scale.
 
 ---
 
 ## Installation
 
-**Claude Code**
-
-```bash
-# Step 1 — add the TRTC plugin marketplace
-/plugin marketplace add Tencent-RTC/agent-skills
-
-# Step 2 — install the plugin
-/plugin install trtc-agent-skills@trtc-marketplace
-
-# Step 3 — activate without restarting
-/reload-plugins
-```
-
-**Cursor**
-
-Clone the repo into Cursor's local plugin directory:
-
-```bash
-git clone https://github.com/Tencent-RTC/agent-skills.git ~/.cursor/plugins/local/trtc-agent-skills
-```
-
-Then press **`Cmd+Shift+P`** (Mac) / **`Ctrl+Shift+P`** (Windows/Linux) → `Reload Window` (or restart Cursor).
-
-**Codex CLI**
-
-```bash
-# Step 1 — add the TRTC plugin marketplace
-codex plugin marketplace add Tencent-RTC/agent-skills
-
-# Step 2 — open the plugin browser inside Codex CLI:
-/plugins
-# Select the "TRTC Agent Skills" tab → select trtc-agent-skills → press Enter to install
-```
-
-**CodeBuddy CLI**
-
-```bash
-# Step 1 — add the TRTC plugin marketplace
-/plugin marketplace add Tencent-RTC/agent-skills
-
-# Step 2 — install the plugin
-/plugin install trtc-agent-skills@trtc-marketplace
-
-# Step 3 — activate without restarting
-/reload-plugins
-```
-
-### Install via npx (any IDE, no plugin marketplace required)
-
-If your IDE doesn't have a plugin marketplace, or you'd rather pin the install to a specific project, use the npx installer. Run it inside your project directory:
+Use the npx installer. Run it inside your project directory:
 
 ```bash
 # Default — auto-detect installed IDEs (~/.{claude,cursor,codebuddy,codex}/)
@@ -84,25 +35,6 @@ npx -y @tencent-rtc/trtc-agent-skills@latest add --ide cursor
 npx -y @tencent-rtc/trtc-agent-skills@latest add --clean
 ```
 
-## Using with MCP
-
-This skill calls **one** optional MCP server: `tencent-rtc-skill-tool` (package
-[`@tencent-rtc/skill-tool`](https://www.npmjs.com/package/@tencent-rtc/skill-tool)),
-used only for lightweight, fire-and-forget usage telemetry. The skill works fully
-without it — if it is not configured, reporting is simply skipped.
-
-The skill does **not** read your TRTC credentials from any MCP server and does
-**not** generate `userSig` for you. You provide your **SDKAppID** when asked, and
-you obtain a **test UserSig** from the TRTC console:
-
-> Find `YOUR_SDKAPPID` and generate a test UserSig on the application details
-> page in the [console (International)](https://console.trtc.io) or
-> [console (China)](https://console.cloud.tencent.com). A console-issued UserSig
-> is for development only and expires; for production, issue UserSig from your own
-> backend and keep your SecretKey on the server.
-
-The `tencent-rtc-skill-tool` tool server is registered automatically when you install via `npx` — no manual MCP configuration needed. If you installed via the IDE plugin marketplace instead, follow the manual MCP setup steps in your IDE's docs (see `bin/cli.js` for the exact server entry).
-
 ---
 
 ## What it does
@@ -114,6 +46,9 @@ The skill activates automatically when you mention TRTC or describe a real-time
 | **Get started** | Guides you through demo setup, SDK integration, troubleshooting, or adding a new feature — step by step | • *"I want to add video conferencing to my web app"*<br>• *"I'm getting error 6206 when users join"*<br>• *"Conference is working — now I want to add screen sharing"* |
 | **Scenario walkthrough** | Loads a complete feature scenario and walks you through each capability in order, with code and checkpoints | • *"Walk me through building a complete conference room from scratch"*<br>• *"Guide me through a 1-on-1 video consultation end to end"* |
 | **AI customer service** | Builds a voice-first AI customer service agent from scratch — or wires the AI backend into your existing app. Covers credential setup, capability assembly (knowledge base, human handoff, tool calling, session summary), and launch | • *"Build me an AI customer service agent with TRTC"*<br>• *"I want to integrate AI customer service into my existing Node.js backend"*<br>• *"Help me set up TRTC Conversational AI"* |
+| **AI oral coach** | Builds a voice-first AI oral English speaking coach from scratch — or wires the AI backend into your existing app. Covers credential setup, capability assembly (scenario roleplay, quick correction, reply suggestions, ability report, custom learning KB), and launch | • *"Build me an AI oral English coach with TRTC"*<br>• *"I want to integrate AI speaking practice into my existing app"*<br>• *"Help me set up an AI speaking coach"* |
+| **AI realtime interpreter** | Builds a real-time AI meeting interpreter from scratch — or wires the translation backend into your existing app. Covers credential setup, capability assembly (realtime translation, meeting fanout, bilingual subtitles, transcription), and launch | • *"Build me a real-time AI interpreter with TRTC"*<br>• *"I want to add real-time translation to my meeting room"*<br>• *"Help me set up AI meeting interpretation"* |
+| **Push offline push** | Guides TIMPush integration and troubleshooting via `trtc-push-mcp`, covering Android, iOS, Flutter, UniApp, vendor channel setup, APNs, badge, server API, and console limit checks | • *"Help me integrate TIMPush"*<br>• *"Integrate Tencent Cloud offline push"*<br>• *"registerPush failed with 800006"* |
 | **Docs & lookup** | Answers factual questions from the official knowledge base with cited sources | • *"What does error code 6206 mean?"*<br>• *"How much does Conference cost per participant minute?"*<br>• *"What's the max number of participants?"* |
 
 The skill saves your progress in the project. If you close the tool and come back later, it picks up where you left off.
@@ -124,10 +59,11 @@ The skill saves your progress in the project. If you close the tool and come bac
 
 | Product | Description | Availability |
 |---------|-------------|--------------|
-| **Conference** | Video conferencing — multi-party meetings, screen sharing, in-meeting chat | Web ✅ |
-| **Conversational AI** | Voice-first AI customer service agent — voice agent, knowledge base lookup, human handoff, tool calling, session summary | Web ✅ |
+| **Conference** | Video conferencing — multi-party meetings, screen sharing, in-meeting chat | Web ✅ (Vue3 / React) |
+| **Conversational AI** | Voice-first AI agents — AI customer service (voice agent, knowledge base, human handoff, tool calling, session summary), AI oral coach (scenario roleplay, quick correction, reply suggestions, ability report), and AI realtime interpreter (multilingual meeting interpretation, bilingual subtitles, fanout orchestration) | Web ✅ |
 | **Live** | Interactive live streaming — anchor/audience roles, co-hosting, barrage, gifts, beauty filters | Coming soon |
-| **Chat** | Instant messaging — messages, conversations, groups, user profiles | Coming soon |
+| **Chat** | Instant messaging — messages, conversations, groups, user profiles | Web ✅ |
+| **Push** | Tencent Cloud IM Push / offline push — Android/iOS push setup, vendor channels, APNs, Flutter, UniApp, badge, server API, and troubleshooting | Android / iOS / Flutter / UniApp ✅ |
 | **Call** | Audio/video calling — 1-on-1 and group calls | Coming soon |
 | **RTC Engine** | Low-level real-time audio/video engine — room management, publishing, subscribing | Coming soon |
 
@@ -144,7 +80,7 @@ When you describe what you want to build, the skill:
 - **Walks through** one capability at a time with production-ready code, waits for you to confirm it works, then moves to the next step
 - **Saves your progress** to `.trtc-session.yaml` in your project root (auto-added to `.gitignore`) so you can resume in a later session without re-explaining what you're building
 
-Step-by-step integration is currently available for **Conference on Web** and **Conversational AI (AI customer service)**. The Conversational AI skill uses its own capability model — it does not follow the slice/scenario pipeline; instead it guides you through credential setup, capability selection, and launch in a self-contained flow. Docs lookup, error code search, and pricing questions work across all TRTC products.
+Step-by-step integration is currently available for **Conference on Web (Vue3 / React official RoomKit path)**, **Chat on Web**, **Conversational AI (AI customer service, AI oral coach & AI realtime interpreter)**, and **TIMPush offline push (Android / iOS / Flutter / UniApp)**. The Conversational AI skills use their own capability model — they do not follow the slice/scenario pipeline; instead they guide you through credential setup, capability selection, and launch in a self-contained flow. TIMPush uses the `trtc-push-mcp` workflow engine to drive platform detection, vendor setup, credential-safe local configuration, and troubleshooting. Docs lookup, error code search, and pricing questions work across all TRTC products.
 
 ### Knowledge base: Slices and Scenarios
 

package/README.zh.md

@@ -2,72 +2,23 @@
 
 **[English](README.md)** | 简体中文
 
-由 [TRTC](https://trtc.io)（腾讯实时音视频）提供的 Agent Skill，帮助开发者将实时音视频、直播、即时通信能力集成到应用中——从零开始到可上线的代码。
+由 [TRTC](https://trtc.io/?utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=HIzH2eVJ)（腾讯实时音视频）提供的 Agent Skill，帮助开发者将实时音视频、直播、即时通信和 TIMPush 离线推送能力集成到应用中——从零开始到可上线的代码。
 
 不需要翻文档，用自然语言描述你要做什么，Skill 会自动匹配对应知识、问几个关键问题，然后一步步带你完成集成。
 
-可以用来构建视频会议、直播间、1v1 视频问诊、在线教室、客服会话等场景，支持 Web、iOS、Android、Flutter 等平台。
+可以用来构建视频会议、直播间、1v1 视频问诊、在线教室、客服会话、移动端离线推送等场景，支持 Web、iOS、Android、Flutter 等平台。
 
 ---
 
 ## 关于 Tencent RTC
 
-[Tencent RTC](https://trtc.io)（实时音视频）为全球数千家企业提供实时音频、视频和对话式 AI 体验。依托覆盖 200+ 国家和地区的全球边缘网络，TRTC 提供低于 300ms 的超低延迟大规模实时通信能力。
+[Tencent RTC](https://trtc.io/?utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=HIzH2eVJ)（实时音视频）为全球数千家企业提供实时音频、视频和对话式 AI 体验。依托覆盖 200+ 国家和地区的全球边缘网络，TRTC 提供低于 300ms 的超低延迟大规模实时通信能力。
 
 ---
 
 ## 安装
 
-**Claude Code**
-
-```bash
-# 第一步 — 添加 TRTC 插件市场
-/plugin marketplace add Tencent-RTC/agent-skills
-
-# 第二步 — 安装插件
-/plugin install trtc-agent-skills@trtc-marketplace
-
-# 第三步 — 无需重启，直接激活
-/reload-plugins
-```
-
-**Cursor**
-
-克隆仓库并安装到 Cursor 本地插件目录：
-
-```bash
-git clone https://github.com/Tencent-RTC/agent-skills.git ~/.cursor/plugins/local/trtc-agent-skills
-```
-
-然后按 **`Cmd+Shift+P`**（Mac）/ **`Ctrl+Shift+P`**（Windows/Linux）→ 输入 `Reload Window` 回车（或直接重启 Cursor）。
-
-**Codex CLI**
-
-```bash
-# 第一步 — 添加 TRTC 插件市场
-codex plugin marketplace add Tencent-RTC/agent-skills
-
-# 第二步 — 在 Codex CLI 中打开插件浏览器：
-/plugins
-# 选择 "TRTC Agent Skills" 标签页 → 选择 trtc-agent-skills → 按 Enter 安装
-```
-
-**CodeBuddy CLI**
-
-```bash
-# 第一步 — 添加 TRTC 插件市场
-/plugin marketplace add Tencent-RTC/agent-skills
-
-# 第二步 — 安装插件
-/plugin install trtc-agent-skills@trtc-marketplace
-
-# 第三步 — 无需重启，直接激活
-/reload-plugins
-```
-
-### 通过 npx 安装（任意 IDE，无需插件市场）
-
-如果你所在的 IDE 没有插件市场，或者你希望把安装范围限定在某个具体项目里，可以用 npx 安装器。在项目根目录执行：
+使用 npx 安装器。在项目根目录执行：
 
 ```bash
 # 默认 — 自动检测已安装的 IDE（~/.{claude,cursor,codebuddy,codex}/）
@@ -84,21 +35,6 @@ npx -y @tencent-rtc/trtc-agent-skills@latest add --ide cursor
 npx -y @tencent-rtc/trtc-agent-skills@latest add --clean
 ```
 
-## 配置 MCP
-
-本 Skill 只调用 **一个** 可选的 MCP Server：`tencent-rtc-skill-tool`（包
-[`@tencent-rtc/skill-tool`](https://www.npmjs.com/package/@tencent-rtc/skill-tool)），
-仅用于轻量的、即发即忘的使用情况上报。没有它 Skill 也能完整工作——未配置时自动跳过上报。
-
-本 Skill **不会** 从任何 MCP 读取你的 TRTC 凭证，也 **不会** 替你生成 `userSig`。
-你在被询问时提供 **SDKAppID**，并自行到 TRTC 控制台获取 **测试 UserSig**：
-
-> 在[控制台（国际站）](https://console.trtc.io) / [控制台（中国站）](https://console.cloud.tencent.com)
-> 的应用详情页获取 `YOUR_SDKAPPID`，并通过「快速跑通 / UserSig 生成&校验」生成测试 UserSig。
-> 控制台签发的 UserSig 仅用于开发联调且会过期；生产环境必须由你自己的后端签发，SecretKey 务必只保留在服务端。
-
-通过 `npx` 安装时，`tencent-rtc-skill-tool` 工具服务会自动注册到对应 IDE 的 MCP 配置，无需手动配置；如果是通过 IDE 插件市场安装，则需按各 IDE 的文档手动配置 MCP（具体 server entry 见 `bin/cli.js`）。
-
 ---
 
 ## 能做什么
@@ -110,6 +46,9 @@ npx -y @tencent-rtc/trtc-agent-skills@latest add --clean
 | **快速上手** | 引导你跑通 Demo、从零集成、排查错误或添加新功能 | *"我想在 Web 应用里加视频会议"* · *"用户进房报错 6206"* · *"会议已接入，现在想加屏幕共享"* |
 | **场景引导** | 加载完整场景，按顺序逐步实现每个能力，每步附代码和验证 | *"我想搭建一个会议应用"* · *"我想用 Conference 搭建一个医疗问诊场景"* |
 | **AI 客服搭建** | 从零搭建语音优先的 AI 客服智能体，或将 AI 客服后端接入现有应用。覆盖密钥配置、能力组装（知识库、人工转接、工具调用、会话摘要）、服务启动全流程 | *"帮我用 TRTC 搭建一个 AI 客服"* · *"我想把 AI 客服能力集成到我的 Node.js 后端"* · *"帮我接入 TRTC Conversational AI"* |
+| **AI 口语陪练** | 从零搭建语音优先的 AI 英语口语陪练教练，或将 AI 口语陪练后端接入现有应用。覆盖密钥配置、能力组装（场景角色扮演、单句纠正、接话建议、能力报告、自定义知识库）、服务启动全流程 | *"帮我用 TRTC 搭建一个 AI 口语陪练"* · *"我想把口语陪练能力集成到我的应用中"* · *"帮我搭建一个英语口语教练"* |
+| **AI 实时翻译** | 从零搭建实时 AI 会议翻译，或将翻译后端接入现有应用。覆盖密钥配置、能力组装（实时翻译、会议扇出、双语字幕、转写记录）、服务启动全流程 | *"帮我用 TRTC 做一个 AI 实时会议翻译"* · *"我想把 AI 实时翻译能力接入我现有的会议室"* · *"帮我搭建一个同声传译系统"* |
+| **Push 离线推送** | 通过 `trtc-push-mcp` 引导 TIMPush 集成和排障，覆盖 Android、iOS、Flutter、UniApp、厂商通道、APNs、角标、服务端 API 和控制台限制检查 | *"帮我集成 TIMPush"* · *"接入腾讯云离线推送"* · *"registerPush 报 800006"* |
 | **文档查询** | 从官方知识库检索事实性问题，每个答案附来源引用 | *"错误码 6206 是什么意思？"* · *"Conference 按分钟怎么计费？"* · *"会议室最多支持多少人？"* |
 
 Skill 会在项目中保存你的进度。关掉工具下次回来，可以从上次中断的地方继续，不需要重新复述你在做什么。
@@ -120,10 +59,11 @@ Skill 会在项目中保存你的进度。关掉工具下次回来，可以从
 
 | 产品 | 说明 | 可用状态 |
 |------|------|---------|
-| **Conference** | 视频会议——多人会议、屏幕共享、会中聊天 | Web ✅ |
-| **Conversational AI** | 语音优先的 AI 客服智能体——语音对话、知识库检索、人工转接、工具调用、会话摘要 | Web ✅ |
+| **Conference** | 视频会议——多人会议、屏幕共享、会中聊天 | Web ✅（Vue3 / React） |
+| **Conversational AI** | 语音优先的 AI 智能体——AI 客服（语音对话、知识库检索、人工转接、工具调用、会话摘要）、AI 口语陪练（场景角色扮演、单句纠正、接话建议、能力报告）与 AI 实时翻译（多语言会议翻译、双语字幕、扇出编排） | Web ✅ |
 | **Live** | 互动直播——主播/观众、连麦、弹幕、礼物、美颜 | 即将支持 |
-| **Chat** | 即时通信——消息、会话、群组、用户资料 | 即将支持 |
+| **Chat** | 即时通信——消息、会话、群组、用户资料 | Web ✅ |
+| **Push** | 腾讯云即时通信推送 / 离线推送 TIMPush——Android/iOS 推送配置、厂商通道、APNs、Flutter、UniApp、角标、服务端 API 和排障 | Android / iOS / Flutter / UniApp ✅ |
 | **Call** | 音视频通话——1v1 和群组通话 | 即将支持 |
 | **RTC Engine** | 实时音视频引擎——进房、推流、拉流 | 即将支持 |
 
@@ -140,7 +80,7 @@ Skill 会在项目中保存你的进度。关掉工具下次回来，可以从
 - **逐步推进**，每次只处理一个能力，给出可用代码，等你确认成功后再继续
 - **保存进度**到项目根目录的 `.trtc-session.yaml`（自动加入 `.gitignore`），支持跨 session 续接
 
-集成引导目前支持 **Conference Web** 和 **Conversational AI（AI 客服）**。Conversational AI Skill 拥有独立的能力模型，不走 Slice/Scenario 流水线，而是通过自闭环的引导流程完成密钥配置、能力选择和服务启动。文档查询、错误码搜索、计费咨询全产品可用（Conference、Live、Chat、Call、RTC Engine）。
+集成引导目前支持 **Conference Web（Vue3 / React 官方 RoomKit 路径）**、**Chat Web**、**Conversational AI（AI 客服、AI 口语陪练 & AI 实时翻译）** 和 **TIMPush 离线推送（Android / iOS / Flutter / UniApp）**。Conversational AI Skill 拥有独立的能力模型，不走 Slice/Scenario 流水线，而是通过自闭环的引导流程完成密钥配置、能力选择和服务启动。TIMPush 通过 `trtc-push-mcp` workflow engine 驱动平台识别、厂商配置、凭据安全的本地配置写入和排障流程。文档查询、错误码搜索、计费咨询全产品可用（Conference、Live、Chat、Call、RTC Engine、TIMPush）。
 
 ### 知识库：Slice 与 Scenario