Temporal Python Testing

Use when testing Temporal Python workflows or activities with pytest; choose time-skipping, activity isolation, worker integration, and replay tests deliberately, and verify determinism and version compatibility before deployment.

9 stars 3 forksTesting & QA

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sandbaseai/workbuddy-skill --skill temporal-python-testing
Manual install
git clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/temporal-python-testing ~/.claude/skills/temporal-python-testing

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Temporal Python 工作流测试

Temporal 测试需要同时验证工作流确定性、Activity 边界、事件时间、重试/取消、信号/查询和版本兼容。长时间业务流程应通过 time-skipping 获得快速反馈,再用受控 Worker 集成和授权的历史 replay 覆盖运行时差异。

## 环境与安全门禁

开始前记录 repository revision、Python/SDK/Server 版本、namespace/task queue、工作流类型、数据来源、测试副作用、历史访问授权和 artifact 保留策略。

- 默认使用本地 time-skipping 环境、专用测试 namespace、合成 payload 和最小权限凭据;不连接生产 Temporal。
- history、payload、headers、日志、trace 和截图可能含客户数据/秘密,必须脱敏、限制访问并设置保留期;不要把完整 history 提交到仓库。
- Activity 测试禁止真实付款、邮件、删除或外部写入;用 fake/sandbox 并验证调用契约。
- SDK/Server、workflow 版本或历史来源不明,Worker 无法可靠 shutdown,或清理失败时返回 `BLOCKED`。

## 测试层

| 层级 | 验证目标 | 典型环境 |
| --- | --- | --- |
| Workflow unit | 分支、计时器、重试、取消、signal/query 和状态 | `WorkflowEnvironment` time-skipping,mock Activities |
| Activity unit | 输入校验、业务副作用、异常分类和超时 | `ActivityEnvironment` + fake 外部依赖 |
| Worker integration | 注册、序列化、task queue、workflow/activity 协作 | 本地 Temporal/test namespace |
| Replay | 既有事件历史仍可由当前 workflow 确定性重放 | 授权且脱敏的固定 history |
| End-to-end | 少量关键流程和真实 sandbox 集成 | 隔离服务,谨慎使用,明确清理 |

多数逻辑应在前两层快速验证;E2E 不应替代 determinism 或契约测试。

## Time-skipping Workflow 测试

使用 time-skipping 环境让月/日级 timer 在测试中快速推进,但每次推进都要对应业务条件,不要依赖墙上时钟或固定 sleep。
Read the full skill on GitHub

Details

Skill name
temporal-python-testing
Path
skills/temporal-python-testing/SKILL.md
License
MIT
Repo updated
8 September 2026

FAQ

What does the Temporal Python Testing skill do?

Use when testing Temporal Python workflows or activities with pytest; choose time-skipping, activity isolation, worker integration, and replay tests deliberately, and verify determinism and version compatibility before deployment.

How do I install the Temporal Python Testing skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill temporal-python-testing. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Temporal Python Testing popular?

It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.

Related skills

Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.