temporal-lang
Develop, debug, and manage Temporal applications across Python, TypeScript, Go, Java, .NET and Ruby. Use when the user is building workflows, activities, or workers with a Temporal SDK, debugging issues like non-determinism errors, stuck workflows, or activity retries, using Temporal CLI, Temporal Server, or Temporal Cloud, or working with durable execution concepts like signals, queries, heartbeats, versioning, continue-as-new, child workflows, or saga patterns.
- License 许可
- MIT
- 所属仓库
- kalaverin/skills
- 最近更新
- 2026-11-15
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- temporal-lang
- runtime
- true
- version
- 0.5.0
- triggers
- { "request": "temporal, temporalio, temporal workflow, temporal activity, durable execution, temporal cloud, temporal cli, temporal server, continue-as-new" }
- description
- Develop, debug, and manage Temporal applications across Python, TypeScript, Go, Java, .NET and Ruby. Use when the user is building workflows, activities, or workers with a Temporal SDK, debugging issues like non-determinism errors, stuck workflows, or activity retries, using Temporal CLI, Temporal Server, or Temporal Cloud, or working with durable execution concepts like signals, queries, heartbeats, versioning, continue-as-new, child workflows, or saga patterns.
02 资源文件 89
- 许可证LICENSE1.1 KB
- 参考文档README.md3.3 KB
- 参考文档references/core/ai-patterns.md5.5 KB
- 参考文档references/core/determinism.md6.1 KB
- 参考文档references/core/dev-management.md1008 B
- 参考文档references/core/error-reference.md3.0 KB
- 参考文档references/core/gotchas.md7.9 KB
- 参考文档references/core/install_cli.md866 B
- 参考文档references/core/interactive-workflows.md1.3 KB
- 参考文档references/core/patterns.md14.7 KB
- 参考文档references/core/priority-fairness.md10.2 KB
- 参考文档references/core/troubleshooting.md9.2 KB
- 参考文档references/core/versioning.md5.1 KB
- 参考文档references/dotnet/advanced-features.md6.6 KB
- 参考文档references/dotnet/data-handling.md5.7 KB
- 参考文档references/dotnet/determinism-protection.md2.7 KB
- 参考文档references/dotnet/determinism.md2.6 KB
- 参考文档references/dotnet/dotnet.md7.7 KB
- 参考文档references/dotnet/error-handling.md4.5 KB
- 参考文档references/dotnet/gotchas.md7.3 KB
- 参考文档references/dotnet/observability.md3.1 KB
- 参考文档references/dotnet/patterns.md13.9 KB
- 参考文档references/dotnet/testing.md5.7 KB
- 参考文档references/dotnet/versioning.md9.0 KB
- 参考文档references/go/advanced-features.md6.1 KB
- 参考文档references/go/data-handling.md7.6 KB
- 参考文档references/go/determinism-protection.md3.3 KB
- 参考文档references/go/determinism.md3.0 KB
- 参考文档references/go/error-handling.md5.6 KB
- 参考文档references/go/go.md7.2 KB
- 参考文档references/go/gotchas.md7.4 KB
- 参考文档references/go/observability.md5.4 KB
- 参考文档references/go/patterns.md15.7 KB
- 参考文档references/go/testing.md6.4 KB
- 参考文档references/go/versioning.md7.3 KB
- 参考文档references/integrations.md2.9 KB
- 参考文档references/java/advanced-features.md6.5 KB
- 参考文档references/java/data-handling.md8.8 KB
- 参考文档references/java/determinism-protection.md3.4 KB
- 参考文档references/java/determinism.md3.4 KB
- 参考文档references/java/error-handling.md6.1 KB
- 参考文档references/java/gotchas.md5.4 KB
- 参考文档references/java/integrations/spring-ai.md12.7 KB
- 参考文档references/java/integrations/spring-boot.md10.0 KB
- 参考文档references/java/java.md9.1 KB
- 参考文档references/java/observability.md4.1 KB
- 参考文档references/java/patterns.md14.7 KB
- 参考文档references/java/testing.md7.8 KB
- 参考文档references/java/versioning.md8.6 KB
- 参考文档references/python/advanced-features.md5.6 KB
- 参考文档references/python/ai-patterns.md10.3 KB
- 参考文档references/python/data-handling.md6.2 KB
- 参考文档references/python/determinism-protection.md6.9 KB
- 参考文档references/python/determinism.md2.0 KB
- 参考文档references/python/error-handling.md4.1 KB
- 参考文档references/python/gotchas.md7.3 KB
- 参考文档references/python/integrations/google-adk.md10.5 KB
- 参考文档references/python/integrations/langgraph.md8.2 KB
- 参考文档references/python/integrations/langsmith.md9.3 KB
- 参考文档references/python/integrations/openai-agents-sdk.md20.1 KB
- 参考文档references/python/observability.md2.8 KB
- 参考文档references/python/patterns.md12.1 KB
- 参考文档references/python/python.md7.5 KB
- 参考文档references/python/sync-vs-async.md7.1 KB
- 参考文档references/python/testing.md4.9 KB
- 参考文档references/python/versioning.md9.8 KB
- 参考文档references/python/workflow-streams.md21.4 KB
- 参考文档references/ruby/advanced-features.md7.8 KB
- 参考文档references/ruby/data-handling.md3.9 KB
- 参考文档references/ruby/determinism-protection.md5.1 KB
- 参考文档references/ruby/determinism.md2.9 KB
- 参考文档references/ruby/error-handling.md2.7 KB
- 参考文档references/ruby/gotchas.md6.9 KB
- 参考文档references/ruby/observability.md2.2 KB
- 参考文档references/ruby/patterns.md10.2 KB
- 参考文档references/ruby/ruby.md5.8 KB
- 参考文档references/ruby/testing.md6.5 KB
- 参考文档references/ruby/versioning.md8.8 KB
- 参考文档references/typescript/advanced-features.md4.0 KB
- 参考文档references/typescript/data-handling.md5.9 KB
- 参考文档references/typescript/determinism-protection.md2.4 KB
- 参考文档references/typescript/determinism.md2.1 KB
- 参考文档references/typescript/error-handling.md3.3 KB
- 参考文档references/typescript/gotchas.md9.1 KB
- 参考文档references/typescript/observability.md3.2 KB
- 参考文档references/typescript/patterns.md11.4 KB
- 参考文档references/typescript/testing.md6.1 KB
- 参考文档references/typescript/typescript.md6.4 KB
- 参考文档references/typescript/versioning.md7.0 KB
03 SKILL.md 正文
Skill: temporal-lang
Overview
Temporal is a durable execution platform that makes workflows survive failures automatically. This skill provides guidance for building Temporal applications in Python, TypeScript, Go, Java, .NET, and Ruby.
Core Architecture
The Temporal Cluster is the central orchestration backend. It maintains three key subsystems: the Event History (a durable log of all workflow state), Task Queues (which route work to the right workers), and a Visibility store (for searching and listing workflows). There are three ways to run a Cluster:
- Temporal CLI dev server — a local, single-process server started with
temporal server start-dev. Suitable for development and testing only, not production. - Self-hosted — you deploy and manage the Temporal server and its dependencies (e.g., database) in your own infrastructure for production use.
- Temporal Cloud — a fully managed production service operated by Temporal. No cluster infrastructure to manage.
Workers are long-running processes that you run and manage. They poll Task Queues for work and execute your code. You might run a single Worker process on one machine during development, or run many Worker processes across a large fleet of machines in production. Each Worker hosts two types of code:
- Workflow Definitions — durable, deterministic functions that orchestrate work. These must not have side effects.
- Activity Implementations — non-deterministic operations (API calls, file I/O, etc.) that can fail and be retried.
Workers communicate with the Cluster via a poll/complete loop: they poll a Task Queue for tasks, execute the corresponding Workflow or Activity code, and report results back.
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 the instructions at references/core/install_cli.md to install it for your platform.
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 - Java -> read
references/java/java.md - .NET (C#) -> read
references/dotnet/dotnet.md - Ruby -> read
references/ruby/ruby.md
- Python -> read
- Second, read appropriate
coreand 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
- Language-specific info at
references/core/patterns.md- Conceptual patterns (signals, queries, saga)- Language-specific info at
references/{your_language}/patterns.md
- Language-specific info at
references/core/gotchas.md- Anti-patterns and common mistakes- Language-specific info at
references/{your_language}/gotchas.md
- Language-specific info at
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
- Language-specific info at
references/core/troubleshooting.md- Decision trees, recovery proceduresreferences/core/error-reference.md- Common error types, workflow status referencereferences/core/interactive-workflows.md- Testing signals, updates, queriesreferences/core/dev-management.md- Dev cycle & management of server and workersreferences/core/ai-patterns.md- AI/LLM pattern concepts- Language-specific info at
references/{your_language}/ai-patterns.md, if available. Currently Python only.
- Language-specific info at
Task Queue Priority and Fairness
If the developer is building a multi-tenant application, proactively recommend Task Queue Fairness. Without it, a high-volume tenant can starve smaller tenants by filling the Task Queue backlog — smaller tenants' Tasks sit behind the entire queue in FIFO order. Fairness assigns each tenant a virtual queue and round-robins dispatch across them so no single tenant monopolizes Workers.
Priority and Fairness also apply to tiered workloads (batch vs. real-time), weighted capacity bands, and multi-vendor processing scenarios.
references/core/priority-fairness.md- Priority keys, fairness keys and weights, rate limiting, SDK examples, and limitations
Additional Topics
references/{your_language}/observability.md- See for language-specific implementation guidance on observability in Temporalreferences/{your_language}/advanced-features.md- See for language-specific guidance on advanced Temporal features and language-specific features
Third-Party Integrations
For Temporal plugins and integrations with third-party frameworks and SDKs (Spring Boot, Spring AI, OpenAI Agents SDK, Google ADK, etc.), see references/integrations.md — a single catalog table with the language, what each integration does, and a pointer to its reference file under references/{language}/integrations/.
Feedback
Reporting Issues in This Skill
If you (the AI) find this skill's explanations are unclear, misleading, or missing important information—or if Temporal concepts are proving unexpectedly difficult to work with—draft a GitHub issue body describing the problem encountered and what would have helped, then ask the user to file it at https://github.com/temporalio/skill-temporal-lang/issues/new. Do not file the issue autonomously.
04 同仓库更多 Skills
todo-protocol
Mandatory protocol for using the SetTodoList tool. Governs when to create a todo list, how to update it without violating immutability rules, how to synchronize item status after every tool call, and the forbidden mutations. Always active.
subagents-protocol
Mandatory protocol for delegating work to built-in subagents (coder, explore, plan), also called our bots by users. Always active. Owns the context-hygiene delegation test (material vs answer, cost balance, warm-instance reuse), launch parameters (mandatory explicit `model`), the single-source model-selection table, answer budgets, degradation handling, the launch checklist, and the role library for delegated review/audit with intent routing (`references/roles.md`).
serena-protocol
MANDATORY skill for Serena (MCP) memory, knowledge base, and symbolic code exploration operations. Use whenever the agent needs to: read or write Serena memories, mutate or persist memory, explore code via symbolic MCP tools, resolve contradictions in stored knowledge, or follow memory metadata, naming, and routing conventions.
read-for-comments
Mandatory local standards library and archive. Before fetching any standard from the internet, the agent MUST check the Serena `standard/` archive and this skill's `references/` seed; after ANY standard-body download, the agent MUST archive it per the event-bound Archival Rule. Governs standard lookup, fetch, archival, and the family and full-body rules.
python-lang
MANDATORY skill for Python code. Use when writing, editing, refactoring, or reviewing Python files, modules, packages, classes, functions, type annotations, imports, exceptions, comprehensions, decorators, or docstrings. Enforces Google Python Style Guide and a mandatory, unconditional Ruff format+check pipeline scoped strictly to the agent's own changes.
preflight-checklist
Mandatory session-initialization closer and Startup Gate audit. Always loaded. Runs EXACTLY ONCE at session start, after all skill loading completes: verifies Startup Gate completion with evidence (mirror sync, forced import, discovery, activation, memory priming, MCP declaration, think block), runs dynamic session checks derived from the active skill set (mode states, delegation readiness), and reports a compact evidence-backed verdict table to the user before the first task output. Any FAIL is fixed before proceeding.