claude-skills/

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

last sync 22h ago
スキルOfficialdevelopment

📋output-workflow-runs-list

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

説明

ワークフロー実行履歴をSDKでリスト出力します。 次のような場合に使用: - 失敗した実行を検索する - 過去の実行内容を確認する - デバッグ用にワークフローIDを特定する - ワークフロータイプで実行を絞り込む - 最近のワークフローアクティビティを調査する

原文を表示

List Output SDK workflow execution history. Use when finding failed runs, reviewing past executions, identifying workflow IDs for debugging, filtering runs by workflow type, or investigating recent workflow activity.

ユースケース

  • ✓失敗した実行を検索するとき
  • ✓過去の実行内容を確認するとき
  • ✓デバッグ用にワークフローIDを特定するとき
  • ✓ワークフロータイプで実行を絞り込むとき
  • ✓最近のワークフローアクティビティを調査するとき

本文（日本語訳）

ワークフロー実行履歴の一覧表示

概要

このスキルは、ワークフローの実行履歴を確認するために使用します。 失敗した実行の検索、デバッグ用のワークフローIDの特定、過去の実行内容のレビューなどに活用できます。

次のような場合に使用

  • 最近の失敗したワークフロー実行を検索したいとき
  • デバッグ用のワークフローIDを取得したいとき
  • 特定のワークフローの実行履歴を確認したいとき
  • 問題が発生し始めたタイミングを調査したいとき
  • 最近の実行ステータスを確認したいとき

手順

最近のすべての実行を一覧表示する

npx output workflow runs list

デフォルトでは、すべてのワークフロータイプを対象に、直近100件の実行が表示されます。

使用可能なフラグ

フラグ 説明 デフォルト
--limit <n> 表示する実行件数 100
--format <type> 出力形式: table（表）, text（テキスト） table
--json 機械可読なJSON形式で出力 false

ワークフロー名でフィルタリングする

npx output workflow runs list <workflowName>

指定したワークフロータイプの実行のみが表示されます。

詳細なJSON出力を取得する

npx output workflow runs list --json

プログラムによる分析が必要な場合や、完全な詳細情報が必要な場合はJSON形式を使用してください。

出力内容の見方

ステータスの値

ステータス 意味 対応
RUNNING ワークフローが現在実行中 待機または監視する
COMPLETED ワークフローが正常に完了 対応不要
FAILED ワークフローでエラーが発生 トレースを使ってデバッグする
TERMINATED ワークフローが手動で停止された 意図した操作かどうか確認する
TIMED_OUT ワークフローが制限時間を超過 長時間処理がないか確認する

主要なフィールド

実行履歴を確認する際は、以下の項目に注目してください。

  • Workflow ID: デバッグコマンドで必要となる一意の識別子
  • Status: 現在の実行状態
  • Start Time: 実行が開始された日時
  • End Time: 実行が完了した日時（完了している場合）
  • Workflow Name: 実行されたワークフローのタイプ

使用例

シナリオ: 失敗したワークフロー実行を見つける

# 直近の実行を一覧表示し、FAILEDステータスを確認する
npx output workflow runs list --limit 20

# またはJSON形式とjqを組み合わせてフィルタリングする
npx output workflow runs list --json | jq '.[] | select(.status == "FAILED")'

シナリオ: デバッグ用のワークフローIDを取得する

# 特定のワークフローの実行を一覧表示する
npx output workflow runs list my-workflow --limit 5

# 出力からワークフローIDを確認する（例: "abc123xyz"）
# その後、デバッグを実行する
npx output workflow debug abc123xyz --json

シナリオ: 特定のワークフローの最近のアクティビティを確認する

# data-pipelineワークフローの直近10件の実行を確認する
npx output workflow runs list data-pipeline --limit 10

シナリオ: 分析用に実行履歴をエクスポートする

# 最近のすべての実行をJSON形式で取得し、外部分析に活用する
npx output workflow runs list --json > workflow-runs.json

シナリオ: 失敗が始まったタイミングを特定する

# より多くの履歴を確認してパターンを把握する
npx output workflow runs list --limit 50 --json | jq 'group_by(.status) | map({status: .[0].status, count: length})'

