SuperAPI AI 工具集

temporal-developer

测试与质量

查看项目

更新于 10-15 23:49

技能介绍

用途:该技能用于指导构建 Temporal 应用,Temporal 是让工作流自动在故障后继续存活的持久执行平台,支持 Python、TypeScript 与 Go。

核心概念:Workflow(工作流)为持久、确定性的函数,用于编排 Activity(活动);Activity 为非确定性操作(如 API 调用、I/O),可失败并重试;Worker 是轮询任务队列并执行代码的长驻进程;Task Queue 是连接客户端与 Worker 的命名队列。持久性通过历史重放实现:首次执行时 Worker 运行工作流、生成 Command 并作为 Event 存入历史;恢复时从头重放,SDK 比对 Command 与已存 Event,并用已存 Activity 结果替代重复执行。若 Command 与 Event 不匹配即非确定性错误,工作流被阻塞。

使用方式:先确保已安装 Temporal CLI,如未安装可 brew install temporal(macOS),或按机器架构下载对应归档并解压,将 temporal 二进制加入 PATH(如 /usr/local/bin)。然后阅读所用语言的入门指南:Python 读 references/python/python.md,TypeScript 读 references/typescript/typescript.md,Go 读 references/go/go.md。再按任务阅读核心与语言相关参考。

主要参考:determinism.md 讲确定性与重放机制;patterns.md 讲信号、查询、saga 等概念模式;gotchas.md 收录反模式与常见错误;versioning.md 讲运行中安全修改工作流代码的版本策略;troubleshooting.md 提供决策树与恢复流程;error-reference.md 收录常见错误类型与工作流状态;interactive-workflows.md 供测试信号、更新与查询;dev-management.md 讲开发周期及服务器与 Worker 管理;ai-patterns.md 讲 AI/LLM 模式(目前仅 Python 有)。另可按语言查阅 observability.md 与 advanced-features.md。

适用场景与限制:适用于创建、编写、调试 Temporal 工作流与活动及排查非确定性错误。具体收费、价格、完整 API 与平台细节,资料暂未提供。