iCode Agent · ガイド · ワークフロー
バグを追跡する。
バグの難しいところは通常、修正ではなく原因の発見です。iCode Agent はコードを通じて証拠をたどり、パッチを推測するのではなく、見つけたことを伝えます。
タスク
症状を説明し、可能なら再現方法も伝えます。
Users report that saving a duplicate name overwrites the original. Reproduce it, find the cause, then fix it.
再現手順は、あなたが与えられる最も価値ある入力です。ない場合は、まず再現方法を見つけるか作成するようエージェントに依頼してください。引き起こせないバグは、修正できたと確認できないバグです。
何が起こるか
- 再現。失敗するコマンドやテストを実行し、実際の出力(スタックトレース、エラー、誤った値)を読みます。
- 証拠をたどる。症状から原因へ向かって、呼び出し元のコード、データ、状態をたどります。失敗は情報であり、糸を引き続けます。
- 原因を特定する。何がなぜ間違っているのかを、それを示すコードとともに説明します。パッチを当てる場所だけでなく、理由まで示します。
- 修正して検証する。原因に対処する最小の変更を行い、失敗したチェックを再実行します。
修正を受け入れる前に質問する
症状を消すパッチは、バグを修正したこととは同じではありません。根拠と、原因に対処したかを尋ねましょう。
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.
最後の一行が重要です。優れたバグ調査は、これが一度きりのものではなくパターンの一例かを問います。
「再現できません」と言われたとき
それは失敗ではなく、有用な結果です。エージェントは何を試し、何を観察したかを伝えます。そこから環境を絞り込む、バグを引き起こす入力を渡す、バグがありそうな箇所の状態を記録する計装を依頼する、といった次の手を選べます。