前言¶
Web 性能问题往往出现在特定机型、网络或页面路径上，单靠本地 Lighthouse 或预发压测很难还原。团队若在业务里接入了腾讯云 RUM（Real User Monitoring），控制台里已经有 LCP、JS 报错、接口耗时和 PV/UV 等数据，但排查时仍要在多个视图间切换、自己拼时间范围和维度。
Tencent Cloud RUM 是 SkillHub 上由腾讯云 RUM 团队发布的 Agent Skill（坐标 @tencent-adm/tencent-cloud-rum-skill，当前版本 1.0.3，来源 enterprise，分类 data-analysis）。它把「向腾讯云 RUM 查询与分析」收敛成 Skill 能力：在 Cursor、Claude Code 等支持 Skills 的客户端里，用自然语言让 Agent 按 Skill 指引拉数、解读指标并协助定位问题。Skill 标注 requires_api_key=true，使用前需准备腾讯云 RUM 相关 API 凭证。
这是什么¶
一句话定位：面向已接入腾讯云 RUM 的 Web 场景，用 Agent Skill 查询 RUM 数据并做性能与稳定性分析。
维护方是腾讯云 RUM 团队；分发渠道为 SkillHub（页面：https://www.skillhub.cn/skills/tencent-adm/tencent-cloud-rum-skill ，API 入口：https://api.skillhub.cn/tencent-adm/tencent-cloud-rum-skill ）。它解决的是「RUM 数据在控制台里分散、人工对照成本高」的问题，而不是替代 RUM SDK 接入或替代服务端 APM。
核心功能¶
以下能力与 SkillHub 简介一致，均为已公示能力：
- Web 性能与 Web Vitals：分析 LCP、FCP 及 Web Vitals 相关表现，用于判断首屏与核心体验是否达标。
- 前端错误排查：针对 JS、Promise 等前端报错做查询与归纳，便于从用户侧堆栈与发生面定位问题。
- API 质量：查看接口延迟与错误率，辅助区分「页面慢」与「后端或网关异常」。
- 静态资源：诊断静态资源加载慢，缩小 CDN、打包体积或路径配置等问题范围。
- 访问规模：查看 PV、UV 等访问指标，结合性能与错误数据看是否集中在特定流量段。
- RUM-APM 关联：支持 RUM 与 APM 的关联分析，在需要前后端串联时减少手工对照。
明确不适用的范围（官方简介原文）：纯后端性能、原生移动端性能、非腾讯云 RUM 平台。
安装与启用¶
SkillHub 页面给出的通用安装方式是：让 AI 根据 SkillHub 安装文档 安装 @tencent-adm/tencent-cloud-rum-skill。下面介绍可直接执行的 CLI 路径（与安装文档第三节一致）。
1、确认或安装 SkillHub CLI
command -v skillhub && skillhub --version
若未安装，可使用文档中的完整安装命令：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装到当前 Agent 的 skills 目录
安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能无法被 Agent 加载。
skillhub install @tencent-adm/tencent-cloud-rum-skill --dir <skills 目录>
常用路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
不同客户端目录不同，以你当前环境为准。安装后按客户端要求刷新或重启，使 Skill 生效。
3、API 凭证
标签 requires_api_key=true 表示需要配置 API Key（或 Skill 文档要求的等价凭证）。具体环境变量名、控制台开通步骤以 Skill 包内 SKILL.md 及腾讯云 RUM 官方文档为准；本文不臆造配置项名称。启用前在腾讯云侧确认账号已开通 RUM 且具备相应数据访问权限。
也可将下面提示词发给 AI，由其按安装文档完成安装（与 SkillHub 页面一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/tencent-cloud-rum-skill`。
典型用法¶
官方页面未单独列出可复制的一键查询命令；典型用法是在已安装 Skill 且凭证就绪后，用自然语言描述排查目标，由 Agent 按 Skill 内流程调用腾讯云 RUM 数据能力。下面示例表述的是常见工作流，具体查询参数与返回字段以 Skill 实现为准。
- 性能回归：说明页面 URL 或业务模块、时间范围，要求查看 LCP/FCP 及 Web Vitals 分布或劣化时段，对比发布前后。
- 线上报错：描述报错类型（如 Promise 未捕获），要求汇总错误量、影响页面与用户侧信息线索。
- 接口异常：给出 API 路径或域名，要求看延迟分位与错误率是否突增。
- 资源慢：针对某次访问或资源类型，要求分析静态资源耗时与慢资源列表。
- 流量与体验：在同一时间窗内同时看 PV/UV 与核心指标，判断是否为流量结构变化导致指标波动。
- 前后端串联：在需要时明确要求 RUM-APM 关联分析，从用户请求延伸到后端链路。
经过上面的步骤，Agent 的价值在于把「该查哪类 RUM 指标、如何解读」固化在 Skill 里，减少每次从控制台菜单重新摸索。
适用场景与注意¶
适合谁
- 前端或全栈工程师，业务已接入腾讯云 RUM，希望在 IDE 对话里完成查数与初步诊断。
- 需要做 Web 真实用户性能、错误、接口与资源问题的日常值班或版本复盘。
- 希望在 RUM 与 APM 之间做关联分析、减少多产品切换的团队。
限制与注意
- 数据边界仅限腾讯云 RUM；其他厂商 RUM、纯服务端性能、原生 App 性能不在简介承诺范围内。
- 必须配置 API 相关凭证；权限不足时查询会失败，需在腾讯云控制台核对。
- SkillHub 统计（抓取时）：评分 100000，下载 1053，安装 49；安装量与评分反映社区使用情况，不代表与你业务数据的实时一致性。
- 分析结论仍应结合发布记录、CDN、网关变更等上下文；Skill 辅助读数与归纳，不能替代变更管理与复现验证。
结尾¶
Tencent Cloud RUM Skill 把腾讯云 RUM 的 Web 性能、错误、API、静态资源、PV/UV 以及 RUM-APM 关联能力接到 Agent 工作流里，适合已用腾讯云 RUM 的团队在对话中做数据驱动的排查。安装与优先源策略见 SkillHub 安装文档；Skill 详情见 SkillHub 页面 与 API 入口。
