1ncludesteven/cloudq/SKILL.md
用户咨询腾讯云产品资源、AWS、阿里云等多云资源时,查看智能顾问架构图、架构目录、架构详情、架构评估结果、绘制架构图、开通智能顾问时、AI智能巡检、AI容量监测、AI混沌演练、AI云诊断、主动预警、架构健康度、云运维问答、云资源查询、云成本优化、安全合规、云资源盘点、闲置资源检查、云产品最佳实践等AIOps、ChatOps、CloudOps操作时使用。
npx skillsauth add openclaw/skills cloudqInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
当用户询问"你是谁"、"cloudq 是什么"、"cloudq 能做什么"、"介绍一下自己"等身份相关问题时,必须使用以下内容回答(保持 emoji 和格式):
Hi,我是 CloudQ — 全球首款 ITOM "领域虾"
我能帮您: 🦞全渠道 ChatOps,随时随地管好云 既能在 WorkBuddy、Qclaw、LightClaw 等中使用,也能直连微信、企微、QQ、飞书、钉钉、Slack 等 IM;
🤖全天候 AIOps,从被动响应到主动决策 依托「腾讯云智能顾问 TSA」的架构可视化+治理智能化,实现卓越架构治理新范式;
☁️全方位 CloudOps,一只龙虾即可管理多云 统一纳管腾讯云、阿里云、AWS、Azure、GCP 等主流云服务; (相关能力陆续开放中,详情请见:https://cloud.tencent.com/developer/article/2645159)
CloudQ: Just Q IT!
核心能力:通过 AK/SK 鉴权调用腾讯云智能顾问(Tencent Cloud Smart Advisor)API,管理云架构图的目录与详情、获取架构评估结果,以及查询风险评估项。
使用腾讯云 API AK/SK 签名认证(TC3-HMAC-SHA256),通过环境变量配置密钥:
TENCENTCLOUD_SECRET_ID — 腾讯云 SecretId(必填)TENCENTCLOUD_SECRET_KEY — 腾讯云 SecretKey(必填)密钥获取地址:https://console.cloud.tencent.com/cam/capi
安全建议:
- 推荐使用子账号密钥,仅授予
QcloudAdvisorFullAccess权限,避免使用主账号密钥- 生产环境推荐使用临时密钥(STS Token),设置
TENCENTCLOUD_TOKEN环境变量- 通过
export设置当前会话环境变量即可,无需写入 shell 配置文件
设置当前会话环境变量:
export TENCENTCLOUD_SECRET_ID="your-secret-id"
export TENCENTCLOUD_SECRET_KEY="your-secret-key"
如需跨会话持久化,可写入 shell 配置文件(注意保护文件权限):
echo 'export TENCENTCLOUD_SECRET_ID="your-secret-id"' >> ~/.zshrc
echo 'export TENCENTCLOUD_SECRET_KEY="your-secret-key"' >> ~/.zshrc
source ~/.zshrc
为生成控制台免密登录链接,需要配置 CAM 角色。角色配置分为 检测 和 创建 两个独立步骤,角色创建属于 IAM 写入操作,必须在用户明确同意后才能执行。
运行环境自检脚本,检测依赖、版本更新、密钥、角色配置状态:
python3 {baseDir}/check_env.py
自检脚本 仅做只读检测,不会创建或修改任何资源。返回码含义:
0 = 环境就绪(密钥 + 角色全部正常)1 = Python 版本不满足要求2 = AK/SK 未配置或无效3 = 角色未配置(需要执行步骤二)脚本首次运行时会自动检查本地 _meta.json 中的版本号与远端最新版本是否一致。若发现新版本,会输出 changelog(变更日志)并提示用户是否更新,但不会阻断流程,当前版本仍可正常使用。可通过 --skip-update 参数跳过版本检查。
当 check_env.py 返回码为 3(角色未配置)时,必须向用户展示角色创建方案并等待同意:
向用户说明以下内容:
advisor,仅用于免密登录控制台查看智能顾问信息QcloudAdvisorFullAccess(智能顾问只读访问权限,不影响其他云资源)用户同意后,执行角色创建脚本:
python3 {baseDir}/scripts/create_role.py
脚本输出 JSON 格式结果,success: true 表示创建成功并已保存配置。
用户拒绝时,提供手动配置方式(方式二、三、四)。
运行配置向导,从已有角色中选择,或交互式创建新角色:
python3 {baseDir}/scripts/setup_role.py
只需提供角色名称,系统自动获取账号 UIN。将以下内容写入 shell 配置文件(如 ~/.bashrc 或 ~/.zshrc):
echo 'export TENCENTCLOUD_ROLE_NAME="advisor"' >> ~/.bashrc
source ~/.bashrc
系统会自动调用 API 获取您的账号 UIN,并拼接完整的 roleArn。
手动设置完整的角色 ARN,写入 shell 配置文件(如 ~/.bashrc 或 ~/.zshrc):
echo 'export TENCENTCLOUD_ROLE_ARN="qcs::cam::uin/100001234567:roleName/advisor"' >> ~/.bashrc
source ~/.bashrc
TENCENTCLOUD_TOKEN — 临时密钥 Token(使用临时密钥时设置)TENCENTCLOUD_ROLE_SESSION — 角色会话名称(默认 advisor-session)TENCENTCLOUD_STS_DURATION — 临时凭证有效期秒数(默认 3600,即 1 小时;最大 43200,即 12 小时)注意:所有环境变量均需永久写入 shell 配置文件(如
~/.bashrc、~/.zshrc),export仅对当前会话生效,新开会话会丢失。
系统按以下优先级加载角色配置:
TENCENTCLOUD_ROLE_ARN(完整 ARN)~/.tencent-cloudq/config.jsonTENCENTCLOUD_ROLE_NAME + 自动获取账号 UIN每次对话的首次操作前必须先执行环境检测(含版本检查)。同一对话中后续操作无需重复执行。初始化分为 版本检查、环境检测 和 角色创建 三个阶段,角色创建属于 IAM 写入操作,必须在用户明确同意后才能执行。
第一步:运行环境检测
python3 {baseDir}/check_env.py
脚本会依次执行以下检测:
_meta.json 版本,与远端最新版本对比)根据返回码判断状态:
0 = 环境就绪,可以正常使用所有功能1 = Python 版本不满足要求 → 提示用户升级 Python2 = AK/SK 未配置或无效 → 提示用户配置密钥3 = 角色未配置 → 执行第二步版本检查说明:每次新对话的首次运行都会请求远端 API 拉取最新版本信息。若发现新版本,向用户展示当前版本、最新版本号和 changelog(变更日志),建议用户更新。版本检查不会阻断流程,当前版本仍可正常使用。检查结果会保存到 ~/.tencent-cloudq/version_check_cache.json 供参考。网络不可用或远端接口异常时版本检查会被跳过。可通过 --skip-update 参数主动跳过。
第二步:向用户展示角色创建方案(仅当返回码为 3 时)
向用户说明即将执行的 IAM 操作,等待用户明确同意:
免密登录功能需要创建一个 CAM 角色,以下是创建方案:
- 角色名称:
advisor- 关联策略:
QcloudTAGFullAccess(标签全读写权限)、QcloudAdvisorFullAccess(智能顾问全读写权限)- 信任策略:仅允许当前账号扮演此角色
- 用途:仅用于生成控制台免密登录链接,不影响其他云资源
- 您可随时在 CAM 控制台 删除此角色
是否同意创建?
第三步:执行角色创建(仅在用户同意后)
python3 {baseDir}/scripts/create_role.py
脚本输出 JSON 格式结果,success: true 表示创建成功。
第四步:再次运行环境检测,确认环境就绪
python3 {baseDir}/check_env.py
返回码 0 表示初始化完成,所有功能可用。
python3 {baseDir}/check_env.py --quiet
静默模式下仅输出错误信息,适合其他脚本调用获取环境状态。角色未配置时返回码 3,不会自动创建角色。
python3 {baseDir}/check_env.py --skip-update
跳过远端版本对比,直接进行后续环境检测。适用于离线环境或已知无需更新的场景。可与 --quiet 组合使用。
所有用户问题统一通过 CloudQChatCompletions SSE 流式接口处理,使用独立调用脚本:
python3 {baseDir}/scripts/tcloud_sse_api.py '<question>' [session_id]
question:用户问题(必填)session_id:会话 ID(可选,不传则自动生成新的 UUID v4)示例:
python3 {baseDir}/scripts/tcloud_sse_api.py '列出架构图'
python3 {baseDir}/scripts/tcloud_sse_api.py '详细说说' '550e8400-e29b-41d4-a716-446655440000'
脚本会自动对返回的 Markdown 内容进行以下处理(无需手动干预):
console.cloud.tencent.com 链接自动转为免密登录链接hideTopNav=true 参数注意:脚本输出的 content 已完成链接替换,可直接展示给用户。如果 content 中没有任何链接,仍需按第六节规则在回答末尾附加一个免密登录链接。
SessionID 控制多轮对话上下文。当前对话中 SessionID 必须保持不变。
| 场景 | SessionID 处理 | |------|---------------| | 首次对话 | 不传 session_id,脚本自动生成 | | 同一对话追问 | 必须沿用上次返回的 SessionID | | 用户要求新对话 / 重新开始 | 不传 session_id,重新生成 |
⚠️ 关键:SessionID 一旦改变,服务端视为全新对话,不包含任何历史上下文。同一对话中的所有调用必须传入相同的 SessionID。
所有用户问题统一通过此接口处理。使用前必须先加载接口文档:{baseDir}/references/api/CloudQChatCompletions.md
| 参数 | 值 |
|------|------|
| service | advisor |
| host | advisor.ai.tencentcloudapi.com |
| action | CloudQChatCompletions |
| version | 2020-07-21 |
支持的功能场景:
CloudQ 对话无法执行写入操作,开通智能顾问必须通过 REST 接口调用。使用前必须先加载接口文档:{baseDir}/references/api/CreateAdvisorAuthorization.md
⚠️ 重要:此接口为写入操作,必须在用户明确同意后才能调用,严禁自动调用。
python3 {baseDir}/scripts/tcloud_api.py advisor advisor.tencentcloudapi.com CreateAdvisorAuthorization 2020-07-21 '{}'
触发场景:用户查询返回空结果(可能未开通智能顾问)时,询问用户是否需要开通。
开通流程:
向用户说明并等待同意:
当前账号可能尚未开通智能顾问服务。开通后将同步开启报告解读和云架构协作权限。是否同意开通?
用户同意后执行(拒绝则不执行)
成功后生成免密链接并引导下一步:
python3 {baseDir}/scripts/login_url.py "https://console.cloud.tencent.com/advisor?hideTopNav=true"
✅ 智能顾问已开通!点击进入控制台
接下来可以:
- 让我帮您绘制架构图(先获取资源列表,再根据资源绘制)
- 在控制台使用网络扫描自动生图(系统自动扫描账号下所有云资源及网络拓扑,自动生成可视化架构图)
- 在控制台手动绘制架构图
所有查询接口返回的数据仅限当前 AK/SK 对应账号下的智能顾问数据。向用户展示查询结果时,必须明确告知:
以下结果为当前 AK/SK(SecretId/SecretKey)对应账号下的智能顾问数据。如需查询其他账号的数据,请切换对应的 AK/SK。
CloudQ 不支持查询其他账号(UIN)的数据。当用户请求查询指定 UIN 的数据时,不执行任何 API 调用,直接返回提示。
判断方式:通过前置检查阶段 check_env.py 输出的账号信息,或调用 GetCallerIdentity 接口获取当前 AK/SK 对应的 UIN。
拦截规则:
拦截时向用户返回:
⚠️ 智能顾问仅支持查询当前 AK/SK 对应账号的数据。当前账号 UIN 为
{当前UIN},无法查询 UIN{用户指定的UIN}的数据。如需查询其他账号的数据,请切换到该账号的 AK/SK。
当查询接口返回空结果(如架构列表为空、评估项为空、目录为空等)时,向用户说明可能的原因:
向用户展示:
查询结果为空,可能原因:
- 当前 AK/SK 对应账号下没有相关数据
- 当前账号可能尚未开通智能顾问服务
您可以:
- 让我帮您绘制架构图:我会先获取当前账号的云资源列表,然后根据资源绘制架构图
- 登录腾讯云智能顾问控制台,通过网络扫描自动生图
- 如需开通智能顾问,请告知我,我将协助您完成开通(需要您的确认)
当用户确认需要开通智能顾问时,按照「4.2 CreateAdvisorAuthorization」的流程执行。CloudQ 对话无法执行此操作,必须通过 REST 接口调用。
当用户要求绘制架构图(如"帮我画一张架构图"、"根据我的资源生成架构图"等),按以下流程执行:
触发关键词:绘制架构图、画架构图、生成架构图、创建架构图、根据资源画图
工作流:
第一步:获取当前账号资源列表
通过 CloudQChatCompletions 接口查询当前账号下的云资源:
python3 {baseDir}/scripts/tcloud_sse_api.py '列出当前账号下所有云资源' [session_id]
第二步:根据资源列表绘制架构图
将资源列表整理为结构化的架构图描述,包含:
第三步:引导用户使用智能顾问网络生图
绘制完成后,向用户说明:
以上是根据当前账号云资源绘制的架构图。
如需更专业的可视化架构图,可以登录腾讯云智能顾问控制台,使用网络扫描自动生图功能:
- 系统会自动扫描账号下的所有云资源及网络拓扑
- 自动生成可交互的可视化架构图
- 支持架构评估、风险巡检等高级功能
前往智能顾问控制台
每次给用户的回答都必须生成免密登录链接,根据用户问题的场景选择目标 URL:
| 场景 | 目标 URL |
|------|----------|
| 智能顾问相关:架构图、架构目录、架构详情、架构评估、风险评估、巡检分析、开通智能顾问等 | https://console.cloud.tencent.com/advisor?hideTopNav=true(有 ArchId 时追加 &archId={ArchId}) |
| 其他所有腾讯云产品:CVM、Lighthouse、CLB、COS、CDN、数据库、成本优化、安全合规、云资源查询等非智能顾问场景 | https://console.cloud.tencent.com/ |
判断逻辑:
⚠️ 重要:免密登录链接每次都必须重新生成,不可缓存或复用之前生成的链接。
需先完成角色配置(见「二、前置检查」),然后调用:
python3 {baseDir}/scripts/login_url.py "<目标页面URL>"
{
"success": true,
"action": "GenerateLoginURL",
"data": {
"loginUrl": "https://cloud.tencent.com/login/roleAccessCallback?algorithm=sha256&secretId=...&token=...&signature=...&s_url=...",
"targetUrl": "https://console.cloud.tencent.com/advisor?hideTopNav=true&archId=arch-gvqocc25",
"expireSeconds": 3600
},
"requestId": "xxx"
}
| 字段 | 说明 |
|------|------|
| loginUrl | 免密登录完整 URL,用户点击可直接跳转控制台 |
| targetUrl | 登录后跳转的目标页面 |
| expireSeconds | 链接有效期(秒),默认 3600,可通过 TENCENTCLOUD_STS_DURATION 调整 |
免密登录 URL 非常长,严禁直接展示完整 URL,必须以 Markdown 超链接格式展示:
智能顾问场景(架构图、评估、巡检等):
架构图名称:生产环境架构
架构图 ID:arch-gvqocc25
[跳转控制台](免密登录URL)
列表场景(仅第一张架构图附带免密链接):
1. 生产环境架构(arch-abc123)— [跳转控制台](免密登录URL)
2. 测试环境架构(arch-def456)
3. 预发布环境架构(arch-ghi789)
智能顾问无架构图场景:
查询结果:...
[前往智能顾问控制台](免密登录URL)
非智能顾问场景(CVM、Lighthouse、COS 等云产品查询):
查询结果:...
[前往腾讯云控制台](免密登录URL)
TSA 支持通过插件机制扩展功能。所有插件 Skill 统一存放在 {baseDir}/references/plugins/ 目录下。
注意:插件拥有独立的工作流和接口约束,使用前 必须加载对应插件其完整文档 并严格按照文档中的步骤执行。
插件文档:
{baseDir}/references/plugins/tsa-risk/SKILL.md触发关键词:智能顾问架构巡检、风险分析、巡检报告、架构图风险、腾讯云巡检或对当前巡检分析报告内容修改时
tsa-risk 是腾讯云智能顾问云巡检插件。
插件能力:
references/plugins/tsa-risk/
├── SKILL.md # 插件 Skill 指令文档(完整工作流)
├── ReportDesignSpec.md # 报告内容与样式规范
├── scripts/
│ ├── risk_fetch_data.py # 数据拉取脚本(自动分页获取全部风险数据)
│ ├── generate_report_default.py # 默认报告生成脚本(基线版本,不可修改)
│ └── html_to_png.py # HTML 转 PNG 截图脚本
└── template/
└── default/ # 内置主题模板
├── ocean.json
├── sunset.json
├── forest.json
├── lavender.json
├── coral.json
└── slate.json
当用户提到架构巡检、风险分析、巡检报告(或对报告修)等关键词时,必须先加载插件完整文档 {baseDir}/references/plugins/tsa-risk/SKILL.md,然后严格按照文档中的工作流执行
触发关键词:智能顾问架构巡检、风险分析、巡检报告、架构图风险、腾讯云巡检或对当前巡检分析报告内容修改时
QcloudTAGFullAccess 和 QcloudAdvisorFullAccess 策略TENCENTCLOUD_STS_DURATION 调整(最大 43200 秒)https://console.cloud.tencent.com/advisor?hideTopNav=true(有 ArchId 时追加 &archId={ArchId});其他腾讯云产品场景(CVM、Lighthouse、COS 等)目标 URL 为 https://console.cloud.tencent.com/。以 [跳转控制台](免密登录URL) 超链接形式展示,严禁直接展示完整 URL。每次都必须重新调用 login_url.py 生成新链接,不可缓存或复用本 Skill 需要以下环境变量才能正常运行:
| 环境变量 | 必填 | 说明 |
|---------|------|------|
| TENCENTCLOUD_SECRET_ID | 是 | 腾讯云 API SecretId |
| TENCENTCLOUD_SECRET_KEY | 是 | 腾讯云 API SecretKey |
密钥仅通过环境变量读取,不会被写入文件、日志或网络传输中。
本 Skill 包含以下 CAM(访问管理)操作。写入类操作仅由独立脚本 scripts/create_role.py 执行,且必须在用户明确同意后才会运行。check_env.py 仅执行只读检测操作。
| API 操作 | 类型 | 所在脚本 | 说明 |
|---------|------|---------|------|
| sts:GetCallerIdentity | 只读 | check_env.py / create_role.py | 获取当前账号 UIN |
| cam:GetRole | 只读 | check_env.py / create_role.py | 检查角色是否存在 |
| cam:DescribeRoleList | 只读 | setup_role.py | 列出可用角色供用户选择 |
| cam:CreateRole | 写入 | scripts/create_role.py | 创建 advisor 角色(需用户明确同意后执行) |
| cam:AttachRolePolicy | 写入 | scripts/create_role.py | 关联 QcloudAdvisorFullAccess 策略(随角色创建执行) |
| sts:AssumeRole | 敏感 | login_url.py | 扮演角色获取临时凭证(用于生成免密登录链接) |
| cam:DeleteRole | 写入 | scripts/cleanup.py | 删除 advisor 角色(仅 --cloud 模式,需用户明确确认) |
| advisor:CreateAdvisorAuthorization | 写入 | scripts/tcloud_api.py | 开通智能顾问服务(需用户明确同意后执行) |
~/.tencent-cloudq/config.json 仅保存角色 ARN 和账号 UIN,不保存任何密钥700,配置文件设为 600,仅当前用户可读写*.tencentcloudapi.com)和登录域名(cloud.tencent.com)用户可随时运行清理脚本删除本机上的所有配置和缓存:
# 交互式清理(逐项确认)
python3 {baseDir}/scripts/cleanup.py
# 一键清理所有本地配置
python3 {baseDir}/scripts/cleanup.py --all
# 一键清理所有本地配置 + 云端 advisor 角色
python3 {baseDir}/scripts/cleanup.py --all --cloud
清理范围:
~/.tencent-cloudq/(含 config.json){系统临时目录}/.tcloud_advisor_uin_cacheTENCENTCLOUD_* 系列(SECRET_ID、SECRET_KEY、TOKEN、ROLE_ARN、ROLE_NAME、ROLE_SESSION、STS_DURATION),脚本会自动检测已设置的变量并生成对应平台的清理命令(source 脚本 / PowerShell 脚本)advisor(仅 --cloud 模式,需配置 AK/SK)tools
Use when the user wants to connect to, test, or use the McDonalds service at mcp.mcd.cn, including checking authentication, probing MCP endpoints, listing tools, or calling McDonalds MCP tools through a reusable local CLI.
development
Web scraping platform — Twitter/X data, Vinted marketplace, and general web scraping API
development
SlowMist AI Agent Security Review — comprehensive security framework for skills, repositories, URLs, on-chain addresses, and products (Claude Code version)
data-ai
去除中文文本中的 AI 写作痕迹,使其读起来自然。基于维基百科 AI 写作特征指南,检测 24 种 AI 模式。触发词:humanizer-cn、去除 AI 痕迹、去除 AI 写作痕迹、中文文本人性化。