claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 22h ago
スキルOfficialdevelopment

📊output-workflow-status

プラグイン
outputai
ソース
GitHub で見る ↗

説明

Output SDK ワークフロー実行のステータスを確認します。 次のような場合に使用: - 実行中のワークフローを監視する - ワークフローが完了したかどうかを確認する - ワークフローの状態（RUNNING、COMPLETED、FAILED、TERMINATED）を判定する

原文を表示

Check the status of an Output SDK workflow execution. Use when monitoring a running workflow, checking if a workflow completed, or determining workflow state (RUNNING, COMPLETED, FAILED, TERMINATED).

ユースケース

  • ✓実行中のワークフローを監視する
  • ✓ワークフロー完了の確認
  • ✓ワークフロー状態の判定

本文（日本語訳）

ワークフロー実行ステータスの確認

概要

このスキルは、ワークフローの現在の実行ステータスを確認します。 次のような場合に使用: 実行中のワークフローの監視、完了の確認、または結果を取得する前にワークフローが失敗していないかの判断。

このスキルを使用する場面

  • 非同期で開始したワークフローの監視
  • ワークフローが完了したかどうかの確認
  • ワークフローの結果が取得できない原因の調査
  • アクションを実行する前のワークフロー状態の確認
  • スクリプトでの完了ポーリング

他のコマンドを使用する場面

  • 結果の取得: COMPLETED ステータスを確認した後は npx output workflow result を使用
  • 失敗のデバッグ: FAILED 状態のワークフローには npx output workflow debug を使用
  • 実行履歴の確認: 複数の実行を確認するには npx output workflow runs list を使用

手順

ステータスの確認

npx output workflow status <workflowId>

<workflowId> は、npx output workflow start または npx output workflow runs list で取得した ID に置き換えてください。

ステータス値の解説

ステータス 意味 次のアクション
RUNNING ワークフローが現在実行中 待機して再度確認する
COMPLETED ワークフローが正常に完了 npx output workflow result で結果を取得する
FAILED ワークフローでエラーが発生 npx output workflow debug でデバッグする
TERMINATED ワークフローが手動で停止された 意図的かを確認し、必要であれば再起動する
TIMED_OUT ワークフローが制限時間を超過 長時間処理がないか確認し、タイムアウトを調整する

使用例

シナリオ: 実行中のワークフローを監視する

# ワークフローを開始
npx output workflow start data-sync '{"source": "external"}'
# 出力例: Workflow ID: sync-abc123

# ステータスを確認
npx output workflow status sync-abc123
# 出力例: Status: RUNNING

# 待機して再確認
sleep 30
npx output workflow status sync-abc123
# 出力例: Status: COMPLETED

シナリオ: スクリプトで完了をポーリングする

WORKFLOW_ID="abc123xyz"

while true; do
  STATUS=$(npx output workflow status $WORKFLOW_ID)
  echo "現在のステータス: $STATUS"

  if [[ "$STATUS" == *"COMPLETED"* ]]; then
    echo "ワークフローが完了しました！"
    npx output workflow result $WORKFLOW_ID
    break
  elif [[ "$STATUS" == *"FAILED"* ]]; then
    echo "ワークフローが失敗しました！"
    npx output workflow debug $WORKFLOW_ID --json
    break
  fi

  sleep 10
done

シナリオ: 結果を取得する前にステータスを確認する

# 先にステータスを確認
npx output workflow status my-workflow-123

# COMPLETED の場合、結果を取得
npx output workflow result my-workflow-123

# FAILED の場合、代わりにデバッグを実行
npx output workflow debug my-workflow-123 --json

シナリオ: 複数ワークフローのステータスを一括確認する

# 複数のワークフローを確認
for id in abc123 def456 ghi789; do
  echo "ワークフロー $id: $(npx output workflow status $id)"
done

ステータスの遷移

ワークフローは通常、以下のパスをたどります:

RUNNING -> COMPLETED（成功）
RUNNING -> FAILED（エラー発生）
RUNNING -> TERMINATED（手動停止）
RUNNING -> TIMED_OUT（制限時間超過）

ステータス出力の読み方

status コマンドは以下の情報を返します:

  • Status: 現在の状態（RUNNING、COMPLETED、FAILED など）
  • Duration: ワークフローの実行中または実行済みの経過時間
  • Start Time: ワークフローの開始日時

トラブルシューティング

「Workflow not found」が表示される場合

  • ワークフロー ID が誤っている可能性があります
  • ワークフローが履歴から削除された可能性があります
  • npx output workflow runs list で正しい ID を確認してください

ステータスが RUNNING のまま長時間変わらない場合

  1. ワークフローが停止していないか確認: npx output workflow debug <id>
  2. 無限ループや待機処理がないか調べる
  3. 停止を検討: npx output workflow stop <id>

予期しない TERMINATED ステータスが表示される場合

  • 誰かが手動でワークフローを停止した可能性があります
  • npx output workflow debug で詳細を確認してください
  • 必要であれば再起動: npx output workflow start

関連コマンド

  • npx output workflow result <id> - 実行結果を取得（COMPLETED 後）
  • npx output workflow debug <id> - 実行内容をデバッグ（FAILED 後）
  • npx output workflow stop <id> - 実行中のワークフローを停止
  • npx output workflow runs list - 実行履歴を表示
原文（English）を表示

Check Workflow Execution Status

Overview

This skill checks the current execution status of a workflow. Use it to monitor running workflows, verify completion, or determine if a workflow failed before attempting to get its result.

When to Use This Skill

  • Monitoring a workflow started asynchronously
  • Checking if a workflow has completed
  • Determining why you can't get a workflow result
  • Verifying workflow state before taking action
  • Polling for completion in scripts

When to Use Other Commands

  • Getting results: Use npx output workflow result after confirming COMPLETED status
  • Debugging failures: Use npx output workflow debug for FAILED workflows
  • Execution history: Use npx output workflow runs list for multiple runs

Instructions

Check Status

npx output workflow status <workflowId>

Replace <workflowId> with the ID from npx output workflow start or npx output workflow runs list.

Understanding Status Values

Status Meaning Next Action
RUNNING Workflow is currently executing Wait and check again
COMPLETED Workflow finished successfully Get result with npx output workflow result
FAILED Workflow encountered an error Debug with npx output workflow debug
TERMINATED Workflow was manually stopped Review if expected, restart if needed
TIMED_OUT Workflow exceeded time limit Check for long operations, adjust timeout

Examples

Scenario: Monitor a running workflow

# Start a workflow
npx output workflow start data-sync '{"source": "external"}'
# Output: Workflow ID: sync-abc123

# Check status
npx output workflow status sync-abc123
# Output: Status: RUNNING

# Wait and check again
sleep 30
npx output workflow status sync-abc123
# Output: Status: COMPLETED

Scenario: Poll for completion in a script

WORKFLOW_ID="abc123xyz"

while true; do
  STATUS=$(npx output workflow status $WORKFLOW_ID)
  echo "Current status: $STATUS"

  if [[ "$STATUS" == *"COMPLETED"* ]]; then
    echo "Workflow completed!"
    npx output workflow result $WORKFLOW_ID
    break
  elif [[ "$STATUS" == *"FAILED"* ]]; then
    echo "Workflow failed!"
    npx output workflow debug $WORKFLOW_ID --json
    break
  fi

  sleep 10
done

Scenario: Check before getting result

# Verify status first
npx output workflow status my-workflow-123

# If COMPLETED, get result
npx output workflow result my-workflow-123

# If FAILED, debug instead
npx output workflow debug my-workflow-123 --json

Scenario: Batch status check

# Check multiple workflows
for id in abc123 def456 ghi789; do
  echo "Workflow $id: $(npx output workflow status $id)"
done

Status Transitions

Workflows typically follow these paths:

RUNNING -> COMPLETED (success)
RUNNING -> FAILED (error occurred)
RUNNING -> TERMINATED (manually stopped)
RUNNING -> TIMED_OUT (exceeded limit)

Interpreting Status Output

The status command returns information including:

  • Status: Current state (RUNNING, COMPLETED, FAILED, etc.)
  • Duration: How long the workflow has been running or ran
  • Start Time: When the workflow began

Troubleshooting

"Workflow not found"

  • The workflow ID may be incorrect
  • The workflow may have been deleted from history
  • Check npx output workflow runs list to find the correct ID

Status stays RUNNING too long

  1. Check if the workflow is stuck: npx output workflow debug <id>
  2. Look for infinite loops or waiting operations
  3. Consider stopping: npx output workflow stop <id>

Unexpected TERMINATED status

  • Someone may have manually stopped the workflow
  • Check with npx output workflow debug for context
  • Restart if needed: npx output workflow start

Related Commands

  • npx output workflow result <id> - Get execution result (after COMPLETED)
  • npx output workflow debug <id> - Debug execution (after FAILED)
  • npx output workflow stop <id> - Stop a running workflow
  • npx output workflow runs list - View execution history

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。