skill-temporal-cloud
排查Temporal Cloud连接、认证与配置问题的专用技能
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：skill-temporal-cloud。 它的用途是：排查Temporal Cloud连接、认证与配置问题的专用技能 完整的 Skill 内容见：https://321skill.com/skills/skill-temporal-cloud/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
当你在配置Temporal SDK连接Cloud遇到‘namespace not found’错误时，可以
对AI说：‘我用了API Key连接Temporal Cloud，但SDK报错说命名空间找不到，我的端点是xxx.tmprl.cloud:7233，命名空间是abc.prod。’ 技能会引导你检查命名空间名称格式是否正确（如是否包含账户标识）、端点地址是否匹配命名空间所属区域，并建议你使用`tcld`命令行工具验证命名空间的可访问性。
介绍
这是一个专门用于诊断和解决Temporal Cloud连接、认证与配置问题的AI技能。它针对开发者在连接Temporal云服务时遇到的各种“拦路虎”，如登录失败、连接超时、x509/TLS证书错误、命名空间不匹配、SDK连接代码片段错误、端点选择困惑、“无轮询器”警告、资源耗尽（RESOURCE_EXHAUSTED）以及私有连接（PrivateLink/PSC）设置等问题。
该技能通过系统化的诊断流程来工作。它会引导用户提供关键信息（如精确的错误消息、使用的SDK版本、认证方式、端点地址等），然后根据预设的分类（如tcld登录、连接认证、mTLS证书、命名空间、高可用性故障转移等）快速定位问题根源，并提供具体的修复步骤和命令参考。
它主要面向使用Temporal Cloud的开发者、DevOps工程师和SRE。当他们在集成SDK、部署应用、配置新命名空间或进行高可用性切换时遇到连接层面的障碍，这个技能能提供即时的、结构化的排查指导。
与那些专注于Temporal工作流开发、性能调优或部署模式的技能不同，此技能的核心定位是“连接层专家”。它不深入业务逻辑或Worker内部性能，而是聚焦于确保应用能够成功、稳定地“握手”并访问Temporal Cloud服务，解决了从本地环境到云端服务这一关键环节的复杂配置难题。
核心特点
本技能专注于Temporal生态中“连接层”的专项问题排查，提供了从tcld工具登录、SDK端点配置到mTLS证书验证、高可用性DNS解析等一整套结构化的诊断流程，而非泛泛的Temporal使用指导。它与专注于工作流性能调优或Worker伸缩的技能形成明确互补，是解决“连不上、认不了、配不对”等前置问题的利器。
注意事项
不适用于Worker内部性能调优、工作流代码逻辑优化、系统伸缩策略或SDK特定高级配置等场景。
常见问题
连接Temporal Cloud时报x509证书错误怎么办？
检查mTLS证书是否过期，使用`openssl x509 -enddate`命令验证，并确保SDK配置中使用了正确的证书链和私钥。
tcld登录失败或显示错误账户如何解决？
首先运行`tcld account get`确认当前账户，检查令牌是否有效或需要刷新，并确认是否配置了多个Temporal账户导致冲突。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/skill-temporal-cloud/raw/index.md 读取 skill-temporal-cloud 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/skill-temporal-cloud/raw/index.md（查看排版版本）