actions-debugger

shiiman's avatarfrom shiiman

GitHub Actions のワークフロー実行エラーを調査し、原因を特定して解決策を提案する。「Actions エラー」「ワークフロー失敗」「CI が落ちた」「ビルド失敗」「テスト失敗」「Actions を調べて」「CI のエラーを見て」などで起動。失敗したジョブのログを分析し、具体的な修正方法を提示。

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026
[CI and CD]

When & Why to Use This Skill

The Actions Debugger is a specialized Claude skill designed to automate the troubleshooting of GitHub Actions workflow failures. By leveraging the GitHub CLI to analyze error logs and job statuses, it identifies root causes—such as test failures, build errors, dependency conflicts, or permission issues—and provides developers with actionable code fixes and local reproduction commands to restore CI/CD pipelines quickly.

Use Cases

  • Automated CI Failure Analysis: Quickly identify the exact step and reason why a GitHub Actions workflow failed without manually sifting through extensive log files.
  • Dependency and Build Troubleshooting: Detect and resolve environment-specific issues like npm/yarn errors, compilation failures, or missing dependencies within the CI runner.
  • Permission and Secret Debugging: Diagnose and fix workflow failures related to GITHUB_TOKEN permissions, workflow scopes, or missing repository secrets.
  • Rapid Pull Request Fixes: Streamline the development cycle by generating immediate suggestions and local test commands to fix failing PR checks, reducing the feedback loop for developers.
nameactions-debugger
descriptionGitHub Actions のワークフロー実行エラーを調査し、原因を特定して解決策を提案する。「Actions エラー」「ワークフロー失敗」「CI が落ちた」「ビルド失敗」「テスト失敗」「Actions を調べて」「CI のエラーを見て」などで起動。失敗したジョブのログを分析し、具体的な修正方法を提示。
allowed-tools[Read, Bash, Grep, Glob]
contextfork
agentdebugger

Actions Debugger

GitHub Actions のワークフロー実行エラーを調査し、原因を特定して解決策を提案します。

ワークフロー

1. 失敗した Run の特定

# 最近の失敗した Run を一覧表示
gh run list --status failure --limit 5

# 特定の PR に関連する Run を確認
gh pr checks {pr番号}

2. エラーログの取得

# Run の詳細とジョブ一覧を取得
gh run view {run_id} --verbose

# 失敗したステップのログを取得
gh run view {run_id} --log-failed

3. エラー分析

ログから以下を特定:

  • エラーメッセージ
  • 失敗したステップ
  • 関連するファイル・行番号

4. 解決策の提案

エラーパターンに基づいて:

  • 具体的な修正コード
  • 設定変更の提案
  • 参考ドキュメントへのリンク

よくあるエラーパターン

テスト失敗

# テストログの詳細確認
gh run view {run_id} --log-failed | grep -A 10 "FAIL"

対処法:

  • 失敗したテストケースを特定
  • ローカルで再現
  • テストまたはコードを修正

ビルドエラー

# ビルドログの確認
gh run view {run_id} --log-failed | grep -A 5 "error"

対処法:

  • コンパイルエラーを特定
  • 型エラーや構文エラーを修正
  • 依存関係を確認

依存関係エラー

# npm / yarn エラーの確認
gh run view {run_id} --log-failed | grep -A 5 "npm ERR!"

対処法:

  • package-lock.json を更新
  • 依存関係のバージョンを確認
  • キャッシュをクリア

権限エラー

対処法:

  • workflow の permissions を確認
  • GITHUB_TOKEN の権限を確認
  • secrets の設定を確認

出力形式

エラーレポート

## GitHub Actions エラー調査結果

**Run ID**: {run_id}
**ワークフロー**: {workflow_name}
**ステータス**: ❌ failure

### 失敗したジョブ

| ジョブ | ステップ | 原因 |
|--------|----------|------|
| test | Run tests | テスト失敗 |

### エラー詳細

FAIL src/tests/user.test.ts ● UserService > should return user Expected: "John" Received: "Jane"


### 修正提案

1. `src/__tests__/user.test.ts` の期待値を確認
2. または `UserService` の実装を確認

### 参考コマンド

```bash
# ローカルでテスト実行
npm test -- --testPathPattern=user.test.ts


## 重要な注意事項

- ✅ エラーログを詳細に分析
- ✅ 具体的な修正提案を含める
- ✅ ローカルでの再現方法を提示
- ❌ 漠然とした提案を避ける
- ❌ 関係ないエラーを混同しない