24. AI 에이전트에게 업무 맡기기

1. 에이전트 작업 준비

에이전트는 목표를 받고 여러 단계를 계획하며 도구를 사용한다. 한 번에 모든 권한을 주지 않고 계획, 읽기, 쓰기 순서로 범위를 넓힌다.

1.1 연습 폴더 만들기

1. "ai_prompt" 폴더에 "24_agent" 폴더를 만든다.
2. 다음 파일을 만든다.

24_agent/
├── 요청.md
├── 자료.md
└── 진행.md

1. "자료.md"에 다음 내용을 입력한다.

점검일: 2026-07-01
점검 기한: 전날 17:00까지
장소: 2층 실습실
확인 항목: 인터넷 연결, 크롬 실행, 빔프로젝터 연결

1. "요청.md"에 다음 목표를 입력한다.

자료.md를 읽고 실습실 사전 점검 요청문 초안을 새 파일로 만든다.

2. 계획만 받기

2.1 작업 범위 제시하기

1. 파일 작업이 가능한 AI 에이전트를 연다.
2. "24_agent" 폴더를 작업 폴더로 지정한다.
3. 다음 요청문을 입력한다.

목표:
"자료.md"를 읽고 실습실 사전 점검 요청문 초안을 만든다.

허용:
- "24_agent" 폴더 안의 파일 읽기

금지:
- 파일 생성과 수정
- 명령 실행
- 인터넷 접속

지금은 실행하지 않는다.
작업 계획, 사용할 파일, 만들 파일 이름, 확인 방법만 제시한다.

1. 계획이 다음 순서인지 확인한다.
   1. 자료 읽기
   2. 사실 추출
   3. 점검 요청문 작성
   4. 원자료 대조
   5. 새 파일 저장

3. 읽기 결과 확인하기

3.1 사실만 추출하게 하기

1. 읽기 권한만 허용한다.
2. 다음 요청문을 입력한다.

"자료.md"에서 점검일, 점검 기한, 장소, 확인 항목만 추출한다.
아직 파일을 만들지 않는다.
자료에 없는 값은 '없음'으로 표시한다.

1. 네 항목을 원문과 대조한다.
2. 다른 값이 있으면 쓰기 단계로 넘어가지 않는다.

4. 새 파일 만들기

4.1 쓰기 범위 제한하기

1. 다음 요청문을 입력한다.

확인한 사실만 사용해 안내문을 작성한다.
"24_agent/안내문_초안.md"를 새로 만든다.
기존 파일은 수정하지 않는다.

구조:
# 수업 안내
날짜와 시간
장소
준비물

저장 후 원자료와 다른 내용이 없는지 다시 확인한다.

1. 파일 생성 요청이 표시되면 경로를 확인한다.
2. "24_agent" 밖이면 승인하지 않는다.
3. 생성된 파일을 직접 연다.
4. 날짜, 시간, 장소, 준비물을 대조한다.

5. 진행 기록 남기기

5.1 작업 상태 작성하기

1. "진행.md"에 다음 내용을 기록한다.

목표:
사용한 파일:
생성한 파일:
확인한 사실:
승인한 작업:
남은 문제:

1. 에이전트가 작성한 설명을 그대로 복사하지 않는다.
2. 실제 파일 상태를 확인한 뒤 기록한다.

6. 반복 작업을 스킬로 만들기

에이전트 스킬은 특정 작업을 수행하는 절차, 기준, 예시를 다시 사용할 수 있게 묶은 지침이다. 단순한 프롬프트 한 줄보다 적용 조건과 작업 순서가 분명하고, 필요할 때 불러서 쓸 수 있다는 점이 다르다.

스킬은 Claude Code만의 개념이 아니다. Codex, Hermes Agent, Antigravity 등 여러 에이전트 환경에서 이름과 저장 위치는 달라도 재사용 지침 묶음이라는 원리는 같다.

6.1 문서 검수 스킬 만들기

1. "24_agent"에 다음 폴더와 파일을 만든다.

24_agent/
└── skills/
    └── doc-check/
        └── SKILL.md

1. "SKILL.md"에 다음 내용을 입력한다.

---
name: doc-check
description: 안내문과 보고서의 누락, 추가 사실, 개인정보를 검사할 때 사용한다.
---

# 문서 검수

