前言¶
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 入口。
