iCode Agent · ガイド · ワークフロー

バグを追跡する。

バグの難しいところは通常、修正ではなく原因の発見です。iCode Agent はコードを通じて証拠をたどり、パッチを推測するのではなく、見つけたことを伝えます。

タスク

症状を説明し、可能なら再現方法も伝えます。

Users report that saving a duplicate name overwrites the original.
Reproduce it, find the cause, then fix it.

再現手順は、あなたが与えられる最も価値ある入力です。ない場合は、まず再現方法を見つけるか作成するようエージェントに依頼してください。引き起こせないバグは、修正できたと確認できないバグです。

何が起こるか

  1. 再現。失敗するコマンドやテストを実行し、実際の出力(スタックトレース、エラー、誤った値)を読みます。
  2. 証拠をたどる。症状から原因へ向かって、呼び出し元のコード、データ、状態をたどります。失敗は情報であり、糸を引き続けます。
  3. 原因を特定する。何がなぜ間違っているのかを、それを示すコードとともに説明します。パッチを当てる場所だけでなく、理由まで示します。
  4. 修正して検証する。原因に対処する最小の変更を行い、失敗したチェックを再実行します。

修正を受け入れる前に質問する

症状を消すパッチは、バグを修正したこととは同じではありません。根拠と、原因に対処したかを尋ねましょう。

Reproduce the failure in tests, explain the root cause, then fix it.
Don't change the test to make it pass — the test is correct.
Show me every place this same bug could occur.

最後の一行が重要です。優れたバグ調査は、これが一度きりのものではなくパターンの一例かを問います。

「再現できません」と言われたとき

それは失敗ではなく、有用な結果です。エージェントは何を試し、何を観察したかを伝えます。そこから環境を絞り込む、バグを引き起こす入力を渡す、バグがありそうな箇所の状態を記録する計装を依頼する、といった次の手を選べます。