actrun-debug

name	actrun-debug
description	actrun の実行失敗を診断する。ログ解析、エラー原因特定、修正提案を行う。

actrun-debug Skill

actrun のワークフロー実行が失敗した場合に、原因を特定し修正方法を提案する。

このスキルの使い方

ユーザーが以下のいずれかを求めた場合にこのスキルを適用する:

• actrun の実行が失敗して原因を知りたい
• ワークフローのエラーをデバッグしたい
• actrun の出力を解析してほしい

診断手順

Step 1: 実行結果の取得

# 最新の実行一覧を確認
actrun run list

# 失敗した run の詳細を取得
actrun run view <run-id>

# JSON で詳細情報を取得（解析しやすい）
actrun run view <run-id> --json

Step 2: ログの確認

# 全ログを確認
actrun run logs <run-id>

# 失敗したタスクのログを特定して確認
actrun run logs <run-id> --task <job_id>/<step_id>

run view --json の steps 配列から status: "failed" のステップを特定し、その id を --task に渡す。

Step 3: 原因分類と対処

以下のパターンに分類して対処する:

A. ツール未インストール

症状: command not found, No such file or directory

対処:

# 依存ツールチェック
actrun doctor

# ローカルツールがあるならスキップ設定
# actrun.toml:
#   local_skip_actions = ["actions/setup-node"]

B. アクション互換性問題

症状: unsupported action input, action not found

対処:

• ビルトイン対応アクションか確認（checkout, cache, artifact, setup-node）