개발 생산성 도구 기초집LESSON 19

AI 보조 도구 활용 원칙: 질문·검토·테스트를 분리하기

난이도초급

예상 시간40분

선수지식18강 협업 준비

19강. AI 보조 도구 활용 원칙: 질문·검토·테스트를 분리하기

1. 이번 강의에서 해결할 문제

AI가 빠르게 코드를 제안해도 프로젝트 버전과 맞지 않거나 존재하지 않는 API, 보안상 위험한 예시를 만들 수 있습니다. 질문, 변경 검토, 실행 검증을 한 단계로 뭉치지 않아야 합니다.

2. 학습 목표

3. 핵심 개념

AI는 탐색과 초안 작성의 보조 수단이지 실행 결과의 보증자가 아닙니다. 안전한 흐름은 질문 → 제안 범위 확인 → diff 검토 → 공식 문서 확인 → 빌드·테스트 → 수동 확인입니다.

프롬프트나 첨부 파일에 실제 API Key, 비밀번호, 토큰, 개인정보를 넣지 않습니다. 도구 이름, 확장 프로그램, API, 버전처럼 변할 수 있는 정보는 해당 제품의 공식 문서에서 현재 상태를 확인합니다.

4. 단계별 실습

Markdown · 파일 경로: docs/ai-request-template.md

docs/ai-request-template.md
# AI 작업 요청

## 목표
- 점수 계산 함수에 연속 성공 보너스를 추가한다.

## 현재 환경
- Windows 11, Node.js 버전은 `node --version` 결과
- 기존 테스트: `tests/score.test.js`

## 제약
- 새 패키지 추가 금지
- 공개 API 변경 금지
- 비밀 정보 사용 금지

## 원하는 결과
- 먼저 변경 계획과 위험을 설명한다.
- 수정 파일을 최소화한다.
- 정상·경계·실패 테스트를 추가한다.

## 완료 기준
- `npm.cmd run check` 성공
- 빠른 반복 실행 체크리스트 통과

Markdown · 파일 경로: docs/ai-verification-checklist.md

docs/ai-verification-checklist.md
# AI 제안 검증
- [ ] 요청하지 않은 파일·설정 변경이 없는가?
- [ ] 새 패키지와 API가 실제로 존재하고 현재 버전과 맞는가?
- [ ] 입력 검증과 오류 처리가 있는가?
- [ ] 비밀 정보·개인정보가 포함되지 않았는가?
- [ ] diff를 직접 읽었는가?
- [ ] 빌드·테스트·수동 확인을 직접 실행했는가?

PowerShell · 실행 위치: 프로젝트 루트

git diff --check
git diff --stat
npm.cmd run check

예상 결과: AI가 제안한 범위를 사람이 확인하고 프로젝트 검사 결과가 성공합니다. 명령 성공 전에는 제안을 완료로 표시하지 않습니다.

5. 도구와 설정이 동작하는 이유

구체적인 제약과 완료 기준은 가능한 해법의 범위를 줄입니다. diff 검토는 요청 밖 변경을 찾고, 공식 문서는 버전 사실을, 테스트는 실제 동작을 각각 검증합니다. 서로 다른 검증 수단을 분리해야 한 도구의 오판이 그대로 배포되지 않습니다.

6. 자주 하는 실수와 해결법

7. 직접 실습

8. 이해 점검 질문 3개

9. 핵심 요약

MINI QUIZ