mcpField
M
monitoring-terminal-errors

monitoring-terminal-errors

github.com/revitalb-port開発066 回インストール11 週間前に更新
リポジトリ

monitoring-terminal-errors について

実行中のプロセスのターミナル出力を監視し、ソース内のエラーを特定して修正を繰り返す開発スキルです。復旧時または5回試しても解決しない場合に停止します。

主な機能

  1. 01対象プロセスのターミナル特定
  2. 02一般的な実行時・ビルドエラーの検出
  3. 03ファイルパスと行番号の抽出
  4. 04修正と復旧確認の手順
  5. 055回失敗した時点で停止

活用シーン

  1. 01開発中のサーバーエラーの調査
  2. 02テストランナーのエラー修正
  3. 03ビルド失敗の解消とホットリロード確認

インストール

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

$npx skills add https://github.com/revitalb-port/skills-registry-demo --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 対応