TencentDB PostgreSQL Skill

Bundle entry for TencentDB PostgreSQL skills. These skills call Tencent Cloud PostgreSQL OpenAPI directly and can use the full 48 aligned actions documented by each child skill under references/. Explicit confirmation is required before any write, fee-impacting, or high-risk action.

简介

TencentDB PostgreSQL Skill 是面向腾讯云数据库 PostgreSQL 的任务型技能包入口，统一覆盖 PG 巡检、慢 SQL 诊断 和 运维排障 三类高频场景。它直接调用腾讯云 PostgreSQL OpenAPI，不依赖已部署的 MCP Server，并且严格限制在当前仓库已经完成参数对齐的 48 个 Action 范围内执行。

这个总入口适合用来快速理解整个技能包能做什么、如何使用，以及应该进入哪个子 skill；如果你已经知道自己的问题类型，可以直接进入 references/ 下对应子目录继续查看更细的执行说明。

适用场景

• 需要做 PostgreSQL 日常巡检、发布后回归或健康检查。
• 需要定位 慢 SQL、性能抖动、查询变慢 等问题。
• 需要处理 连接失败、备份异常、账号权限、网络 / SSL、只读链路 等运维问题。
• 希望由 AI 基于证据先做分析，再在必要时进入对齐后的 OpenAPI 处置动作。

包含的技能

Skill 目录	能力名称	适合处理的问题	典型请求	输出结果	入口
tencent-pg-inspection	PG 巡检	日常健康检查、备份检查、资源与配置巡检	PG巡检、健康检查、备份检查、资源水位检查	健康状态、风险项、重点关注项、建议动作	references/tencent-pg-inspection/SKILL.md
tencent-pg-slowquery-diagnosis	慢 SQL 诊断	慢 SQL 分析、延迟波动、性能退化定位	慢SQL分析、SQL性能诊断、查询为什么变慢	慢 SQL 排名、原因分析、风险提示、优化建议	references/tencent-pg-slowquery-diagnosis/SKILL.md
tencent-pg-ops-troubleshooter	运维排障	连接异常、备份失败、SSL 问题、实例异常排查	PG排障、实例异常排查、SSL问题、备份失败	问题线索、阻塞点、下一步动作、需确认的高风险操作	references/tencent-pg-ops-troubleshooter/SKILL.md

使用前准备

推荐用户优先准备以下运行时环境变量：

• TENCENTCLOUD_SECRET_ID
• TENCENTCLOUD_SECRET_KEY
• TENCENTCLOUD_REGION
• 可选：临时凭证场景补充 TENCENTCLOUD_SESSION_TOKEN

补充说明：

• 兼容读取 MCP_REQUEST_SECRET_ID、MCP_REQUEST_SECRET_KEY、MCP_REQUEST_SESSION_TOKEN、MCP_SECRET_ID、MCP_SECRET_KEY。
• 地域既可以直接写 ap-guangzhou，也可以先写 广州、上海、成都、北京 等常见别名，执行前应先归一化为标准地域码。
• 建议先通过腾讯云 API 密钥管理控制台 检查可用凭证，通过 地域与域名说明 确认目标实例所在地域。
• 优先使用官方 SDK；如果 SDK 不可用，不应把它当成首次使用的硬阻塞，而应退回到本地生成 TC3 签名 HTTPS 请求。
• 密钥只应存在于运行时环境或安全上下文中，不要写入代码、仓库文件、URL 或查询参数。

使用方法

1. 确认目标范围：至少准备好地域和实例 ID；如果还不知道实例 ID，可先进入控制台 https://console.cloud.tencent.com/postgres 查询。
2. 选择匹配的子 skill：巡检类问题进入 tencent-pg-inspection，性能类问题进入 tencent-pg-slowquery-diagnosis，故障排查类问题进入 tencent-pg-ops-troubleshooter。
3. 发起请求：建议在请求里明确地域、实例 ID、问题类型，以及可选的时间范围。
4. 查看结果：先阅读结论和证据摘要，再决定是否需要执行后续动作。

推荐输入格式示例：

text

ap-guangzhou postgres-abc12345

请做一次 PG 巡检
请分析最近 1 小时慢 SQL
请排查这个实例为什么 SSL 连接异常

结果说明

执行完成后，通常会得到以下几类输出：

• 结论概览：当前实例或问题的整体状态判断。
• 证据摘要：来自 OpenAPI 的关键证据，例如实例状态、备份、慢 SQL、错误日志、网络或 SSL 信息。
• 风险与原因：风险项、疑似原因排序或阻塞点说明。
• 建议动作：安全下一步、建议复核项，以及需要明确确认后才能执行的处置动作。

安全与边界

• 默认应以 只读证据采集 为先，不直接执行会影响实例状态的动作。
• 任何 写类、费用类或高风险动作 都必须先说明影响面并获得明确确认。
• 只允许使用当前仓库中已完成参数对齐的 48 个 PostgreSQL OpenAPI Action；未对齐的动作不应调用。
• 不应混用不同地域、不同实例或未经确认的目标范围。

使用限制与确认机制

