前言¶
在云上改配置、查资源、做批量运维时，常见路径是翻文档、拼请求参数，或在控制台里点选。若希望对话式 Agent 能按你的意图直接走腾讯云 Open API，需要一套被 Agent 识别的技能说明，而不是零散的 API 备忘。下面介绍 SkillHub 上的 tcapi（@tencent-adm/tcapi）：由 Tencent CloudQ Team 发布，面向通过 Cloud API 做云自动化与资源管理的场景。
这是什么¶
tcapi 是一则基于通用 SKILL.md 格式的 Agent Skill，坐标为 @tencent-adm/tcapi，当前版本 1.0.0，来源标注为 enterprise，在 SkillHub 分类为 it-ops-security。
官方简介为：Skill to call Cloud API for Tencent Cloud（腾讯云），用于 cloud automation or resource management（云自动化或资源管理）。也就是说，它的定位是让支持 Skills 的 AI 客户端在对话中按技能指引调用腾讯云 API，而不是替代腾讯云控制台或 SDK 本身。
- 发布者：Tencent CloudQ Team
- SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/tcapi
- 技能 API 地址：https://api.skillhub.cn/tencent-adm/tcapi
核心功能¶
结合 SkillHub 与官方简介，目前可核实的能力边界如下：
- 对接腾讯云 Cloud API：技能主题即「调用腾讯云 API」，适用于自动化脚本化运维、资源查询与变更等需要走 Open API 的工作流。
- 运维与安全类场景归类：分类为
it-ops-security，与账号、资源、安全相关运维任务在同一货架，便于在 SkillHub 中检索。 - 商店元数据：页面标签包含
requires_api_key=false（指 SkillHub 侧对该技能的安装/元数据要求；实际调用腾讯云 API 仍须遵守腾讯云账号、密钥与权限规范，具体字段以技能包内 SKILL.md 及腾讯云文档为准）。
未在公开页面单独列出各产品接口清单或封装命令时，不宜臆造「已支持 CVM/CDB/…」的细项；安装后应以技能包内说明为准。
安装与启用¶
SkillHub 推荐通过 skillhub CLI 安装，并必须把技能装到当前 Agent 的 skills 目录，否则默认目录可能不会被客户端加载。
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 tcapi¶
官方页面给出的安装提示为：根据 https://skillhub.cn/install/skillhub.md，安装 @tencent-adm/tcapi。
在 CLI 已就绪的前提下，按 SkillHub 文档使用 --dir 指向当前环境的 skills 目录，例如：
skillhub search tcapi
skillhub install @tencent-adm/tcapi --dir <skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档，以你本机实际配置为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后，一般需要重启或重新加载对应 AI 客户端，使新技能被索引。Cursor、Codex CLI、Claude Code 的差异主要体现在 skills 目录路径 上，安装命令本身均为 skillhub install @tencent-adm/tcapi --dir …；未在官方资料中单独说明的差异此处不展开。
也可在对话中让 Agent 按上述 install 文档自行完成安装（SkillHub 页面提供的提示词即为此用途）。
典型用法¶
公开 SkillHub 页面未附带可复制的端到端 API 调用示例；可复现的流程如下。
- 按上一节将
@tencent-adm/tcapi安装到当前 Agent 的 skills 目录。 - 在支持 Skills 的客户端中启用该技能后，用自然语言描述云自动化或资源管理目标（例如查询某类资源、按规范变更配置等）。
- Agent 读取技能包中的 SKILL.md 指引，在合规前提下组织对腾讯云 Cloud API 的调用；具体接口名、参数与鉴权方式以技能内文档及 腾讯云 API 文档 为准。
若你需要核对技能元数据或版本，可打开 SkillHub 技能页查看 v1.0.0 与简介是否更新。
适用场景与注意¶
适合谁
- 已在腾讯云上运行资源，希望把「查资源、改配置、自动化运维」交给 Agent 编排，而不是每次手写 curl/SDK 的开发者或运维。
- 使用 Cursor、Claude Code、Codex 等已支持 SkillHub 安装路径的客户端的团队。
限制与注意
- 技能描述范围是「调用腾讯云 API」，不保证覆盖全部云产品；新产品或新接口需以技能包更新与官方 API 文档为准。
- SkillHub 统计（页面展示，随时间变化）：评分 100000，下载约 1079，安装约 2；选用前可自行在 SkillHub 查看最新数据。
requires_api_key=false仅反映 SkillHub 标签语义，不能理解为调用腾讯云无需鉴权；生产环境务必使用最小权限密钥并避免把密钥写入仓库。- 未核实到的客户端专属配置项、环境变量名不在本文列出；安装后请直接阅读技能目录下的 SKILL.md。
结尾¶
tcapi 把「在 Agent 里调用腾讯云 Cloud API」收敛为一个可安装、可版本化的 Skill（@tencent-adm/tcapi），适合云自动化与资源管理类对话任务。安装与优先源说明见 https://skillhub.cn/install/skillhub.md ，技能主页见 https://www.skillhub.cn/skills/tencent-adm/tcapi ，API 入口见 https://api.skillhub.cn/tencent-adm/tcapi 。
