SuperAPI AI 工具集

temporal-ops

部署与运维

查看项目

更新于 10-16 05:42

技能介绍

用途:该技能面向运行中的 Temporal 环境,负责管理与诊断,而不是编写工作流或 Activity 代码。它有两种模式:操作模式(执行创建命名空间、轮换密钥、查看容量、查找不健康工作流、批量取消、配置导出等任务并解释输出)和诊断模式(根据症状如工作流卡住、证书错误、连接超时、非确定性 panic,按自底向上的分层排查定位根因并给出置信度评分)。

主要能力:覆盖 Temporal Cloud 与自托管两类后端。Cloud 侧使用 tcld,自托管侧使用 temporal operator,数据面操作(temporal workflow、temporal batch 等)对两者通用。参考主题包括云命名空间管理、容量与限流、IAM 与 API 密钥、mTLS 证书、连接性、计费、审计日志、Terraform、通知、SAML/SCIM、迁移及自托管管理;诊断涵盖连接、证书、认证、限流、Worker 健康、工作流卡住、非确定性、重放、HA 故障转移、运行时错误、负载大小限制、性能瓶颈与调度遗漏等。

使用方式:先确定意图与后端(Cloud 用 tcld,自托管用 temporal operator),后端不明确时应先询问而非默认;再执行命令并解释输出;变更操作后需复查状态确认符合预期。诊断时先要求用户提供完整准确的错误文本,确认执行的命令、所处环境与近期变更,再沿分层阶梯(DNS/网络、TCP/端口、TLS、认证、gRPC 与前端可达性、命名空间与任务队列与 Worker、工作流代码)自底向上逐层验证,并对每个诊断给出 1-10 的置信度。

限制:不编写工作流、Activity 或 SDK 代码;不提供完整 CLI 参数表(可运行 temporal <cmd> --help);不涉及 Worker 性能调优与容量规划;不涵盖 Helm、Kubernetes、数据库管理与监控栈配置。破坏性操作(不可逆、撤销活跃身份访问、迁移生产流量、对全部匹配项扇出)须先收集证据并提出方案,明确目标与命名空间并经用户确认后才执行;对任何 --query 形式应先运行 temporal workflow count --query '<query>' 获取影响范围,批准的批量操作使用 --yes,且审批仅覆盖单条命令与单一目标。若症状不在映射表中,从 diagnostic-ladder.md 起按最后已知健康层向上排查。