为确保分析结果准确且操作安全，使用该 skill 时默认遵循以下约束：

• 先确认目标范围：建议在请求中提供地域与实例 ID；如果信息不足，skill 会先提示补充必要信息，再继续分析。
• 自动匹配对应能力：系统会根据你的问题类型自动选择巡检、慢 SQL 诊断或运维排障能力，并进入对应说明继续执行。
• 默认先做只读分析：会优先采集实例状态、备份、慢 SQL、错误日志、网络或 SSL 等证据，再给出结论与建议。
• 高风险动作必须确认：涉及写类、费用类或可能影响实例状态的动作时，会先说明影响面、目标实例与预期结果，获得明确确认后才继续。
• 仅在支持范围内调用：只会使用当前已完成参数对齐的 48 个 PostgreSQL OpenAPI Action；如果凭证缺失、地域不合法或能力未开放，会先提示修正方式。

目录与扩展说明

• 根目录入口：SKILL.md
• 根目录元数据：_meta.json
• 公共规则目录：references/common/
• 子技能目录：references/<skill-name>/
• 子技能入口：references/<skill-name>/SKILL.md
• 公共规则文档：@references/common/region_normalization.md、@references/common/error_handling.md

附录：当前开放的 48 个对齐 Action

1. 实例管理（15）

Action	说明	执行要求
DescribeDBInstances	查询实例列表	直接可用
DescribeDBInstanceAttribute	查询实例详情	直接可用
CreateInstances	创建实例	费用确认
ModifyDBInstanceName	修改实例名称	明确确认
ModifyDBInstanceSpec	变更实例规格	费用确认
RestartDBInstance	重启实例	明确确认
IsolateDBInstances	隔离实例	明确确认
DisIsolateDBInstances	解除隔离实例	明确确认
UpgradeDBInstanceKernelVersion	升级实例内核版本号	明确确认
DescribeTasks	查询异步任务状态	直接可用
DescribeClasses	查询可用规格列表	直接可用
DescribeDBVersions	查询可用数据库版本	直接可用
DescribeRegions	查询售卖地域	直接可用
DescribeZones	查询售卖可用区	直接可用
DescribeProductConfig	查询售卖规格配置	直接可用

2. 账号管理（6）

Action	说明	执行要求
DescribeAccounts	查询实例的数据库账号列表	直接可用
DescribeAccountPrivileges	查询数据库账号的权限信息	直接可用
CreateAccount	创建数据库账号	明确确认
DeleteAccount	删除数据库账号	明确确认
ModifyAccountPrivileges	修改账号权限	明确确认
ResetAccountPassword	重置账号密码	明确确认

3. 数据库管理（4）

Action	说明	执行要求
DescribeDatabases	查询实例的数据库列表	直接可用
DescribeDatabaseObjects	查询数据库对象列表	直接可用
CreateDatabase	创建数据库	明确确认
ModifyDatabaseOwner	修改数据库属主	明确确认

4. 参数管理（5）

Action	说明	执行要求
DescribeDBInstanceParameters	查询实例参数	直接可用
DescribeParameterTemplates	查询参数模板列表	直接可用
DescribeParameterTemplateAttributes	查询参数模板详情	直接可用
DescribeParamsEvent	查询参数修改事件	直接可用
ModifyDBInstanceParameters	修改实例参数	Critical，明确确认

5. 备份与恢复（8）

Action	说明	执行要求
DescribeBackupOverview	查询备份概览	直接可用
DescribeBaseBackups	查询基础备份列表	直接可用
DescribeLogBackups	查询日志备份列表	直接可用
DescribeAvailableRecoveryTime	查询可恢复时间范围	直接可用
DescribeCloneDBInstanceSpec	查询克隆实例可购买的规格	直接可用
DescribeBackupDownloadURL	获取备份下载链接	明确确认
CreateBaseBackup	创建基础备份	明确确认
CloneDBInstance	克隆实例	费用确认

6. 监控诊断（3）

Action	说明	执行要求
DescribeSlowQueryList	查询慢查询列表	直接可用
DescribeSlowQueryAnalysis	慢查询分析	直接可用
DescribeDBErrlogs	查询错误日志	直接可用

7. 网络管理（4）

Action	说明	执行要求
OpenDBExtranetAccess	开启实例公网访问	明确确认
CloseDBExtranetAccess	关闭实例公网访问	明确确认
DescribeDBInstanceSecurityGroups	查询实例安全组	直接可用
ModifyDBInstanceSecurityGroups	修改实例安全组	明确确认

8. SSL 配置（1）

Action	说明	执行要求
DescribeDBInstanceSSLConfig	查询实例 SSL 配置	直接可用

9. 只读实例（2）

Action	说明	执行要求
DescribeReadOnlyGroups	查询只读组列表	直接可用
CreateReadOnlyDBInstance	创建只读实例	费用确认

说明：

• 直接可用：查询类动作，可直接用于证据采集与诊断。
• 明确确认：执行前必须先说明影响面、目标实例与预期结果，并获得用户明确确认。
• 费用确认：除明确确认外，还需要提前提示可能产生资源或计费变化。