用途
Temporal Cloud 技能用于帮助用户诊断和解决 Temporal Cloud 的连接、认证与配置问题，主要借助 tcld 和 temporal CLI 完成排查。它针对的是 Cloud 问题常处于配置、网络、认证与 Temporal 代码交叉点的特点，提供系统化诊断以快速定位根因并给出修复方案。
主要能力
技能将问题分为若干类别，并给出对应的首要检查项：
- tcld 登录：登录失败、令牌刷新失败、账号错误，首先检查
tcld account get。 - 连接/认证：无法连接、访问被拒、握手失败，首先检查端点格式、DNS 与端口连通性。
- 模糊的运行时错误：如 context deadline exceeded、workflow is busy，先识别操作与所在层级。
- mTLS/证书：x509 错误、未知颁发机构、证书过期，首先检查
openssl x509 -enddate。 - 命名空间：namespace not found、SNI 不匹配，首先检查命名空间名称格式。
- HA/故障转移：故障转移不工作、区域错误、DNS 陈旧，首先检查 DNS CNAME 解析。
- Worker：任务未被拾取、连接陈旧，首先检查
temporal task-queue describe。 - 私有连接：PrivateLink/PSC 错误，首先检查 VPC 端点状态。
- 限流：RESOURCE_EXHAUSTED，首先检查 APS 限制。
使用方式
技能按以下流程推进：
- 识别类别：向用户询问确切的错误信息、正在尝试的操作、最近发生的变更。
- 收集上下文：根据问题类型询问认证方式（API key 或 mTLS）、SDK 及版本、确切的 HostPort/地址、命名空间、使用的是 SDK 代码、temporal CLI 还是 tcld 等。
- 应用决策树：按类别使用对应的决策树。
- 提供修复：给出具体命令与验证步骤，并始终附带置信度评分（9-10 表示症状、操作与确认信号清晰吻合；6-8 表示证据良好但存在一个合理替代；1-5 表示问题仍模糊，所谓“修复”实际是下一步鉴别性检查）。若问题模糊，会明确说明并将建议限定为下一步检查，而非把推测性根因当作定论。
技能还包含 SDK 片段审查，按顺序验证认证方式、地址/HostPort、命名空间、TLS 配置与环境配置，优先修正配置本身，再考虑底层网络排查。
适用场景
适用于 Temporal Cloud 的连接、认证、证书、命名空间、HA 故障转移、私有连接与限流等问题的诊断与修复。技能明确说明其范围不包括 Worker 性能调优、扩缩容、指标解读、SDK 特定配置与部署模式，这些由其他面向 Worker 的技能覆盖。对于“Worker 未拾取任务”，技能会先诊断，若确认不是 Cloud 问题则移交。
限制
- 不覆盖 Worker 性能调优、扩缩容、指标解读、SDK 特定配置、部署模式。
- 使用 Flexible Auth（预发布）的命名空间目前无法使用 Namespace Endpoint。
- GCP 多区域命名空间暂不支持私有连接。
- sa-east-1 区域不适用于多区域命名空间。
- 部分具体命令、错误码与场景步骤需参考技能内的 references 文档（cloud-troubleshooting-reference.md、common-scenarios.md）。