zoom-skills

Zoom Developer Platform 技能

此代码库包含用于通过 Zoom SDK、API、MCP 服务和集成，在 Web、移动端、桌面端和服务端环境中进行开发的技能。

代码库说明

• general/references/sdk-upgrade-workflow.md - 可复用的变更日志 + RSS 逐版本 SDK 升级工作流
• 代码库级工具、插件清单和维护文档位于打包根目录；安装原始技能时，应将此 skills/ 目录树视为可移植边界。

文件夹结构

文件夹	描述
zoom-general	中心 - 跨产品用例和共享参考
zoom-rest-api	REST API 调用（600+ 个端点）
zoom-webhooks	实时事件通知（HTTP）
zoom-websockets	实时事件通知（WebSocket）
zoom-meeting-sdk	在应用中嵌入 Zoom 会议（Web、React Native、Electron、Linux）
zoom-video-sdk	自定义视频体验（Web、React Native、Flutter、Android、iOS、macOS、Unity、Linux）
zoom-plugin-sdk	通过 IPC 控制已安装的 Zoom Workplace 客户端的原生 macOS/Windows 配套应用
zoom-apps-sdk	在 Zoom 客户端内运行的应用
scribe	Zoom AI Services Scribe，用于对上传或存储的媒体进行同步和批量转录
summarizer	Zoom AI Services Summarizer，用于生成转录回顾、摘要和行动项
translator	Zoom AI Services Translator，用于纯文本和批量文件翻译
decisions	Zoom AI Services Decisions，用于谓词、受限选择、有序评分、概率和图像比较
zoom-rtms	实时媒体流（实时音频/视频/转录文本）
zoom-team-chat	Team Chat 消息和频道
virtual-agent	Virtual Agent 网页/移动端聊天嵌入和知识库同步工作流
contact-center	Contact Center 应用、网页嵌入和原生移动 SDK 集成
phone	Zoom Phone API、Smart Embed、URI 方案、webhook 和通话历史迁移模式
rivet-sdk	用于 OAuth、webhook 事件和类型化 API 端点封装的 Rivet JavaScript 服务端框架
probe-sdk	在 Meeting SDK 或 Video SDK 加入流程前进行浏览器/设备/网络就绪状态诊断
zoom-ui-toolkit	用于 Video SDK 的预构建 React 组件
zoom-cobrowse-sdk	用于支持服务的协作式浏览
zoom-oauth	OAuth 身份验证流程（全部 4 种授权类型）
zoom-mcp	统一 Zoom MCP Server 和专用产品 MCP 服务的上级路由器
zoom-mcp/whiteboard	白板创建、检索和协作者工具
zoom-mcp/team-chat	Team Chat 消息、文件、联系人、会话、频道和成员工具
zoom-mcp/meetings	会议搜索、素材、录制内容和录制资源
zoom-mcp/canvas	Canvas 文件、区块、协作者和内容工具
zoom-mcp/tasks	任务、评论、受派人、协作者和步骤工具
zoom-mcp/revenue-accelerator	ZRA 对话智能、交易、客户和辅导数据
zoom-mcp/admin	通过 Admin MCP 管理账户设置、群组、用户和权限
zoom-mcp/productivity	AI Productivity Suite Sheets 工具
zoom-mcp/contact-center-admin	Contact Center 用户、队列、角色、技能和号码管理

使用方法

1. 产品专属任务？ → 前往该产品的文件夹（例如，meeting-sdk/）
2. 跨产品或通用任务？ → 查看 zoom-general 了解通用用例
3. 每个文件夹都有一个 SKILL.md → 从这里开始了解该产品的概览

Marketplace 前置条件： 许多产品技能都需要先创建 Zoom Marketplace 应用，之后才会有相应的凭据、作用域、webhook 或 SDK 密钥。如果任务从创建应用、选择应用类型、验证清单、配置作用域、订阅事件或获取凭据开始，请先转到 Marketplace 应用管理，然后再返回产品技能。 如需自动选择，请阅读 Marketplace 模板索引。 对于现有的 General Apps，请使用 清单更新工作流；S2S 和 Meeting SDK 条目属于创建请求，而非 General App 清单。 对于外部 REST/MCP 连接器以及由清单管理的操作或触发器，请将相应的 功能片段合并到完整的 General App 清单中。这与为 Zoom 托管的 MCP 服务配置 OAuth 不同。

技能发现（集成式）

此仓库采用渐进式发现：

• Agent 首先读取 SKILL.md 的 frontmatter（name、description、可选的 triggers）。
• Agent 根据意图，通过 general/SKILL.md 中的 “Choose Your Path” 以及关键词/触发词匹配来选择路径。
• 只有在选定路径后，Agent 才会加载完整的技能内容。

若要提升任何技能的路由质量：

