スキル temporal-python-testing

🧪

temporal-python-testing

Name: temporal-python-testing
Author: wshobson

安全 ⚙️ 外部コマンド🌐 ネットワークアクセス📁 ファイルシステムへのアクセス

pytestとモックを使用したTemporalワークフローのテスト

Temporalワークフローのテストはしばしば低速で不安定です。このスキルは、タイムスキップ、アクティビティモック、リプレイ検証を使用した高速で決定論的なテストパターンを提供し、信頼性の高いCI/CDパイプラインを実現します。

対応: Claude Codex Code(CC)

📊 69 十分

スキルZIPをダウンロード

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

オンにして利用開始

テストする

「temporal-python-testing」を使用しています。 Create a test plan for Temporal workflows with unit, integration, and replay coverage.

期待される結果:

高速なユニットワークフロートテストにはWorkflowEnvironmentとタイムスキップを使用
外部依存関係を統合テストでモックし、エラーハンドリング 경로를検証
本番履歴をエクスポートし、新しいコードに対してデプロイ前にリプレイ

「temporal-python-testing」を使用しています。 How do I test a workflow that has retry logic and multiple activities?

期待される結果:

ワークフローロジックを分離するためにモックされたアクティビティでテストを作成
アクティビティ固有のエラーハンドリングをテストするためにActivityEnvironmentを使用
アクティビティの呼び出し回数を数えてリトライ動作を検証
アサーション付き成功パスと失敗パスの両方をテスト

「temporal-python-testing」を使用しています。 What are common mistakes when testing Temporal workflows?

期待される結果:

モックする代わりに実際の外部APIを呼び出す
replayの決定論性を壊すrandom()やdatetime.now()の使用
ワークフローの変更前にリプレイテストをスキップ
長時間ワークフローのテストでタイムスキップを使用しない

セキュリティ監査

安全

v4 • 1/17/2026

Educational documentation for Temporal workflow testing. Static scanner false positives: markdown code block backticks flagged as shell execution, legitimate docs URLs as hardcoded URLs, and test code patterns as cryptographic/C2 indicators. Previous Claude audit (skill-report.json) confirmed safe with no risk factors. All 149 findings are false positives from documentation patterns.

スキャンされたファイル

2,131

解析された行数

検出結果

総監査数

リスク要因

⚙️ 外部コマンド (125)

🌐 ネットワークアクセス (6)

resources/local-setup.md:48 resources/local-setup.md:69 resources/local-setup.md:502 resources/replay-testing.md:123 resources/replay-testing.md:123 skill-report.json:6

📁 ファイルシステムへのアクセス (4)

resources/replay-testing.md:455 resources/replay-testing.md:195 resources/replay-testing.md:291 resources/replay-testing.md:323

監査者: claude 監査履歴を表示 →

品質スコア

アーキテクチャ

100

保守性

コンテンツ

コミュニティ

100

セキュリティ

仕様準拠

作れるもの

高速ユニットテストの追加

タイムスキップを使用した迅速なワークフローとアクティビティのテストを、数時間ではなく数ミリ秒で実行するように作成します。

統合フローの検証

外部サービスをモックし、エラー注入を伴う複雑なワークフローオーケストレーション 경로를検証します。

リプレイチェックの実行

デプロイ前にワークフローの決定論性を確認し、バージョン互換性を検証します。

これらのプロンプトを試す

ユニットテストの開始

タイムスキップとシンプルなアクティビティを持つワークフローをテストするための最小のpytestセットアップを見せてください。フィクスチャとアサーションを含めてください。

モックアクティビティ

アクティビティをモックし、アクティビティの結果に基づくワークフローの分岐ロジックを検証する統合テストの例を提供してください。

リプレイ安全性チェック

本番からワークフローの履歴をリプレイし、実行中のワークフローを破壊する可能性のある非決定的な変更を検出する方法を説明してください。

CIカバレッジ計画

pytestマーカー、カバレッジしきい値、安全なデプロイのための自動リプレイテストを含む完全なCI計画の概要を示してください。

ベストプラクティス

すべてのワークフローユニットテストにタイムスキップを使用して、数か月間のワークフローを数秒で実行
ワークフローロジックを分離するために統合テストで外部依存関係をモック
決定論性を確保するためにワークフローの変更をデプロイする前にリプレイテストを実行

回避

モックする代わりにワークフローテスト内で実際の外部APIを呼び出す
Temporalヘルパーなしでワークフローコード内でrandom()やdatetime.now()を使用
重要なワークフローのリファクタリングやロジック変更後にリプレイテストをスキップ

よくある質問

どのようなPythonバージョンがサポートされていますか？

例はPython 3.10以降とTemporal Python SDK v1.5.0以降を対象としています。

テストサイズに制限はありますか？

固定された制限はありませんが、大きなリプレイテストスイートはCIでパフォーマンスのためにバッチ処理する必要があります。

既存のpytestセットアップと統合できますか？

はい、このガイダンスは既存の構成で動作する標準のpytestフィクスチャとマーカーを使用します。

このスキルは私のデータや資格情報にアクセスしますか？

いいえ、このスキルはガイダンスのみを提供し、ファイル、環境変数、シークレットを読み取りません。

非決定性のためにテストが失敗した場合はどうすればよいですか？

安全な変更にはworkflow.get_version()を使用し、Temporalヘルパーなしでrandomやdatetimeを使用しないでください。

エンドツーエンドテストと比較するとどうですか？

モックを使用したより高速なユニットテストと統合テストを重視し、安全性検証にリプレイテストを使用します。

開発者の詳細

作成者

wshobson

ライセンス

MIT

リポジトリ

https://github.com/wshobson/agents/tree/main/plugins/backend-development/skills/temporal-python-testing

参照

main

ファイル構成

📁 resources/

📄 integration-testing.md

📄 local-setup.md

📄 replay-testing.md

📄 unit-testing.md

📄 SKILL.md