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.

마지막 문장이 중요합니다. 좋은 버그 추적은 이것이 일회성이 아니라 패턴의 한 사례인지 묻습니다.

답이 "재현할 수 없다"일 때

그것은 실패가 아니라 유용한 결과입니다. 에이전트는 무엇을 시도했고 무엇을 관찰했는지 알려 줍니다. 거기서 환경을 좁히거나, 버그를 유발하는 입력을 제공하거나, 버그가 있을 것으로 보는 지점의 상태를 기록하도록 계측을 요청할 수 있습니다.