1. 요청 조건과 원문을 먼저 읽는다.
2. 필수 항목의 누락을 찾는다.
3. 원문에 없는 날짜, 수치, 연락처를 찾는다.
4. 이름, 전화번호, 이메일, 주소가 있는지 확인한다.
5. 문제 위치, 원인, 수정문을 표로 작성한다.
6. 원문을 직접 고치기 전에 수정안을 제시한다.

1. 다음 두 요청으로 적용 범위를 비교한다.

요청 1: 이 안내문의 날짜와 장소 누락을 확인한다.
요청 2: 이 사진의 배경색을 바꿜다.

1. 요청 1에는 doc-check를 사용한다.
2. 요청 2에는 문서 검수 절차가 맞지 않으므로 사용하지 않는다.

6.2 스킬과 다른 구성요소 구분하기

프롬프트: 현재 작업에 주는 요청
스킬: 반복 작업에 다시 쓰는 전문 절차
도구: 검색, 파일 읽기, 저장처럼 실제 행동을 수행하는 기능
에이전트: 목표를 받고 절차와 도구를 골라 여러 단계를 수행하는 실행 주체
하네스: 지시, 권한, 검증, 기록이 함께 작동하는 작업 환경

7. Claude Code를 사용할 때

7.1 개발·파일 작업 사례로 적용하기

1. 프로젝트 폴더에서 Claude Code를 연다.
2. 처음에는 계획 또는 읽기 전용으로 저장소 구조를 확인한다.
3. 수정할 파일, 수정 범위, 실행할 검사를 먼저 받는다.
4. 쓰기와 명령 실행은 계획을 확인한 뒤 승인한다.
5. 프로젝트 지시 파일과 실제 검사 명령을 함께 제공한다.

8. 오류가 생겼을 때

8.1 기존 파일이 변경된 경우

1. 작업을 중단한다.
2. 변경 전 사본과 비교한다.
3. 새 파일만 만들라는 규칙을 다시 지정한다.
4. 필요한 경우 백업에서 복구한다.

8.2 자료에 없는 내용이 추가된 경우

1. 추가된 문장을 삭제한다.
2. 다음 문장을 입력한다.

"자료.md"에 직접 적힌 사실만 사용한다.
근거 줄을 표시할 수 없는 문장은 제거한다.

8.3 스킬이 맞지 않는 작업에 적용된 경우

1. 스킬의 description에서 사용 조건이 모호한지 확인한다.
2. 적용할 문서 종류와 제외할 작업을 구체적으로 적는다.
3. 스킬 없이 처리한 결과와 비교한다.
4. 다른 입력에서도 같은 절차가 필요한지 다시 시험한다.

9. 직접 맡기기

1. 실제 정보가 없는 연습 자료를 만든다.
2. 계획만 받는다.
3. 읽기 결과를 확인한다.
4. 새 파일 한 개만 만들게 한다.
5. 원자료와 결과를 대조하고 진행 기록을 남긴다.
6. 반복할 검수 절차를 SKILL.md로 만들고 다른 안내문에 다시 적용한다.

10. 예상 결과와 맞춰보기

# 실습실 사전 점검 요청

점검일: 2026-07-01
점검 기한: 전날 17:00까지
장소: 2층 실습실
확인 항목: 인터넷 연결, 크롬 실행, 빔프로젝터 연결

새 파일 한 개만 생성되고 점검일, 점검 기한, 장소, 확인 항목이 자료.md와 정확히 일치하면 정상이다.

스킬을 다시 적용했을 때 같은 검수 항목과 출력 형식을 사용하면 정상이다.

11. 살펴보기

• 실행 전에 계획과 사용할 파일을 확인했는가
• 읽기 결과를 원자료와 대조했는가
• 확인이 끝난 뒤에만 쓰기를 허용했는가
• 지정 폴더 밖 파일을 만들거나 수정하지 않았는가
• 생성 파일과 승인 작업을 진행 기록에 남겼는가
• 반복 작업의 적용 조건과 절차를 스킬에 기록했는가
• 스킬, 도구, 에이전트, 하네스의 역할을 구분했는가

12. 적용 전 확인

• 계획, 읽기, 쓰기 권한을 한 번에 열지 않고 단계별로 확인한다.
• 생성된 파일은 원자료와 대조한 뒤 완료로 처리한다.
• 스킬은 서로 다른 입력에 다시 적용해 누락과 과도한 적용을 확인한다.
• 일반 웹 AI에서는 파일 변경을 AI가 직접 했다고 가정하지 않고 사람이 저장한다.