AI 프로그래밍 보조 보모 수준 튜토리얼: 코드 완성부터 에이전트 모드의 효율적인 사용까지

🛒 개발자의 경우 재사용 가능한 방법 세트를 사용하여 AI 프로그래밍 도우미를 실제로 효율적으로 사용할 수 있습니다.

튜토리얼 목표

이 자습서에서는 AI 프로그래밍 도우미를 "비정기 완료"에서 "안정적인 일일 엔지니어링 도구"로 업그레이드하고 에이전트 모드에서 다중 파일 변환, 재구성 및 테스트 생성을 마스터하는 데 도움이 되는 Cursor 및 GitHub Copilot을 예로 사용합니다.

준비 체크리스트

  • [ ] VS Code 또는 Cursor를 설치합니다(이 자습서에서는 Cursor를 예로 사용합니다).
  • [ ] 계정에 로그인하여 무료 할당량/구독 상태를 확인하세요.
  • [ ] Git에서 관리하는 샘플 프로젝트입니다. (먼저 연습한 후 실제 웨어하우스를 사용하는 것이 좋습니다.)
  • [ ] Node/Python 및 기타 실행 환경은 이미 로컬에서 사용할 수 있습니다(테스트 검증 실행에 사용).
  • [ ] 코드 베이스의 구조(항목, 종속성, 테스트 명령)를 이해합니다.

1단계: 설치 및 기본 구성

  1. Cursor(또는 VS Code + Copilot 플러그인)를 다운로드하여 설치합니다.
  2. 계정에 로그인하고 설정에서 모델 및 완료 스위치를 확인하세요.
  3. 샘플 프로젝트를 열고 웨어하우스 루트 디렉터리의 키 파일(README, 인터페이스 문서)을 표시되도록 유지합니다.

제안 설정: "자동 완성(탭)" 및 "코드 검토" 기능을 켭니다. '모든 제안 자동 수락'과 같은 위험도가 높은 옵션을 끄세요.

2단계: 세 가지 기본 사용법 익히기

  1. 인라인 완성: 함수 이름이나 설명을 입력하고 Tab을 눌러 제안을 수락합니다.
  2. 대화 상자 질문: ⌘ + L 대화 상자를 열고 코드 조각을 붙여넣은 다음 "이 코드에 무슨 문제가 있나요?"라고 질문하세요.
  3. 코드 작업 선택: 코드 조각을 선택하고 마우스 오른쪽 버튼을 클릭한 후 "설명/리팩터링/테스트 생성"을 선택합니다.

핵심 아이디어: 단순히 "나를 위해 작성"하는 것이 아니라 AI 컨텍스트를 제공합니다. 먼저 관련 파일을 선택하거나 인터페이스 서명을 게시하세요.

3단계: 고품질 프롬프트 단어 작성

잘못된 프롬프트 단어: 나를 위한 로그인 인터페이스 작성.

좋은 프롬프트 단어의 예:

``텍스트 src/auth/login.ts에 로그인 인터페이스를 구현합니다.

  • 입력 매개변수: { 사용자 이름, 비밀번호 }
  • 검증 : bcrypt를 이용한 비밀번호 비교
  • JWT가 성공적으로 반환되었으며 만료 시간은 2시간입니다.
  • 실패하면 401 및 오류 코드가 반환됩니다.
  • 프로젝트의 기존 오류 처리를 따릅니다(src/utils/errors.ts 참조).
  • 동시에 단위 테스트 생성

세 가지 핵심 사항: 명확한 목표, 경계 지정, 기존 코드 식별.

4단계: 에이전트 모드를 사용하여 여러 파일 수정

Composer/Agent 모드로 들어가려면 커서에서 ⌘ + I를 누르고 다음을 입력하십시오.

``텍스트 주문 모듈의 금액 계산을 독립적인 도구 기능으로 추출하여 src/utils/money.ts에 배치합니다. 기존 명명 스타일을 유지하면서 모든 호출 지점을 업데이트하고 단위 테스트를 추가합니다.


에이전트가 여러 파일을 편집합니다. 이때 다음 사항을 확인하세요.

1. 독립된 지점에서 운영됩니다.
2. 한 번의 클릭으로 상담원의 차이점을 모두 수락하는 대신 하나씩 검토하세요.
3. 테스트를 실행하여 회귀가 없는지 확인합니다.

## 5단계: AI가 테스트를 생성하고 수정하도록 돕습니다.

- 테스트 생성: src/utils/money.ts에 대한 `경계 조건을 포함하는 단위 테스트 생성`.
- 복구 실패: CI 오류 메시지를 AI에 게시합니다: 'Test xx failed, 오류는 다음과 같습니다... 근본 원인을 찾아 수정하십시오'.

경험: "오류 보고서 + 관련 문서 + 예상되는 동작"을 함께 게시하면 단순히 오류 보고서를 게시하는 것보다 성공률이 훨씬 높습니다.

## 6단계: 프로젝트 수준 사양 설정(.cursorrules)

AI 출력이 팀 스타일에 맞도록 프로젝트 루트 디렉터리에 '.cursorrules'를 만듭니다.

``텍스트
- 프로젝트 언어: TypeScript, 엄격 모드 사용
- 오류 처리: src/utils/errors.ts에서 ApiError 통합 사용
- 이름 지정: 함수 동사는 PascalCase 구성요소로 시작됩니다.
- 제출 전 eslint 및 prettier를 통과해야 합니다.
- 모든 새로운 로직에는 단위 테스트가 있어야 합니다.

저장 후 새 세션이 자동으로 적용되며 팀의 통일된 사양을 공유 창고에 배치할 수 있습니다.

7단계: 검증 및 보안 경계

