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.
마지막 문장이 중요합니다. 좋은 버그 추적은 이것이 일회성이 아니라 패턴의 한 사례인지 묻습니다.
답이 "재현할 수 없다"일 때
그것은 실패가 아니라 유용한 결과입니다. 에이전트는 무엇을 시도했고 무엇을 관찰했는지 알려 줍니다. 거기서 환경을 좁히거나, 버그를 유발하는 입력을 제공하거나, 버그가 있을 것으로 보는 지점의 상태를 기록하도록 계측을 요청할 수 있습니다.