{"_id":"@circlerich/trtc-agent-skills","name":"@circlerich/trtc-agent-skills","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@circlerich/trtc-agent-skills","version":"0.1.0","description":"Installer for the TRTC Agent Skills suite (Chat, Call, RTC Engine, Live, Conference) + knowledge base, with one-command MCP setup for Claude Code / Cursor / CodeBuddy / Codex.","bin":{"trtc-agent-skills":"bin/cli.js"},"engines":{"node":">=16"},"keywords":["trtc","real-time-communication","video-conference","live-streaming","chat","webrtc","sdk-integration","ai-skill","mcp"],"author":{"name":"Tencent TRTC Team"},"homepage":"https://trtc.io","repository":{"type":"git","url":"https://git.woa.com/jackyixue/trtc-ai-integration"},"license":"MIT","_id":"@circlerich/trtc-agent-skills@0.1.0","gitHead":"26e477d716a108815fd66c0364d9f90ba7ab88f6","_nodeVersion":"22.12.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-RtBh0s1yeMMe7QCUZhz6OKGR+PqJ3AjTlC1CYq4ZyL0bJbnEASqd8sqmfFFcw2S1iD5gxaHCUWtCK56HzfQ3kg==","shasum":"17f814d302c9866f233c6180980ae150e26b0636","tarball":"https://registry.npmjs.org/@circlerich/trtc-agent-skills/-/trtc-agent-skills-0.1.0.tgz","fileCount":180,"unpackedSize":1742869,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDgm/1ImIS3g42NgueLGj0x30C7LwkoVeX6NQ6uC2EF4QIhAKe2T8RTtMr2oy1xRAr1Kcqtou52LyFpMbru4qoXBE7K"}]},"_npmUser":{"name":"jiushu530","email":"1637044606@qq.com"},"directories":{},"maintainers":[{"name":"jiushu530","email":"1637044606@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/trtc-agent-skills_0.1.0_1781494411371_0.9238547185918213"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-15T03:33:31.206Z","0.1.0":"2026-06-15T03:33:31.585Z","modified":"2026-06-15T03:33:31.819Z"},"maintainers":[{"name":"jiushu530","email":"1637044606@qq.com"}],"description":"Installer for the TRTC Agent Skills suite (Chat, Call, RTC Engine, Live, Conference) + knowledge base, with one-command MCP setup for Claude Code / Cursor / CodeBuddy / Codex.","homepage":"https://trtc.io","keywords":["trtc","real-time-communication","video-conference","live-streaming","chat","webrtc","sdk-integration","ai-skill","mcp"],"repository":{"type":"git","url":"https://git.woa.com/jackyixue/trtc-ai-integration"},"author":{"name":"Tencent TRTC Team"},"license":"MIT","readme":"# TRTC AI Integration\n\n**[English](README.md)** | 简体中文\n\n由 [TRTC](https://trtc.io)（腾讯实时音视频）提供的 Agent Skill，帮助开发者将实时音视频、直播、即时通信能力集成到应用中——从零开始到可上线的代码。\n\n不需要翻文档，用自然语言描述你要做什么，Skill 会自动匹配对应知识、问几个关键问题，然后一步步带你完成集成。\n\n可以用来构建视频会议、直播间、1v1 视频问诊、在线教室、客服会话等场景，支持 Web、iOS、Android、Flutter 等平台。\n\n---\n\n## 安装\n\n**Claude Code**\n\n```bash\n# 第一步 — 添加 TRTC 插件市场\n/plugin marketplace add Tencent-RTC/agent-skills\n\n# 第二步 — 安装插件\n/plugin install trtc-agent-skills@trtc-marketplace\n\n# 第三步 — 无需重启，直接激活\n/reload-plugins\n```\n\n**Cursor**\n\n克隆仓库并安装到 Cursor 本地插件目录：\n\n```bash\ngit clone https://github.com/Tencent-RTC/agent-skills.git ~/.cursor/plugins/local/trtc-agent-skills\n```\n\n然后按 **`Cmd+Shift+P`**（Mac）/ **`Ctrl+Shift+P`**（Windows/Linux）→ 输入 `Reload Window` 回车（或直接重启 Cursor）。\n\n**Codex CLI**\n\n```bash\n# 第一步 — 添加 TRTC 插件市场\ncodex plugin marketplace add Tencent-RTC/agent-skills\n\n# 第二步 — 在 Codex CLI 中打开插件浏览器：\n/plugins\n# 选择 \"TRTC Agent Skills\" 标签页 → 选择 trtc-agent-skills → 按 Enter 安装\n```\n\n**CodeBuddy CLI**\n\n```bash\n# 第一步 — 添加 TRTC 插件市场\n/plugin marketplace add Tencent-RTC/agent-skills\n\n# 第二步 — 安装插件\n/plugin install trtc-agent-skills@trtc-marketplace\n\n# 第三步 — 无需重启，直接激活\n/reload-plugins\n```\n\n## 配置 MCP\n\n本 Skill 需要配合 [Tencent RTC MCP Server](https://trtc.io/document/78382) 使用。Skill 负责集成引导，MCP 负责提供最新 API 文档和生成测试用 `userSig`。\n\n> YOUR_SDKAPPID 和 YOUR_SECRET_KEY 可在[控制台（国际站）](https://console.trtc.io)/[控制台（中国站）](https://console.cloud.tencent.com)的应用详情页获取。\n\n**Claude Code**\n\n```bash\nclaude mcp add tencent-rtc -e SDKAPPID=YOUR_SDKAPPID -e SECRETKEY=YOUR_SECRET_KEY -- npx -y @tencentcloud/sdk-mcp@1.4.3\n```\n\n**Cursor** — 添加到 `.cursor/mcp.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"tencent-rtc\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@tencentcloud/sdk-mcp@1.4.3\"],\n      \"env\": {\n        \"SDKAPPID\": \"YOUR_SDKAPPID\",\n        \"SECRETKEY\": \"YOUR_SECRET_KEY\"\n      }\n    }\n  }\n}\n```\n\n**Codex CLI**\n\n```bash\ncodex mcp add tencent-rtc --env SDKAPPID=YOUR_SDKAPPID --env SECRETKEY=YOUR_SECRET_KEY -- npx -y @tencentcloud/sdk-mcp@1.4.3\n```\n\n**CodeBuddy** — 通过 设置 → 添加 MCP 配置：\n\n```json\n{\n  \"mcpServers\": {\n    \"tencent-rtc\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@tencentcloud/sdk-mcp@1.4.3\"],\n      \"env\": {\n        \"SDKAPPID\": \"YOUR_SDKAPPID\",\n        \"SECRETKEY\": \"YOUR_SECRET_KEY\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## 能做什么\n\n当你提到 TRTC 或描述一个实时通信场景时，Skill 会自动触发，无需任何斜杠命令，直接用自然语言提问即可。\n\n| | 功能说明 | 示例 |\n|---|---|---|\n| **快速上手** | 引导你跑通 Demo、从零集成、排查错误或添加新功能 | *\"我想在 Web 应用里加视频会议\"* · *\"用户进房报错 6206\"* · *\"会议已接入，现在想加屏幕共享\"* |\n| **场景引导** | 加载完整场景，按顺序逐步实现每个能力，每步附代码和验证 | *\"我想搭建一个会议应用\"* · *\"我想用 Conference 搭建一个医疗问诊场景\"* |\n| **文档查询** | 从官方知识库检索事实性问题，每个答案附来源引用 | *\"错误码 6206 是什么意思？\"* · *\"Conference 按分钟怎么计费？\"* · *\"会议室最多支持多少人？\"* |\n\nSkill 会在项目中保存你的进度。关掉工具下次回来，可以从上次中断的地方继续，不需要重新复述你在做什么。\n\n---\n\n## 支持的产品与平台\n\n| 产品 | 说明 | 可用状态 |\n|------|------|---------|\n| **Conference** | 视频会议——多人会议、屏幕共享、会中聊天 | Web ✅ |\n| **Live** | 互动直播——主播/观众、连麦、弹幕、礼物、美颜 | 即将支持 |\n| **Chat** | 即时通信——消息、会话、群组、用户资料 | 即将支持 |\n| **Call** | 音视频通话——1v1 和群组通话 | 即将支持 |\n| **RTC Engine** | 实时音视频引擎——进房、推流、拉流 | 即将支持 |\n\n\n---\n\n## 工作原理\n\n当你描述要做什么时，Skill 会：\n\n- **识别**你的 TRTC 产品和平台——从你的描述或项目文件中推断\n- **询问**你的意图：跑通 Demo、从零集成、排查错误，还是在已有项目上扩展功能\n- 对于集成任务，从知识库**匹配场景**，展示完整的能力清单——要实现什么、按什么顺序——确认后再开始\n- **逐步推进**，每次只处理一个能力，给出可用代码，等你确认成功后再继续\n- **保存进度**到项目根目录的 `.trtc-session.yaml`（自动加入 `.gitignore`），支持跨 session 续接\n\n集成引导目前仅支持 **Conference Web**。文档查询、错误码搜索、计费咨询全产品可用（Conference、Live、Chat、Call、RTC Engine）。\n\n### 知识库：Slice 与 Scenario\n\nSkill 的知识分两层：\n\n**Slice** 是原子能力单元——每个功能对应一个 Slice，如 `conference/join-room`、`conference/screen-share`、`live/barrage`。每个 Slice 分两层：\n- 产品级概览：功能说明、核心概念、最佳实践、排障指南（跨平台通用）\n- 平台实现细节：具体 API、代码示例、平台特有注意事项\n\n**Scenario** 是面向完整场景的 Slice 串联。例如「会议室」Scenario 按顺序链接多个 Slice——从鉴权、创建房间，到屏幕共享、成员管理、退出清理——以真实集成顺序排列。\n\n---\n\n## 相关链接\n\n- [TRTC 文档](https://trtc.io/document)\n- [控制台（国际站）](https://console.trtc.io)\n- [控制台（中国站）](https://console.cloud.tencent.com)\n- [下载 SDK](https://trtc.io/download)\n- [提交问题](https://github.com/Tencent-RTC/agent-skills/issues)\n","readmeFilename":"README.zh.md","_rev":"1-2ca4a75d58bedf2236f84d9513e525fc"}