• 让 description 具体且包含丰富的关键词（包括 “use when...”）。
• 为常见的用户表达添加实用的 triggers。
• 避免 Meeting SDK、Video SDK、REST API 和 MCP 意图之间的触发词重叠。

zoom-general（中心）

zoom-general 文件夹包含：

• 跨产品用例 - 涉及多个 Zoom 产品的任务
• 通用参考资料 - 身份验证、应用类型、作用域
• 共享文档 - SDK 维护、故障排除、Marketplace 发布

以下情况请使用 zoom-general：

• 开始新的 Zoom 集成，需要选择合适的方案
• 用例涉及多个 Zoom 产品
• 需要通用的平台文档（身份验证、作用域等）

快速参考

我想要……	使用此技能
构建具有明确请求控制的确定性自动化、配置或报告	zoom-rest-api
创建或更新 Marketplace 清单、Connect 路由、操作或触发器	zoom-rest-api
接收事件通知（HTTP 推送）	zoom-webhooks
接收事件通知（WebSocket）	zoom-websockets
在我的应用中嵌入 Zoom 会议	zoom-meeting-sdk
构建自定义视频体验	zoom-video-sdk
从原生桌面应用控制已安装的 Zoom Workplace 客户端	zoom-plugin-sdk
在 Zoom 客户端中构建应用	zoom-apps-sdk
访问实时音频/视频/文字记录	zoom-rtms
将上传或存储的媒体文件转录为文本	scribe
将文字记录文本概括为回顾、摘要或行动事项	summarizer
翻译纯文本或存储的文本文件	translator
评估谓词、归类到固定选项、对有序等级评分，或比较图像	decisions
构建 Team Chat 集成	zoom-team-chat
构建 Virtual Agent 聊天/营销活动体验	virtual-agent
构建 Contact Center 集成（应用/网站/移动端）	contact-center
构建 Zoom Phone 集成（Smart Embed、API、Webhook、URI 启动）	phone
构建基于 Rivet 的服务端集成（可选）	rivet-sdk
加入会议前运行浏览器/设备/网络预检诊断	probe-sdk
使用预构建的视频 UI 组件	zoom-ui-toolkit
为支持服务启用协同浏览	zoom-cobrowse-sdk
实现 OAuth 身份验证	zoom-oauth
构建 AI 驱动的会议搜索、会议资产检索、录制资源检索或 Zoom Canvas 工作流	zoom-mcp
通过 MCP 工具搜索、发送、编辑或管理 Zoom Team Chat	zoom-mcp/team-chat
通过 MCP 管理 Zoom Canvas 文件、区块、协作者或共享	zoom-mcp/canvas
通过 MCP 工具管理 Zoom Tasks	zoom-mcp/tasks
通过 MCP 获取 ZRA 对话和交易情报	zoom-mcp/revenue-accelerator
通过 MCP 管理 Zoom 账户用户、群组、权限或设置	zoom-mcp/admin
通过 MCP 编辑或管理 AI Productivity Suite Sheets	zoom-mcp/productivity
通过 MCP 管理 Contact Center 用户、队列、角色、技能或号码	zoom-mcp/contact-center-admin
使用稳定的 API 核心 + AI 工具层构建企业级 AI 工作流	zoom-rest-api + zoom-mcp
通用/跨产品指导	zoom-general

API 与 MCP 路由（Zoom 官方指南）

主要目标	路由
自动化、配置、报告、计划任务、严格的重试/错误控制	zoom-rest-api
AI 交互、动态工具发现、跨平台 AI 工作流	zoom-mcp
大规模企业级 AI 体验	zoom-rest-api + zoom-mcp

来源：https://developers.zoom.us/docs/mcp/apis-vs-mcp/

• 深入了解：general/use-cases/apis-vs-mcp-routing.md
• MCP 传输说明：Zoom 当前托管的 MCP 目录使用 Streamable HTTP（需要客户端支持）。

MCP 服务模型（Zoom 托管）

• Zoom 充当 MCP 服务，向外部 AI 客户端提供 Zoom 平台工具/数据。
• MCP 访问受 OAuth 范围限制并受治理。
• 当前按产品划分的 MCP 服务包括 Meetings、Chat、Canvas、Tasks、Whiteboard 和 Revenue Accelerator。统一的 Zoom MCP Server 是独立的一体化入口。
• 使用 zoom-mcp 作为父入口，然后依次创建 Marketplace 应用 -> 获取用户 OAuth 令牌 -> 使用特定产品的 MCP 子技能。从 Marketplace 应用模板中选择匹配的应用模板。

资源

• 官方文档：https://developers.zoom.us/
• 应用市场：https://marketplace.zoom.us/
• 开发者论坛：https://devforum.zoom.us/

操作

• 在原始技能安装期间，请使用各技能目录中的产品 RUNBOOK.md 文件获取运行时和调试指南。