mcpField
W
workflow-orchestrator

workflow-orchestrator

github.com/404kidwiz開発113 回インストール
リポジトリ

workflow-orchestrator について

workflow-orchestrator は、複雑な業務プロセスを調整する、耐久性のあるワークフローの設計・実装を支援するスキルです。Temporal、Camunda、Saga、補償処理、人による承認フローを扱います。

主な機能

  1. 01長時間実行ワークフローの設計
  2. 02Sagaと補償処理の実装
  3. 03サービス間のアクティビティ調整
  4. 04人による承認ワークフローの構築
  5. 05複雑なプロセス状態機械の管理

活用シーン

  1. 01分散トランザクションの実装
  2. 02耐久性が必要な長時間処理
  3. 03複数サービスにまたがる業務手順の調整
  4. 04人の承認を含むフローの設計

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/404kidwiz/claude-supercode-skills --skill workflow-orchestrator

インストール後、Claude Code で/workflow-orchestratorを入力して読み込まれたか確認します。

詳細

ワークフローオーケストレーター

目的

複雑なビジネスプロセスを調整する、耐久性のあるワークフローシステムの設計と実装に関する専門知識を提供します。Temporal や Camunda などのワークフローエンジン、サガパターン、信頼性の高い長時間実行プロセスの構築を専門としています。

使用する場面

  • 複数ステップのビジネスワークフローを設計する
  • 分散トランザクションにサガパターンを実装する
  • Temporal、Camunda、または同様のワークフローエンジンを使用して構築する
  • 耐久性が求められる長時間実行プロセスを処理する
  • 複数のサービスにまたがるアクティビティを調整する
  • 補償処理とロールバックロジックを実装する
  • 人間が介在する承認ワークフローを構築する
  • 複雑なプロセスのステートマシンを管理する

クイックスタート

次の場合にこのスキルを呼び出してください：

  • 複数ステップのビジネスワークフローを設計する
  • 分散トランザクションにサガパターンを実装する
  • Temporal、Camunda、または同様のワークフローエンジンを使用して構築する
  • 耐久性が求められる長時間実行プロセスを処理する
  • 複数のサービスにまたがるアクティビティを調整する

次の場合は呼び出さないでください：

  • シンプルな非同期ジョブ処理 → 適切なキューソリューションを使用してください
  • エージェント向けのタスク分配 → task-distributor を使用してください
  • イベントストリーミング → event-driven-architect を使用してください
  • CI/CD パイプライン → devops-engineer を使用してください

判断フレームワーク

Workflow Need?
├── Durable Long-Running → Temporal or durable execution engine
├── Human Tasks → Camunda or process orchestration platform
├── Choreography → Event-driven with eventual consistency
├── Simple Steps → State machine or queue-based
├── Saga Pattern → Orchestrated or choreographed compensations
└── Scheduled Jobs → Cron-based with workflow wrapper

主なワークフロー

1. Temporal ワークフローの実装
  1. ワークフローのインターフェースとアクティビティを定義する
  2. Temporal SDK でワークフローロジックを実装する
  3. 外部呼び出し用のアクティビティ実装を作成する
  4. 再試行ポリシーとタイムアウトを設定する
  5. 外部とのやり取りにシグナルとクエリを実装する
  6. ワークフローの更新に備えてバージョニングを追加する
  7. ワーカーをデプロイし、実行を監視する
  8. Temporal テストフレームワークを使用したテストを実装する
2. サガパターンの実装
  1. 分散トランザクションの境界を特定する
  2. 順方向のアクションと補償アクションを定義する
  3. オーケストレーション（中央集権型）またはコレオグラフィ（イベント駆動型）を選択する
  4. 冪等な操作を実装する
  5. 補償処理により部分的な失敗に対処する
  6. 停滞したサガに対するタイムアウト処理を追加する
  7. サガの状態を可観測にする
  8. 障害シナリオを徹底的にテストする
3. 人間が介在するワークフロー
  1. 人間が作業するポイントを含むプロセスを設計する
  2. BPMN または同様の表記法でワークフローをモデル化する
  3. 自動化されたステップをアクティビティとして実装する
  4. 人間による操作用のタスク受信トレイ UI を作成する
  5. エスカレーションとタイムアウト処理を追加する
  6. 委任と再割り当てを実装する
  7. コンプライアンス対応の監査証跡を追加する
  8. 人間が対応するタスクの SLA を監視する

ベストプラクティス

  • 安全に再試行できるよう、すべてのアクティビティを冪等にする
  • 本番環境の更新にはワークフローのバージョニングを使用する
  • 障害に備え、包括的な補償処理を実装する
  • 各ステップに適切なタイムアウトを設定する
  • ワークフロー全体にまたがるトレースで可観測性を確保する
  • 障害を前提に設計し、どのステップでも失敗する可能性を想定する

アンチパターン

  • 冪等でないアクティビティ → 安全に再試行できるように設計する
  • 補償処理の欠如 → 最初からロールバックを計画する
  • 無限の再試行 → 最大試行回数を設定し、障害に対処する
  • 人間のタスクによるブロック → タイムアウトとエスカレーションを追加する
  • 強い結合 → ワークフローとアクティビティの実装を疎結合に保つ

コメント

Markdown 対応