temporal

此技能作为将旧版 Netflix Conductor 基于 JSON 的工作流迁移至现代、类型安全的 Temporal Python 项目的专用助理。它专为从声明式 Conductor DSL 转换为使用 Temporal Python SDK 的代码优先编排的工程师所设计。代理程序自动化了从分析 Conductor 任务原语到生成健壮、生产级项目结构（包含活动、工作流定义与启动脚本）的全生命周期。

除了迁移之外，该技能还提供了一套完整的工具来处理 Temporal 开发生命周期。它通过 temporal server start-dev 处理本地服务器编排，管理 Worker 进程生命周期，并提供对工作流执行状况的深度观察能力。用户可以直接从开发环境中监控 Worker 健康状况、检查工作流任务历史，并排查非确定性错误或卡住的活动。

• 自动化迁移管道：解析 Conductor JSON 定义以生成地道的 Temporal Python 代码，包含类型安全的活动与工作流逻辑。

• 本地服务器管理：通过确保 Temporal 服务器连接与清理工作空间的脚本来简化开发流程。

• Worker 生命周期控制：智能管理后台 Worker 进程，确保在验证周期中旧的 Worker 被终止并部署新的实例。

• 可观察性与故障排查：内置工具用于列出 Worker、追踪日志、检查工作流状态，以及解析错误历史，以区分任务卡顿与活动失败。

• 项目支架：生成包含 uv 配置、文档与标准化启动脚本的完整项目结构，以确保部署的一致性。

• 目标受众：负责迁移复杂状态微服务或工作流驱动应用程序的后端与平台工程师。

• 操作限制：需要 Python 3.11+ 与 uv 包管理工具；主要针对本地开发 (gRPC 端口 7233) 与单一迁移任务设计。

• 工作流监控：对于识别工作流任务卡顿与活动重试之间的差异至关重要；务必获取来自启动输出的 Workflow ID 以进行精确追踪。

• 清理机制：使用专用的脚本 (如 kill-worker.sh) 来防止在管理多个本地 Worker 进程时产生资源泄漏。

• 整合：主要作为 Claude Code 环境中的插件运行，协助在迁移过程中进行迭代重构与自动化错误修复。