Investigation Script Loop

おすすめ手動実行

Investigation Script Loop について

手動で開始するデバッグ用ループです。各ラウンドで仮説を立て、scripts/investigate.mjs を編集し、node scripts/investigate.mjs を実行して出力を確認します。最大 8 ラウンドで、Cursor と Claude Code に対応しています。

主な機能

01手動トリガー
02最大 8 ラウンド
03node scripts/investigate.mjs の出力で判定
04Cursor と Claude Code に対応

活用シーン

01特定しにくい断続的な不具合の調査
02問題の根本原因を実行可能な形でチームに示したいとき
03修正に入る前に、疑っている原因が正しいか確かめたいとき

目標: 最小の再現スクリプトが問題の根本原因を実証している。
終了条件: node scripts/investigate.mjs の出力が根本原因を示した時点、または 8 ラウンドの上限に達した時点で停止します。
各ラウンドの間に実行: node scripts/investigate.mjs

起動プロンプト

Cursor / Claude Code に貼り付けて実行すると、終了条件を満たすまでエージェントが以下の手順を繰り返します。

prompt.md

「Investigation Script Loop」ループを開始します。
目標：最小の再現スクリプトが問題の根本原因を実証している。
最大ラウンド数：8。
ステップ 1：仮説を立てる — 既知の症状と前のラウンドの出力をもとに、検証または棄却できる根本原因の仮説を書き出します。
ステップ 2：スクリプトを更新する — scripts/investigate.mjs を編集し、問題を引き起こすのに必要な最小限のコードだけを残します。仮説を区別できる情報も出力させます。
ステップ 3：実行して出力を読む — node scripts/investigate.mjs を実行し、出力で問題が再現されるか、仮説と一致するかを確認します。
ステップ 4：証拠を判定する — 出力が根本原因を明確に示していればループを終えます。曖昧な場合や仮説と食い違う場合は、新たに分かったことを持って次のラウンドに進みます。
各ラウンドの間に実行：`node scripts/investigate.mjs`
終了条件：node scripts/investigate.mjs の出力が根本原因を示した時点、または 8 ラウンドの上限に達した時点で停止します。

手順

各ラウンドは順番に実行され、終了条件を満たさなければ次のラウンドへ進みます（最大 8 ラウンド）。

仮説を立てる

既知の症状と前のラウンドの出力をもとに、検証または棄却できる根本原因の仮説を書き出します。

スクリプトを更新する

scripts/investigate.mjs を編集し、問題を引き起こすのに必要な最小限のコードだけを残します。仮説を区別できる情報も出力させます。

実行して出力を読む

node scripts/investigate.mjs を実行し、出力で問題が再現されるか、仮説と一致するかを確認します。

証拠を判定する

出力が根本原因を明確に示していればループを終えます。曖昧な場合や仮説と食い違う場合は、新たに分かったことを持って次のラウンドに進みます。

未達 → 次のラウンド条件を満たせば終了

対応エージェント

この Loop をそのまま実行できるコーディングエージェントです。

Cursor

Claude Code

Codex

Markdown 対応

ログインしてコメント