• Projects
  • Service
  • About
  • branding.bz
  • Podcast
  • Tips
  • FAQ
  • Recruit
  • Download
  • Contact
  • branding.bz(ブランド構築SaaS)
  • DESIGN NOW(デザインメディア)
  • X
  • LinkedIn
  • Spotify
  • Facebook

213-0011 神奈川県川崎市高津区久本3-6-7-303

© 2026 ID INC. All rights reserved

claude-skills/スキル
SKILLOfficialdevelopment

output-workflow-status

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

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).

ユースケース
  • ワークフローの実行状態を確認したい
  • ワークフローが完了したか確認したい
  • 実行中のワークフローを監視している
本文(日本語訳)

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

概要

このスキルは、ワークフローの現在の実行状態を確認します。実行中のワークフローを監視したり、完了したかどうかを確認したり、結果を取得する前に失敗していないかを判定する際に使用します。

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

  • 非同期で開始したワークフローを監視している
  • ワークフローが完了したかどうかを確認したい
  • ワークフロー結果が取得できない理由を特定したい
  • アクションを取る前にワークフローの状態を確認したい
  • スクリプト内で完了を待機(ポーリング)したい

他のコマンドを使う場合

  • 結果を取得する: 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 ワークフローが時間制限を超過 長時間かかる処理がないか確認、時間制限の調整を検討

使用例

例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(時間制限を超過)

ステータス出力の見方

ステータスコマンドは以下の情報を返します:

  • Status: 現在の状態(RUNNING、COMPLETED、FAILEDなど)
  • Duration: ワークフローが実行してからの経過時間、または実行していた時間
  • Start Time: ワークフローが開始した時刻

トラブルシューティング

「ワークフローが見つかりません」というエラーが出る場合

  • ワークフロー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 --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

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 による自動翻訳です。