Agent Skills › latitude-dev/latitude-llm › temporal-developer

temporal-developer

GitHub

提供Temporal分布式工作流开发指导，涵盖Python、TypeScript和Go SDK。支持创建流程与活动、调试非确定性错误、处理超时及信号查询等场景。

.agents/skills/temporal-developer/SKILL.md latitude-dev/latitude-llm

触发场景

创建Temporal工作流或活动调试停滞的工作流或非确定性错误使用Temporal Python/TypeScript/Go SDK 解决工作流重放、心跳、续传或子工作流问题

安装

npx skills add latitude-dev/latitude-llm --skill temporal-developer -g -y

更多选项

非标准路径

npx skills add https://github.com/latitude-dev/latitude-llm/tree/development/.agents/skills/temporal-developer -g -y

不安装直接使用

npx skills use latitude-dev/latitude-llm@temporal-developer

指定 Agent (Claude Code)

npx skills add latitude-dev/latitude-llm --skill temporal-developer -a claude-code -g -y

安装 repo 全部 skill

npx skills add latitude-dev/latitude-llm --all -g -y

预览 repo 内 skill

npx skills add latitude-dev/latitude-llm --list

SKILL.md

Frontmatter

{
    "name": "temporal-developer",
    "version": "0.1.0",
    "description": "This skill should be used when the user asks to \"create a Temporal workflow\", \"write a Temporal activity\", \"debug stuck workflow\", \"fix non-determinism error\", \"Temporal Python\", \"Temporal TypeScript\", \"Temporal Go\", \"Temporal Golang\", \"workflow replay\", \"activity timeout\", \"signal workflow\", \"query workflow\", \"worker not starting\", \"activity keeps retrying\", \"Temporal heartbeat\", \"continue-as-new\", \"child workflow\", \"saga pattern\", \"workflow versioning\", \"durable execution\", \"reliable distributed systems\", or mentions Temporal SDK development."
}

Skill: temporal-developer

Overview

Temporal is a durable execution platform that makes workflows survive failures automatically. This skill provides guidance for building Temporal applications in Python, TypeScript, and Go.

Core Architecture

┌─────────────────────────────────────────────────────────────────┐
│                     Temporal Cluster                            │
│  ┌─────────────────┐  ┌─────────────────┐  ┌────────────────┐  │
│  │  Event History  │  │   Task Queues   │  │   Visibility   │  │
│  │  (Durable Log)  │  │  (Work Router)  │  │   (Search)     │  │
│  └─────────────────┘  └─────────────────┘  └────────────────┘  │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ Poll / Complete
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                         Worker                                   │
│  ┌─────────────────────────┐  ┌──────────────────────────────┐  │
│  │   Workflow Definitions  │  │   Activity Implementations   │  │
│  │   (Deterministic)       │  │   (Non-deterministic OK)     │  │
│  └─────────────────────────┘  └──────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

Components:

Workflows - Durable, deterministic functions that orchestrate activities
Activities - Non-deterministic operations (API calls, I/O) that can fail and retry
Workers - Long-running processes that poll task queues and execute code
Task Queues - Named queues connecting clients to workers

History Replay: Why Determinism Matters

Temporal achieves durability through history replay:

Initial Execution - Worker runs workflow, generates Commands, stored as Events in history
Recovery - On restart/failure, Worker re-executes workflow from beginning
Matching - SDK compares generated Commands against stored Events
Restoration - Uses stored Activity results instead of re-executing

If Commands don't match Events = Non-determinism Error = Workflow blocked

Workflow Code	Command	Event
Execute activity	`ScheduleActivityTask`	`ActivityTaskScheduled`
Sleep/timer	`StartTimer`	`TimerStarted`
Child workflow	`StartChildWorkflowExecution`	`ChildWorkflowExecutionStarted`

See references/core/determinism.md for detailed explanation.

Getting Started

Ensure Temporal CLI is installed

Check if temporal CLI is installed. If not, follow these instructions:

macOS

brew install temporal

Linux

Check your machine's architecture and download the appropriate archive:

Once you've downloaded the file, extract the downloaded archive and add the temporal binary to your PATH by copying it to a directory like /usr/local/bin

Windows

Check your machine's architecture and download the appropriate archive:

Once you've downloaded the file, extract the downloaded archive and add the temporal.exe binary to your PATH.

Read All Relevant References

First, read the getting started guide for the language you are working in:
- Python -> read references/python/python.md
- TypeScript -> read references/typescript/typescript.md
- Go -> read references/go/go.md
Second, read appropriate core and language-specific references for the task at hand.

Primary References

references/core/determinism.md - Why determinism matters, replay mechanics, basic concepts of activities
- Language-specific info at references/{your_language}/determinism.md
references/core/patterns.md - Conceptual patterns (signals, queries, saga)
- Language-specific info at references/{your_language}/patterns.md
references/core/gotchas.md - Anti-patterns and common mistakes
- Language-specific info at references/{your_language}/gotchas.md
references/core/versioning.md - Versioning strategies and concepts - how to safely change workflow code while workflows are running
- Language-specific info at references/{your_language}/versioning.md
references/core/troubleshooting.md - Decision trees, recovery procedures
references/core/error-reference.md - Common error types, workflow status reference
references/core/interactive-workflows.md - Testing signals, updates, queries
references/core/dev-management.md - Dev cycle & management of server and workers
references/core/ai-patterns.md - AI/LLM pattern concepts
- Language-specific info at references/{your_language}/ai-patterns.md, if available. Currently Python only.

Additional Topics

references/{your_language}/observability.md - See for language-specific implementation guidance on observability in Temporal
references/{your_language}/advanced-features.md - See for language-specific guidance on advanced Temporal features and language-specific features