用途:该技能用于构建 Temporal 应用,适用于用户要求创建 Temporal 工作流、编写 Temporal 活动、调试卡住的工作流或修复非确定性错误等场景。
主要能力:介绍 Temporal 集群的三大子系统(事件历史、任务队列、可见性存储)及三种运行方式(本地开发服务器、自托管、Temporal Cloud),说明 Worker 通过轮询/完成循环与集群通信,分别承载确定性的工作流定义与非确定性的活动实现。核心讲解历史重放机制及其对确定性的要求,并给出信号、查询、Saga 等模式,版本化策略,反模式与常见错误,故障排查决策树与恢复流程,以及开发周期与服务器/Worker 管理。
使用方式:先阅读所用语言的入门指南(TypeScript 对应 references/typescript/typescript.md),再按任务读取确定性与模式、版本化、排障、错误参考、交互式工作流、开发管理等参考文档。本地可用 temporal server start-dev 启动开发服务器,或用 docker-compose up -d temporal temporal-ui 启动服务与 UI(UI 地址 http://localhost:8080)。工作流与活动位于 NestJS 应用内,目录结构包含 src/workflows、temporal.config.ts 及 activities 模块,需在 main.ts 导出活动并在 app.module.ts 注册。
适用场景与限制:适合在 TypeScript/NestJS 单仓中开发、调试和维护 Temporal 工作流。工作流代码必须保持确定性,不得直接执行 I/O、随机数或依赖时间的操作,副作用应放入活动;应为活动设置 startToCloseTimeout,并通过版本化安全变更运行中的工作流。开发服务器仅用于开发和测试,不可用于生产;生产需自托管或使用 Temporal Cloud。其余语言、收费与具体平台细节资料暂未提供。