확인 체크리스트:

  • [ ] 완성 제안은 Tab에서 허용되며 문법적으로 정확합니다.
  • [ ] 프롬프트 단어는 사양을 충족하고 실행 가능한 코드를 안정적으로 생성할 수 있습니다.
  • [ ] 에이전트는 수정 후 테스트에서 완전히 녹색입니다.
  • [ ] 민감한 정보(키, 인트라넷 주소)는 Cloud AI에 절대 붙여넣지 않습니다.

보안 빨간색 선: 기밀 코드를 붙여넣지 않고, 민감한 창고에서 공유 세션을 열지 않으며, 상담원이 트렁크에 직접 푸시되지 않습니다.

8단계: 매일 효율적인 작업 흐름 조합

분산된 사용법을 "표준 작업"으로 결합하면 효율성이 가장 확실하게 향상됩니다.

  1. 요구 사항 획득 → AI를 사용하여 작업 목록과 인터페이스 경계를 분해합니다.
  2. 코드 작성 → 관련 파일을 선택하고 Agent를 사용하여 구현의 첫 번째 버전을 생성합니다.
  3. 자체 테스트 → AI가 단위 테스트를 생성하고 실행하도록 합니다.
  4. 공동 디버깅 → 오류 보고서를 AI에 게시하여 근본 원인을 찾아 수정합니다.
  5. 마무리 → AI가 변경 지침을 생성하고 정보를 커밋하도록 합니다.

이 조합을 사용하면 매일 1~2시간을 절약할 수 있습니다. 핵심은 "모든 단계에서 명확한 입력과 수용"입니다.

흔히 발생하는 실수와 주의사항

  1. 클릭 한 번으로 에이전트의 모든 차이점을 수락합니다. 하나씩 검토하고 테스트가 모두 녹색인 경우에만 병합하세요.
  2. 맥락을 밝히지 않고 질문하세요. 먼저 파일을 선택하거나 인터페이스 서명을 붙여넣으세요.
  3. AI에 키 게시: 이는 보안 레드라인이며 엄격히 금지됩니다.
  4. AI 수정 후 테스트를 실행하지 마세요. 모든 AI 수정은 테스트를 통해 검증되어야 하며 맹목적으로 믿을 수 없습니다.
  5. 프롬프트 단어는 변경되지 않습니다. 효과가 감소하면 주도적으로 템플릿을 반복하십시오.

확인 방법

  • 확인 1: 완성 제안은 Tab으로 허용될 수 있으며 문법적으로 정확합니다.
  • 검증 2: 프롬프트 단어는 사양을 만족하고 실행 가능한 코드를 안정적으로 생성할 수 있다.
  • 확인 3: 수정 후 에이전트가 완전히 녹색입니다.
  • 확인 4: Cloud AI에 민감한 정보(키, 인트라넷 주소)를 붙여넣은 적이 없습니다.

자주 묻는 질문 및 문제 해결(FAQ)

  1. 완료하면 항상 정크 코드가 암시됩니까?

    더 많은 컨텍스트(파일 선택, 인터페이스 붙여넣기)를 제공하고 '.cursorrules'를 사용하여 스타일을 제한하고 필요한 경우 더 강력한 모델로 변경하세요.

  2. 에이전트가 파일을 손상시킨 경우 어떻게 해야 합니까?

    Git을 사용하여 파일을 롤백합니다: git checkout <file>; "변형 전 가지를 자르고 변신 후 하나씩 검토하는"습관을 기릅니다.

  3. 프롬프트 단어 효과가 불안정합니까?

    "목표, 경계, 기존 코드, 예상 검증"의 4가지 요소를 적어보세요. 효과가 좋지 않으면 다른 말로 다시 시도해 보세요.

  4. 무료 할당량이 충분하지 않습니까?

    AI가 "테스트 생성, 코드 해석, 주석 작성"과 같은 빈도가 낮은 작업을 먼저 처리하도록 합니다. 할당량이 충분할 때까지 또는 구독을 업그레이드할 때까지 고주파 리팩토링을 그대로 두십시오.

  5. 팀에서는 AI 사용 사양을 어떻게 통일하나요?

    공유 문서에 .cursorrules, 프롬프트 단어 템플릿 및 안전 제한사항을 적용하고 신규 사용자 온보딩에 포함시킵니다.

  6. 서로 다른 프로젝트의 스타일이 매우 다른 경우 어떻게 해야 합니까?

    프로젝트 간 스타일을 피하기 위해 .cursorrules를 프로젝트마다 별도로 유지하고 웨어하우스에서 균일하게 관리합니다.

요약 및 다음 단계

이제 "완료"부터 "에이전트 변환", "테스트 복구"까지의 전체 사용법을 마스터했습니다. 먼저 2~3일 동안 샘플 프로젝트로 연습한 후 실제 창고에서 위험도가 낮은 모듈로 연습하는 것이 좋습니다. 마지막으로 '.cursorrules' 및 프롬프트 단어 템플릿을 팀 자산으로 축적할 수 있습니다.

고도화 및 확장

  • 명령줄 에이전트: Claude Code를 사용하여 터미널에서 일괄 재구성을 완료합니다.
  • 자동 검토: AI가 자체 평가 및 검토 의견을 생성하고 최종 검토는 수동으로 수행됩니다.
  • 민영화 모델: 코드가 인트라넷을 벗어나지 않도록 하기 위해 고감도 프로젝트는 로컬 배포 모델에 연결됩니다.
  • 효율성 측정: 채택 비율 및 재작업 비율, 분기별 검토 및 반복 프롬프트 단어 자산을 기록합니다.

사용자 후기

  • 후기를 불러오는 중...