활동 1: 스킬 만들기 — 기존 학습지 읽기

1. 새로 만들기 전에 평소 쓰던 학습지를 펼치자

2편에서 만든 myproject01을 다시 열어 보자. AGENTS.md에는 AI가 맡을 역할, 참고할 자료, 이루려는 목표가 적혀 있다. 이제 그 지침과 이미 수업에서 쓰던 학습지 한 장을 함께 읽힌다.

교사는 학습지의 작은 칸에도 이유를 담는다. 예제 뒤의 빈칸은 풀이 공간일 수 있고, 친구의 설명을 적는 자리일 수도 있다. AI가 배치와 문장을 정리하면 교사가 그 자리를 만든 이유를 보충한다. 두 설명을 모으면 다음 자료에도 살릴 구성이 드러난다.

오늘의 결과물은 materials/lesson-input.md다. 다음 수업을 준비할 때 다시 참고할 원본 내용·구성·교사 의도의 기록이다.

이 글에서는 연수용으로 만든 분수 학습지를 분석한다. 실습에서는 아래 파일이나 자신의 자료를 열고 원본의 구성을 기준으로 진행한다.

이번 실습에서 직접 사용할 활동지

이 연수를 위해 분수 비교 연습지를 만들었다. 아래 원본 PDF를 materials에 넣고 시작하자. 설명과 예제 뒤에 부등호 쓰기 네 문항, 짝과 이야기한 내용을 적는 칸이 있다.

실습 활동지 내려받기

PDF에서 읽은 네 문항은 2/7과 5/7, 1/8과 3/8, 2/5와 4/5, 3/6과 5/6의 비교다. 다음 장에서는 같은 분모 비교를 이미 배운 학생을 위해 25~30분 탐구로 바꾼다. 3/4과 5/8을 예상하고 그림으로 비교한 뒤, 전체 크기를 바꾸어 살펴보고 친구에게 낼 문제를 직접 만든다.

작업 화면을 보며 따라 하기

왼쪽에서 파일을 보고 오른쪽 OpenCode 대화의 다음 대화를 눌러 보자. 요청, AI의 작업, 교사의 확인 순서로 진행하는 실습 예시다. 한 단계씩 살펴보고 자신의 작업 공간에서 같은 흐름으로 진행하자.

파일이 만들어지는 과정을 직접 살펴보기

재생하면 분석 파일이 생기고 내용이 채워진다. 탐색기의 파일을 클릭해 읽고, 교사의 수정 요청 뒤 내용이 어떻게 바뀌는지 비교해 보자. 화면에서 새 활동지 원고까지 보이더라도 이는 다음 장의 미리보기다. 이번 장에서는 확인한 분석 파일을 저장하면 끝난다.

2. 같은 폴더에서 OpenCode 열기

VS Code에서는 지침과 결과 파일을 보고, OpenCode에서는 AI에게 작업을 요청한다. 처음이라면 공식 시작 안내에 따라 설치와 AI 제공자 연결을 진행한다. 연수에서는 진행자와 함께 학교의 외부 AI 이용 기준과 제공자 요금을 확인하고 준비하면 좋다. 인증 정보는 제공자가 정한 화면에 입력하고 수업 자료에는 적지 않는다.

VS Code의 터미널 → 새 터미널을 연다. PowerShell이나 macOS 기본 셸에서 pwd를 입력하면 현재 폴더의 경로가 나온다. 끝이 myproject01인지 확인한 다음 아래 명령으로 OpenCode를 실행한다.

opencode

대화 입력란이 나타나면 이후 요청문은 그곳에 보낸다. 명령을 찾지 못하면 설치 상태를 확인하고 터미널을 다시 연다. 제공자 연결은 /connect, 모델 선택은 /models에서 할 수 있다. 자세한 화면은 공식 TUI 안내를 참고한다.

2편의 AGENTS.md는 이번 프로젝트의 역할·자료·목표를 모은 지침이다. 이번에는 이 파일을 명시적으로 읽히는 방식으로 진행한다.

3. 원본 사본을 넣고 읽을 수 있는 범위부터 확인하기

탐색기에서 materials 폴더를 만들고 기존 학습지 사본을 넣는다. 공유 권한이 있고 학생 이름·필기·성적이 없는 자료를 고르자. 원본은 별도로 보관하며, 이번 작업에서는 사본의 내용도 바꾸지 않는다. 아래의 기존학습지.pdf는 예시 이름이므로 자신의 파일명으로 바꿔야 한다. HWP나 HWPX라면 확장자도 실제 파일과 맞춘다.

AI에게 보내는 요청문을 프롬프트라고 한다. OpenCode에서 @를 입력하면 파일을 찾아 대화에 참조할 수 있다. 먼저 지침을 지정하고 자료를 읽을 수 있는지 확인한다.

원본을 옆에 열고 AI가 보여 준 부분을 대조한다. PDF 읽기와 이미지 인식은 연결된 모델·도구에 따라 달라지므로, 자료에 맞는 방법을 선택하자.

텍스트로 옮긴 부분, 이미지로 제공한 부분, 교사가 설명한 부분을 기록에 구분해 둔다. 읽지 못한 문항은 원본에서 확인한 뒤 보충한다.

