前言¶

在对话式开发环境里查云资源、看架构图、做成本或合规分析时，常见做法是切到控制台、文档或单独运维工具，再把结论贴回 IDE。上下文容易断，问答也难以覆盖智能顾问、巡检、容量与混沌演练等一整套 CloudOps 动作。下面介绍 SkillHub 上的 CloudQ（@tencent-adm/cloudq）：由 Tencent CloudQ Team 发布，把上述能力以 Agent Skill 形式挂到 Cursor、Claude Code 等客户端，在自然语言对话中触发。

这是什么¶

CloudQ 是面向 腾讯云、AWS、阿里云等多云 的运维与架构类 Skill，分类为 it-ops-security，来源标注为 enterprise，当前版本 1.9.0。它解决的是：在 Agent 会话里完成智能顾问相关操作、AIOps 类巡检与诊断，以及资源查询、成本与安全合规等 ChatOps/CloudOps 诉求，而不必为每一类问题单独写脚本或记控制台路径。

SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/cloudq
技能元数据地址：https://api.skillhub.cn/tencent-adm/cloudq

核心功能¶

以下能力均来自官方简介，按主题归纳，不超出已公开描述。

智能顾问与架构

• 查看智能顾问架构图、架构目录、架构详情、架构评估结果
• 绘制架构图、开通智能顾问
• 架构健康度评估

AI 运维与可靠性

• AI 智能巡检
• AI 容量监测
• AI 混沌演练
• AI 云诊断
• 主动预警

日常运维与治理

• 云运维问答
• 云资源查询
• 云成本优化
• 安全合规
• 云资源盘点
• 闲置资源检查
• 云产品最佳实践

标签 requires_api_key=true 表示启用前需要配置 API 密钥；具体字段名与获取方式以安装后包内 SKILL.md 及腾讯云 CloudQ 产品文档为准，此处不臆造配置项。

安装与启用¶

1、安装 SkillHub CLI（若尚未安装）¶

先确认本机是否已有 skillhub：

command -v skillhub && skillhub --version

未安装时可按 SkillHub 官方安装说明执行（完整安装或仅 CLI）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装指引全文：https://skillhub.cn/install/skillhub.md

2、安装 CloudQ 到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不会被 Agent 加载。

skillhub install @tencent-adm/cloudq --dir <skills 目录>

常用路径（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可在对话中让 AI 按官方提示安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/cloudq`。

3、API 密钥与重启¶

Skill 标记需要 API Key。安装完成后阅读技能包内 SKILL.md，按说明配置密钥并重启或重新加载 Agent，使 Skill 生效。

典型用法¶

官方页面未提供独立 REST 示例；典型用法是在已启用 CloudQ 的 Agent 里用自然语言描述运维意图，由 Skill 路由到对应 CloudQ 能力。下列表述与官方简介中的场景一致，可作为对话起点（具体能否执行取决于账号权限与密钥配置）：

列出当前账号下某区域的云服务器实例，并标出可能闲置的资源。

查看智能顾问里某业务的架构目录和架构评估结果，并说明架构健康度方面的主要风险。

针对腾讯云 / AWS / 阿里云中的指定环境，做一次成本优化与安全合规相关的检查建议。

我想开通智能顾问并绘制一张包含负载均衡与数据库的参考架构图，请按最佳实践给出步骤。

经过上面的步骤，Agent 应结合 Skill 内工具说明调用后端能力；若返回权限或密钥错误，优先核对 API Key 与云账号授权。

适用场景与注意¶

适合谁

• 需要在 IDE 或 CLI Agent 里做多云资源查询、架构审视、成本与合规讨论的 SRE、平台工程师、云架构师
• 希望把智能顾问、巡检、容量、混沌演练、云诊断等 AIOps 动作收敛到同一对话入口的团队

限制与注意

• enterprise 来源技能，使用前确认组织是否允许安装及外连 CloudQ 服务。
• 必须配置 API Key（requires_api_key=true），未配置时相关能力不可用。
• SkillHub 统计（以抓取资料为准）：评分 100000，下载 4973，安装 122；安装量与评分仅作选型参考，不代表与你环境一致的效果。
• 多云能力以官方简介为准；实际覆盖的产品与区域以 CloudQ 服务侧为准。
• 安装目录错误是常见坑：务必 skillhub install ... --dir 指向当前 Agent 的 skills 路径。

结尾¶

CloudQ 把智能顾问、架构评估与一系列 AIOps/ChatOps 能力封装成 @tencent-adm/cloudq，适合在 Coding Agent 里用对话完成云运维与治理类任务。选型与安装请以 SkillHub 页面与元数据为准：

• https://www.skillhub.cn/skills/tencent-adm/cloudq
• https://api.skillhub.cn/tencent-adm/cloudq