問題の特定

問題が疑われるサイン

  1. FAILEDが連続して発生している: 継続的なバグが存在する可能性
  2. COMPLETEDとFAILEDが混在している: 入力データに依存する問題の可能性
  3. 最近の実行がすべてTERMINATED: 誰かがワークフローを意図的に停止している可能性
  4. RUNNINGの時間が異常に長い: ハングアップまたはパフォーマンス上の問題の可能性

失敗した実行を見つけた後の手順

  1. 該当する実行のワークフローIDをコピーする
  2. 実行トレースを取得する: npx output workflow debug <workflowId> --json
  3. トレースを分析して障害箇所を特定する
  4. エラーのパターンに基づいて適切な修正を適用する

関連コマンド

  • npx output workflow debug <id> - 実行トレースを分析する
  • npx output workflow status <id> - 現在のステータスを確認する
  • npx output workflow result <id> - 実行結果を取得する
  • npx output workflow list - 利用可能なワークフローを一覧表示する
原文（English）を表示

List Workflow Execution History

Overview

This skill helps you view the execution history of workflows. Use it to find failed runs, identify workflow IDs for debugging, and review past executions.

When to Use This Skill

  • Finding recent failed workflow runs
  • Getting a workflow ID for debugging
  • Reviewing execution history for a specific workflow
  • Investigating when a problem started occurring
  • Checking the status of recent executions

Instructions

List All Recent Runs

npx output workflow runs list

By default, this shows the 100 most recent workflow executions across all workflow types.

Available Flags

Flag Description Default
--limit <n> Number of runs to display 100
--format <type> Output format: table, text table
--json Output machine-readable JSON false

Filter by Workflow Name

npx output workflow runs list <workflowName>

This shows only runs for the specified workflow type.

Get Detailed JSON Output

npx output workflow runs list --json

Use JSON format for programmatic analysis or when you need full details.

Understanding the Output

Status Values

Status Meaning Action
RUNNING Workflow is currently executing Wait or monitor
COMPLETED Workflow finished successfully No action needed
FAILED Workflow encountered an error Debug with trace
TERMINATED Workflow was manually stopped Review if expected
TIMED_OUT Workflow exceeded time limit Check for long operations

Key Fields

When viewing runs, pay attention to:

  • Workflow ID: Unique identifier needed for debugging commands
  • Status: Current execution state
  • Start Time: When the execution began
  • End Time: When the execution completed (if finished)
  • Workflow Name: The type of workflow that ran

Examples

Scenario: Find failed workflow runs

# List recent runs and look for FAILED status
npx output workflow runs list --limit 20

# Or use JSON format with jq to filter
npx output workflow runs list --json | jq '.[] | select(.status == "FAILED")'

Scenario: Get workflow ID for debugging

# List runs for a specific workflow
npx output workflow runs list my-workflow --limit 5

# Note the workflow ID from the output (e.g., "abc123xyz")
# Then debug it
npx output workflow debug abc123xyz --json

Scenario: Review recent activity for a specific workflow

# See the last 10 runs of the data-pipeline workflow
npx output workflow runs list data-pipeline --limit 10

Scenario: Export run history for analysis

# Get all recent runs as JSON for external analysis
npx output workflow runs list --json > workflow-runs.json

Scenario: Find when failures started

# Look at more history to find patterns
npx output workflow runs list --limit 50 --json | jq 'group_by(.status) | map({status: .[0].status, count: length})'

Identifying Problems

Signs of Issues

  1. Multiple FAILED runs: Indicates a persistent bug
  2. Mix of COMPLETED and FAILED: Could be input-dependent issues
  3. All recent runs TERMINATED: Someone may be stopping workflows
  4. Long RUNNING times: Possible hang or performance issue

Next Steps After Finding a Failed Run

  1. Copy the workflow ID from the run
  2. Get the execution trace: npx output workflow debug <workflowId> --json
  3. Analyze the trace to identify the failure
  4. Apply the appropriate fix based on the error pattern

Related Commands

  • npx output workflow debug <id> - Analyze execution trace
  • npx output workflow status <id> - Check current status
  • npx output workflow result <id> - Get execution result
  • npx output workflow list - List available workflows

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