LeoYeAI/agent-master-skills / skills/arch-sla-cloudq
cloudq-sre
Unverified腾讯云智能顾问助手 — 通过 AK/SK 鉴权调用腾讯云智能顾问 API,管理云架构图(查询目录、获取架构列表和详情、获取架构评估结果)及风险评估(查询评估项、按产品/分组/风险等级筛选),支持开通智能顾问服务。当用户要求查看云架构、查询架构目录、获取架构详情、查看架构评估结果、查看风险评估项、巡检项、云资源风险、开通智能顾问等相关操作时使用。
references/api/DescribeArch.md
View on GitHub# DescribeArch — 获取云架构详情
获取指定云架构图的详细信息,包括名称、SVG 数据、节点列表、绑定资源等。
## 参数
| 参数 | 必选 | 类型 | 描述 |
|------|------|------|------|
| ArchId | 是 | String | 云架构 ID,如 `arch-jcxtbe9t` |
| Username | 是 | String | 用户名,用于记录最近访问 |
| VersionId | 否 | Integer | 版本 ID,不传默认获取最新版 |
| SvgType | 否 | String | SVG 类型,默认 `3D`,可指定为 `2D` |
| WithoutDetail | 否 | Boolean | 是否不返回 detail 数据,默认 `false` |
## 调用示例
```bash
python3 {baseDir}/scripts/tcloud_api.py \
advisor \
advisor.tencentcloudapi.com \
DescribeArch \
2020-07-21 \
'{"ArchId":"arch-jcxtbe9t","Username":"user1"}'
```
## 返回示例
```json
{
"success": true,
"action": "DescribeArch",
"data": {
"Arch": {
"ArchId": "arch-jcxtbe9t",
"ArchName": "架构图1",
"FolderId": 123,
"CreateTime": "2023-11-14 10:29:04",
"VersionName": "版本1",
"VersionId": 76,
"NodeList": [
{
"DiagramId": "ddd",
"NodeName": "CVM节点",
"ProductType": "CVM",
"ResourceList": [
{"InstanceId": "ins-j7uxx5im", "Attributes": "aaa"}
]
}
]
}
},
"requestId": "b90a5cc7-..."
}
```
## 免密登录链接规则
返回结果包含架构图时,**必须**调用免密登录脚本为该架构图生成控制台直达链接(见 SKILL.md 第五章),架构图页面 URL 格式为:
`https://console.cloud.tencent.com/advisor?archId={ArchId}`
生成链接后,以 Markdown 超链接形式展示给用户:`[跳转控制台](免密登录URL)`,不要直接展示完整 URL。
> **⚠️ 注意**:免密登录链接**每次都必须重新生成**,不可缓存或复用之前生成的链接。每次向用户展示架构图信息时,都必须重新调用 `login_url.py` 生成新的链接。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |