Output SDK ワークフロー実行の状態を確認します。 次のような場合に使用: - 実行中のワークフローを監視している - ワークフローが完了したか確認したい - ワークフローの状態(実行中、完了、失敗、終了)を確認したい
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).
このスキルは、ワークフローの現在の実行状態を確認します。実行中のワークフローを監視したり、完了したかどうかを確認したり、結果を取得する前に失敗していないかを判定する際に使用します。
npx output workflow result を使用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 | ワークフローが時間制限を超過 | 長時間かかる処理がないか確認、時間制限の調整を検討 |
例1: 実行中のワークフローを監視する
# ワークフローを開始
npx output workflow start data-sync --input '{"source": "external"}'
# 出力: Workflow ID: sync-abc123
# ステータスを確認
npx output workflow status sync-abc123
# 出力: Status: RUNNING
# 待機して再度確認
sleep 30
npx output workflow status sync-abc123
# 出力: Status: COMPLETED
例2: スクリプト内で完了を待機する
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
例3: 結果を取得する前にステータスを確認する
# まずステータスを確認
npx output workflow status my-workflow-123
# COMPLETED の場合、結果を取得
npx output workflow result my-workflow-123
# FAILED の場合、デバッグ
npx output workflow debug my-workflow-123 --json
例4: 複数のワークフローのステータスを一括確認
# 複数のワークフローを確認
for id in abc123 def456 ghi789; do
echo "Workflow $id: $(npx output workflow status $id)"
done
ワークフローは通常、以下のような遷移をします:
RUNNING → COMPLETED(成功)
RUNNING → FAILED(エラーが発生)
RUNNING → TERMINATED(手動で停止)
RUNNING → TIMED_OUT(時間制限を超過)
ステータスコマンドは以下の情報を返します:
npx output workflow runs list を実行して正しいIDを確認してくださいnpx output workflow debug <id>npx output workflow stop <id>npx output workflow debug でコンテキストを確認してくださいnpx output workflow startnpx output workflow result <id> - 実行結果を取得(COMPLETED後)npx output workflow debug <id> - 実行内容をデバッグ(FAILED後)npx output workflow stop <id> - 実行中のワークフローを停止npx output workflow runs list - 実行履歴を表示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.
npx output workflow result after confirming COMPLETED statusnpx output workflow debug for FAILED workflowsnpx output workflow runs list for multiple runsnpx output workflow status <workflowId>
Replace <workflowId> with the ID from npx output workflow start or npx output workflow runs list.
| 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 |
Scenario: Monitor a running workflow
# Start a workflow
npx output workflow start data-sync --input '{"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
Workflows typically follow these paths:
RUNNING -> COMPLETED (success)
RUNNING -> FAILED (error occurred)
RUNNING -> TERMINATED (manually stopped)
RUNNING -> TIMED_OUT (exceeded limit)
The status command returns information including:
npx output workflow runs list to find the correct IDnpx output workflow debug <id>npx output workflow stop <id>npx output workflow debug for contextnpx output workflow startnpx 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 workflownpx output workflow runs list - View execution history原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。