한글 자료를 읽을 때 rhwp 활용하기

rhwp는 HWP 5.0·HWPX의 문단·표·수식·이미지를 읽고 PDF로 내보낼 수 있는 오픈소스 도구다. OpenCode가 rhwp를 실행하면 한글 학습지의 내용을 읽어 분석에 활용할 수 있다.

진행자와 함께 공식 릴리스에서 운영체제에 맞는 실행 파일을 받아 터미널에서 rhwp로 실행되도록 준비한다. AI가 외부 프로그램을 호출하는 MCP 연결을 사용하는 환경에서는 공식 MCP 안내를 따라 연결한다. 이번 실습은 실행 파일을 사용하는 방법으로 설명한다.

다음 요청의 파일명을 자신의 자료에 맞게 바꾸어 OpenCode에 보낸다.

AI가 사용할 수 있는 공식 명령은 다음과 같다. 첫 줄은 문서 내부 구조와 내용을 읽고, 두 번째는 비교용 PDF를 만든다. HWPX 자료라면 입력 경로의 확장자도 .hwpx로 맞춘다.

rhwp dump "materials/기존학습지.hwp"
rhwp export-pdf "materials/기존학습지.hwp" -o "materials/기존학습지-reference.pdf"

교사는 PDF를 열어 문항 순서와 표·수식을 보면서 AI의 분석에 설명을 보탠다. 변환 과정에서 경고가 나온 부분은 원본 한글 문서와 대조해 보충한다. 이제 읽은 내용을 다음 순서로 함께 정리하자.

4. 읽은 내용과 해석을 나누어 분석하기

읽기 결과를 확인했다면 학습지 전체를 어떤 순서로 사용하는지 살펴보자. 아래 요청은 새 문항을 만들기 전에 원본의 내용을 보존하는 데 초점을 둔다.

다음은 실습용 원본 분수 비교 학습지의 구성과 교사의 의도를 구별하는 예시다. 자신의 자료를 사용한다면 해당 쪽수와 문항을 직접 확인한다.

마지막 줄에서 중요한 차이가 드러난다. 넓은 칸이 있다는 것은 관찰이고, 추가 풀이 공간이라는 말은 추정이다. “그 칸은 친구의 설명을 적는 자리예요”라는 교사의 한마디가 다음 활동지에서 유지할 구성을 결정한다.

내 자료에서도 AI가 추정한 부분을 골라 보충하자. 읽지 못한 그림이 학습 목표와 연결된다면 교사가 설명하거나 지원되는 이미지로 다시 제공한다.

5. 확인한 분석을 Markdown 파일로 남기기

대화만 남기면 다음 작업에서 어떤 해석을 채택했는지 찾기 어렵다. 교사의 설명까지 반영한 기록을 Markdown 파일에 모아 두면 다음 대화에서도 같은 기준을 읽힐 수 있다. 원본의 지면을 똑같이 복제하는 대신, 내용의 순서와 관계를 제목·문단·표로 옮긴다.

수식은 LaTeX 표기로 적을 수 있다. 예를 들어 \frac{3}{4}는 분수 $\frac{3}{4}$를 나타낸다. 지금은 문법을 외우기보다 분자·분모·부등호가 원본과 같은지 살펴보자. Markdown 미리 보기의 수식 표시 여부는 도구 설정에 따라 달라지고, 나중에 HTML로 만들 때도 수식 표시 도구가 따로 필요하다.

수정한 분석을 확인한 뒤 다음처럼 저장을 요청한다.

탐색기에서 파일을 열어 원본의 문제 한 개와 수식 한 개를 직접 대조한다. 친구 설명 칸처럼 교사가 보충한 의도도 기록되었는지 읽는다. 오독이 있으면 위치와 바른 내용을 알려 고친 뒤 다시 확인한다. 다음 원고에 필요한 내용이 아직 읽히지 않았다면 해당 부분을 해결하거나 사용하지 않기로 결정하고 그 범위를 남긴다.

대화에만 분석이 있고 파일이 없다면 지정한 경로에 저장해 달라고 요청한다. 파일을 닫고 다시 열어도 확인한 내용이 남으면 이번 작업을 마친 것이다.

6. 이 분석을 다음 수업에 이어 쓰기

이제 myproject01에는 지침 AGENTS.md, materials의 원본 사본, 교사가 확인한 materials/lesson-input.md가 있다. 같은 자료를 읽더라도 원본의 사실과 수업 의도를 나누어 기록했으므로 다음 작업에서 무엇을 유지해야 하는지 말하기 쉬워졌다.

4편에서는 이 분석을 기준으로 이번 수업에서 바꾸고 싶은 점을 이야기한다. AI의 질문에 답하고 계획을 승인한 뒤 학생용 원고와 교사용 해설을 만들고, 별도 검토를 거쳐 고친다. 종이 크기와 인쇄는 원고를 확인한 다음 5편에서 다룬다.

참고 자료

• OpenCode 공식 TUI 안내
• OpenCode 도구와 외부 도구 연결
• rhwp 공식 기능·설치·CLI·MCP 안내