mcpField
M
monitoring-terminal-errors

monitoring-terminal-errors

github.com/spencerpauly開発868457 回インストール12 週間前に更新
リポジトリ

monitoring-terminal-errors について

実行中のプロセスのターミナル出力を監視し、修正を繰り返す開発者向けのデバッグスキルです。エラー検出、ソース位置の特定、プロセスの復旧確認を扱います。

主な機能

  1. 01対象プロセスのターミナル特定
  2. 02一般的なエラー出力の検索
  3. 03ファイル、行番号、内容の抽出
  4. 04修正と復旧の確認
  5. 05最大 5 回の反復

活用シーン

  1. 01開発サーバーの障害調査
  2. 02テストランナーやビルドエラーの調査
  3. 03ホットリロード後のエラー解消確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill monitoring-terminal-errors

インストール後、Claude Code で/monitoring-terminal-errorsを入力して読み込まれたか確認します。

詳細

ターミナルエラーの監視

実行中のプロセス（開発サーバー、テストランナー、ビルド）を継続的に監視し、エラーが発生したら修正します。

ワークフロー

1. ターミナルを特定する

ターミナルファイルの一覧を表示し、対象のプロセスを実行しているものを見つけます。

head -n 10 <terminals_folder>/*.txt

開発サーバー（npm run dev、pnpm dev、python manage.py runserver など）を実行しているターミナルを探します。

2. ターミナルの出力を読む

ターミナルファイルの内容をすべて読み取ります。次のエラーパターンを探します。

  • スタックトレース：at <function> (<file>:<line>:<col>)
  • Node.js：Error:、TypeError:、ReferenceError:、ENOENT、ECONNREFUSED
  • Python：Traceback (most recent call last): に続く File "<path>", line <n>
  • React/Next.js：Unhandled Runtime Error、Error: ...、Module not found
  • ビルドエラー：ERROR in、Failed to compile、SyntaxError
  • Vite：[vite] Internal server error:
  • TypeScript：error TS\d+:
3. ソースの場所を抽出する

スタックトレースから、次の情報を抽出します。

  • ファイルパス
  • 行番号
  • エラーメッセージ

Node.js の場合：at functionName (/path/to/file.ts:42:10) Python の場合：File "/path/to/file.py", line 42, in function_name

4. 該当箇所に移動して修正する
  1. 特定したファイルのエラー行付近を読みます
  2. エラーの原因を把握します（インポートの不足、型の不一致、未定義の変数など）
  3. 修正を適用します
  4. ターミナルファイルを再度読み取り、サーバーが復旧したことを確認します（ホットリロードによって変更が反映されるはずです）
5. 繰り返す

修正後もサーバーにエラーが表示されている場合は、手順 2 から繰り返します。次のいずれかに該当したら終了します。

  • ターミナルに「compiled successfully」または同等のメッセージが表示される
  • 出力に新しいエラーが表示されない
  • 5 回試しても解決しない（ユーザーに報告します）

ヒント

  • ターミナルファイルの末尾に exit_code があるか確認します。存在する場合、プロセスは完全にクラッシュしているため、再起動が必要です
  • エラーが連鎖することがあります。最初のエラー、つまり根本原因を修正すると、残りのエラーも解消することがよくあります
  • HMR エラーの場合は、ファイルをもう一度保存して再ビルドを促すだけで修正できることがあります

コメント

Markdown 対応