前言¶
在 Cursor、Claude Code 等环境里做运维或建站时，常见做法是自己在终端拼 tccli 命令，或把控制台截图交给模型猜下一步。腾讯云产品多、接口分散，Lighthouse、CVM、COS、VPC、DNSPod 等往往要切换不同子命令。下面介绍 SkillHub 上的 Tencent Cloud Infra（@tencent-adm/tencentcloud-infra）：把基于 tccli 的云资源操作收敛成 Agent 可调用的 Skill，用自然语言描述场景，由 Skill 引导完成查看、管理与巡检类任务。
这是什么¶
Tencent Cloud Infra 是腾讯云侧发布的全产品统一管理 Skill，坐标 @tencent-adm/tencentcloud-infra，当前版本 v1.0.12，来源标注为 enterprise，发布者为 Tencent Cloud Infra（SkillHub 页面显示已认证作者）。SkillHub 分类为 it-ops-security（IT 运维与安全）。
官方简介：基于 tccli 覆盖 Lighthouse、CVM、CBS、COS、VPC、DNSPod、SSL、CAM、Monitor、TAT、Domain、CloudAudit 等 12+ 产品；支持资源查看与管理、安全巡检、应用部署、建站、证书检查、账号切换等场景。页面标签还包含监控告警、服务器运维、配置生成等方向。Skill 元数据标记 requires_api_key=true，使用前需配置腾讯云 API 凭证。
核心功能¶
以下能力均来自官方简介与 SkillHub 页面描述，底层依赖 tccli 对接各产品线 API。
- 资源查看与管理：跨 Lighthouse、CVM、CBS、COS、VPC 等统一入口，减少在控制台与多条 CLI 子命令之间切换。
- 安全与合规相关：安全巡检；CAM、CloudAudit 等产品在覆盖范围内，适合账号权限与审计类查询（具体子能力以 Skill 内 SKILL.md 为准）。
- 应用与站点：应用部署、建站；DNSPod、Domain、SSL 等可用于域名、证书相关检查与配置协助。
- 运维与监控：Monitor、TAT（自动化助手）等产品纳入同一 Skill，便于告警、实例运维类对话式操作。
- 账号切换：支持多账号或凭证切换场景（需按 Skill 要求正确配置密钥）。
SkillHub 页面显示科恩实验室、云鼎实验室对该 Skill 的安全评估为「安全，无风险」，并附有查看报告入口；这不替代你在生产环境前的权限最小化与变更审批流程。
安装与启用¶
通过 SkillHub CLI 安装¶
先确认本机是否已有 skillhub（完整步骤见 SkillHub 安装文档）：
command -v skillhub && skillhub --version
未安装时可执行官方一键脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别：
skillhub install @tencent-adm/tencentcloud-infra --dir <你的 Agent skills 目录>
常用目录示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按你所用客户端要求重启或刷新 Agent，使 Skill 被加载。
通过提示词让 AI 安装¶
SkillHub 页面提供的标准提示为：让 AI 根据安装文档安装本 Skill。可将下面一句发给 Agent：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/tencentcloud-infra`。
页面还支持下载 Zip 包安装、安装到本地 Agent、WorkBuddy 等入口；若你使用非 CLI 路径，以 SkillHub 当前页面选项为准。
API Key 与 tccli¶
Skill 标记 需配置 API Key。实际调用链依赖 tccli 与腾讯云 API 密钥（SecretId、SecretKey 等），请按 Skill 包内说明与腾讯云 CAM 最佳实践配置，勿把密钥写入仓库或对话日志。账号切换类能力同样建立在正确、受控的凭证配置之上。
典型用法¶
官方未在公开摘要中给出逐条 shell 示例；典型用法是按场景用自然语言驱动 Agent，由 Skill 组织 tccli 或等价调用。可与简介中的场景对应，例如：
- 查资源：说明要查看的产品（如某地域 CVM、COS 桶、VPC），让 Agent 通过 Skill 拉取列表或详情。
- 安全巡检 / 证书检查：描述巡检范围或域名、证书到期关注点，由 Skill 引导查询 SSL、CAM、Monitor 等相关接口。
- 建站与部署：说明 Lighthouse 或 CVM 上的部署目标，结合 DNSPod、Domain、SSL 完成域名与证书相关步骤（变更前建议人工确认）。
- 账号切换：在已配置多套凭证的前提下，明确要操作的账号或环境，再发起资源类指令。
复现路径：安装 Skill → 配置 API 凭证 → 在支持 Skills 的客户端中选中或自动加载 @tencent-adm/tencentcloud-infra → 用上述场景描述发起对话。更细的命令模板与参数约束以安装包内的 SKILL.md 为准。
适用场景与注意¶
适合谁：需要在 AI 编程/运维助手内操作腾讯云、又不想每次手写 tccli 的开发者与运维；SkillHub 分类为 IT 运维与安全，与监控、服务器运维、配置生成等标签一致。
使用注意：
- 必须配置 API Key；权限过大时，Agent 误操作风险与人工在终端执行相当，建议 CAM 策略按最小权限授予。
- 覆盖 12+ 产品不等于每个控制台功能都有封装，边界以 Skill 版本 v1.0.12 内文档为准。
- SkillHub 统计（以 API 元数据为准）：评分 100000，下载 7030，安装 42；页面展示约 7.0 千次下载，与元数据量级一致。安装量较小时，可参考页面版本历史与评论后再上生产。
结尾¶
Tencent Cloud Infra 把腾讯云多产品线操作收拢到 Agent Skill，核心依赖 tccli，适合资源管理、巡检、建站与证书检查等对话式运维。安装与目录配置遵循 SkillHub 安装文档，包坐标 @tencent-adm/tencentcloud-infra。
- SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/tencentcloud-infra
- API 元数据：https://api.skillhub.cn/tencent-adm/tencentcloud-infra
