Cursor Agent 모드 사용법: 저장소 작업 주고 diff 검토

Agent를 열고 범위 있는 저장소 작업 하나를 준 뒤, 남기기 전에 diff를 직접 읽는다.

저장소는 이미 Cursor에 열려 있다. 모델이 손을 움직이길 원한다. 읽지 않은 diff 더미를 받아들이고 싶지는 않다. 공식은 이 길을 Agent 모드라고 부른다. 대화를 하나 열고, 저장소 작업 하나를 주고, 건드린 파일을 모두 읽는다.

검색되는 일은 Cursor Agent 모드 사용법이다. Agent 패널을 열고, 읽기 전용 Ask를 피하고, 범위 있는 작업을 쓴 뒤, diff 보기에서 무엇을 남길지 정한다. 아래 단축키와 검토 단계는 cursor.com/help/ai-features/agent를 따른다.

파일을 고칠 수 있는 모드를 고른다

한 바퀴: 시작, 부여, 검토

1. 01
   Agent 패널을 연다

   이미 git 저장소인 폴더에서 ⌘I(Mac) 또는 Ctrl+I(Windows / Linux). 모드가 Agent인지 확인한다. 이전 스레드가 다른 일이면 새 대화를 연다. 공식은 모드마다 맥락이 갈리며, 일이 바뀌면 새로 여는 편이 더 깨끗하다고 쓴다.

2. 02
   범위 있는 저장소 작업 하나를 준다

   결과, 파일이나 영역, 끝났다는 기준을 쓴다. 예: src/auth/session.ts에 null 검사를 넣고 기존 단위 테스트를 돌린다. 관련 없는 다섯 가지를 붙이지 않는다. 공식 예도 구체적인 한 요청이다.

3. 03
   diff 보기를 본다

   Return. Agent는 먼저 찾고, 일하면서 편집을 적용한다. 파일은 diff에 뜬다. 지명한 폴더를 벗어나면 Stop. 다음 지시는 큐에 두고 현재 실행이 끝난 뒤에 달린다.

4. 04
   읽고 남기거나 거절한다

   추가 줄과 삭제 줄을 읽는다. 원하지 않는 덩어리는 거절한다. 이전 메시지에 포인터를 두고 Restore Checkpoint로 그 이후 파일 변경을 되돌린다. 대화는 남는다. 테스트는 내가 돌린다. 에이전트 로그의 초록 한 줄을 합격으로 보지 않는다.

src/auth/session.ts에 가드를 넣는다. user id가
없으면 401을 반환한다. billing 폴더는 건드리지
않는다. 기존 session 단위 테스트를 돌리고
실패하면 멈춘다.

첫 작업이 자주 끊기는 곳

패널이 Ask에 있다

파일이 바뀌지 않는다. Shift+Tab 또는 모드 선택으로 Agent로 바꾼 뒤 같은 프롬프트를 다시 보낸다.

프롬프트에 범위가 없다

Agent는 넓게 찾는다. 디렉터리, 테스트, 고치면 안 되는 경로를 적는다.

diff 더미를 한 번에 받았다

엉뚱한 파일은 거절한다. 삭제를 본다. 모양이 틀리면 체크포인트로 돌아가고, 나쁜 패치 위에 두 번째 재작성을 쌓지 않는다.

일은 하나, 대화는 하나, 그다음 diff를 읽는다. 수락 버튼은 검토가 아니다.

출고 전에 리팩터 모양을 두 사람이 맞춰야 한다면 파일 목록과 위험한 덩어리를 한 페이지에 펼친다. 짧은 oakmeet 방으로 충분하다. 브라우저, 공간 코드, 계정 없음. 한도는 8명, 대략 한 시간.