목차(클릭하세요)
한글 작업시 토큰 소모와 시간 낭비를 줄이는 가장 확실한 해결책: Skill
여기서는 조금 괴랄한 형태의 한글문서 작업까지 AI가 대체할 수있을까? 에 대한 답을 얻을 수 있음
[참고 영상]
Ⅰ. 한글 문서 자동화의 개념과 준비(with Skill)
26년 10월 현시점, 대부분의 프론티어 모델로 hwpx작업이 가능함.
단, 초기 셋팅시에 많은 시간과 에이전트의 상태에 따라 과도한 스크립트 파일(.py)가 생성되어 토큰과 시간을 낭비할 수 있고, 그것을 줄이기 위해 스킬을 사용하는 것임을 잊지 말자!1-1. 한글 스킬화를 하는 이유? 해야 하는 상황?
•
한국의 수능문제, 특히 수학 영역의 경우 해당 문제를 pdf로 제공하고 있는데, 이걸 한글파일로 편집하기 위해 복사-붙여넣기를 실행한다면?
•
아래 그림의 박스친 부분을 pdf에서 한글파일로 옮기는 작업을 진행할 경우?
오른쪽 한글hwpx처럼 깨지는 것을 확인할 수 있음•
레이아웃 문제와 함께 수식을 바로 붙여넣을 수 없는 문제
1-2. 한글 자동화의 목표
•
목표는 문항·이미지·서식을 하나의 한글 문서로 완성하는 것
◦
문항 생성에 그치지 않고 그래프와 도형을 포함한 문제지를 HWPX로 제작함.
◦
참고 문서의 서식을 분석하고 새로운 내용을 배치함.
•
실제로 평가원 문제를 hwp로 변형하여 돈을 받고 파는(?)사이트가 존재
•
이걸 이 돈주고 다운로드 하는게 맞는가? 원래 문제에 대한 저작권은 평가원에 있을 텐데..
•
평가원에서 저작권관련 문제를 제기하면 문제가 될만한 소지가 보임
1-3. 모델의 역할분담 역할
•
역할 분담 필요성: Claude Code자체는 이미지 생성 기능이 없기에 수학과목에서 필요한 이미지 생성에는 Codex나 gemini nanoBanana모델을 붙여야 함
•
코덱스를 사용하는 경우에는 하나의 서비스에서 결과물을 받아볼 수 있음
정리하면?
1.
코덱스 사용할 경우: 문항작성 + 문제에 필요한 이미지 생성 통합
2.
클로드 코드를 사용할 경우: 문항작성은 클로드 코드, 이미지생성은 다른 이미지 생성AI활용
•
문항 작성과 문서 제작 과정
◦
참고 자료 탐색과 문항 작성
◦
HWPX 내부 구조 분석
◦
이미지 요구사항 작성
◦
이미지 삽입과 문서 생성
◦
생성 결과 검수와 수정
•
수학 수식, 수능형 복잡한 도식화, 이미지 파일은 필요한 이미지를 제작함.
◦
문항 조건에 맞는 그래프·도형 생성
◦
라벨과 구성 요소 수정
◦
지정한 폴더에 결과 이미지 저장
1-2. 프로젝트 폴더설정
•
문서 종류나 과목별로 프로젝트 폴더를 구성함.
◦
수학 문제지와 영어 문제지처럼 작업 목적에 따라 구분함.
◦
참고 양식, 문항 데이터, 이미지, 생성 코드와 결과물을 관리함.
◦
중간 스크립트 파일이 많이 생기기 때문에 로컬컴퓨터에서 폴더를 만들고 관린하는 것이 매우 주요함
•
아래 그림과 같이 전용 작업 폴더 설정 후 코덱스에서 실행
◦
최근 3개년 수학영역의 기출문제지를 준비했음
Ⅱ. 문항·이미지·서식을 결합한 HWPX 제작
2-1. 3개년도 문항을 모두 담은 기출집 파일 제작
•
먼저 3개 문항을 읽을 수 있는지 점검
•
단순히 문항을 읽는 것이 목적이 아니고, 분석하는 것이 목적
pdf스킬을 사용해 pdf문제를 읽고 기출문제 특이점, 문항 유형별 특징을 분석해봐
JavaScript
복사
•
pdf스킬을 따로 말하지 않아도, 알아서 pdf 스킬을 호출함
2-2. 원본 프레임을 깨지 않고 한글파일로 이식&변환하기
우리 목표에서 가장 문제가 되는 것은 수능형 문제hwpx의 레이아웃•
문제를 만드는데 걸리는 시간보다 레이아웃에 맞게 문제를 배치하는 과정에서 Agent가 보다 많은 시간을 잡아 먹기도 함
•
2번째 작업은 해당 3개년 기출문제를 hwpx로 만드는 것
•
양식을 주지 않고 만들수도 있지만 너무나 많은 시간과 토큰이 소모될 수 있으므로 오르비 평가원 양식을 첨부하는 것을 추천
•
주의해야할 사항은 크게 4가지 정도
◦
원본 문서구조와 프레임을 깨지 말것(원본 배치와 구조를 보존)
◦
이미지와 수식을 그대로 가져올것
◦
수식은 사용자가 편집 가능한 형태로 한글의 수식을 통해 작성할 것
[예시 프롬프트]
한글 스킬을 사용해서 3개년 문항을 모두 합쳐 하나의 hwpx파일로 만들꺼야. 다음 4가지 사항 꼭 지켜봐
- 원본 문서구조와 프레임을 깨지 말것
- 이미지와 수식을 그대로 가져올것
- 수식은 사용자가 편집 가능한 형태로 한글의 수식을 통해 작성할 것
- 일반 본문이 이미지로 들어가면 안되고, 일반 본문도 모두 텍스트 편집이 가능해야 함
JavaScript
복사
•
실행 결과 확인
◦
첫 시도에서 25학년도와 26학녀도 문제는 한번에 성공하였으나, 24년도에서 다소 문제가 발견되어 수정을 진행함
•
3개년 수리영역의 수식이 약 1600개라니..
•
작업에 걸린 시간: 대략 45분
•
추출되는 함수, 수식을 검수해보면 중간 중간 오류가 조금씩 발견됨
◦
이런 과정을 한번 검증해줘야 수식을 제대로 추출해낼 수 있음
•
특히 괄호 부분이 한번씩 어긋나는 경우가 발생됨
•
이렇게, Agent가 자주 실수하는 부분에 대해서는 교차검증, 후검증을 할 수 있도록 나중에 스킬에 저장해야 함
2-3. 그래프·도형 생성과 검수
•
무엇보다 pdf상태에서는 편집이 불가했던 그림을 잘 그려왔는지 체크하는 것이 필요
•
기출변형문제를 낼때 가장 필요한 기능이 바로 이것
•
이미지 제작 전에 작업 명세서를 작성함.
◦
함수식과 표시할 범위
◦
좌표·교점·도형의 조건
◦
필요한 라벨과 기호
◦
이미지 크기와 해상도
◦
결과 파일 형식과 저장 위치
•
어떤 이미지 생성방법을 택할 것인지?
◦
그래프와 같은 이미지는 명시하지 않을 경우 종종 Matplotlib과 같은 라이브러리로 생성되기에 다소 한글깨짐과 같은 오류가 생길 수 있음
◦
따라서 코덱스의 경우 image gen으로 생성하는 것이 무난함.
2-4. 최종 결과물 확인
•
약 1시간 정도 걸림
•
사용된 모델이 GPT-6.1sol, 추론 강도 Medium임을 감안하면, 아스트라로 진행시 1번에 성공했을거라는 예상이
•
왼쪽이 pdf, 오른쪽이 추출된 것으로 만들어진 hwpx파일
[첨부파일]
[수식 오류없이 문제를 추출했는지 클로드코드 검증 결과]
•
검증을 통해 발견된 오류는 다음번에 또 동일오류를 발생시킬 수 있으므로, 해당 Agent에게 실수하지 않도록 기억을 시키는 것이 필요
•
클로드 검증 결과:
수식 1,598개는 대부분 원본과 일치했지만, 원문 내용이 바뀐 오류 6건과 조판(배치·서식) 오류 여러 종류 발생
2-5. 응용 문제 생성
[예시프롬프트]
26학년도 7번 문항과 같은 수학Ⅱ, 정적분의 활용(두 곡선 사이의 넓이)에 대한 응용, 변형 문제를 3개 출제해봐
JavaScript
복사
[원래 7번 문항 특성]
항목 | 내용 |
단원 | 수학Ⅱ, 정적분의 활용(두 곡선 사이의 넓이) |
배점·난이도 | 3점, 하 |
평가 요소 | 교점으로 적분 구간 정하기, 위아래 관계 판단, 다항함수 정적분 계산 |
출제 의도 | 두 곡선 사이 넓이 공식 ∫(위 − 아래)dx를 바로 적용할 수 있는지 확인 |
Ⅲ. 제작 과정을 skill패키지로 재사용(AGENTS.md포함)
이 과정은 반드시 몇 번의 테스트와 검증을 거친 다음에 하는 것이 필요 스킬은 한번에 원하는 결과가 나오지 않고, 계속적으로 가이드닝을 통해 업그레이드 해나가는 것이 필수3-1. 성공한 작업을 매뉴얼로 남기는 이유
•
최초 제작시 Agent의 탐색과 시행착오가 포함
◦
참고 양식 분석
◦
pdf파일 분석
◦
문서 생성 방법 구성
◦
이미지 제작 조건 정리
◦
오류 수정과 결과 확인
•
매번 처음부터 시작하면 같은 작업을 반복함.
◦
이미 분석한 문서 구조를 다시 조사함.
◦
파일 위치와 제작 규칙을 다시 설명함.
◦
같은 오류가 재발생할 수 있음
◦
시간과 토큰 사용량이 늘어날 수 있음.
3-2. 스킬 패지키
•
스킬 이름은 ‘math_exam'이라고 설정
•
기존의 한글문서 스킬과 연계성이 있음
◦
정확히는 한글문서 스킬 위에서 작동하는 스킬
•
다른 디바이스에서도 이 과정을 동일하게 반복하기 위해서는 스킬 패지키가 필요
•
스킬패키지을 만드는 예시 프롬프트
지금 우리 과정을 스킬화 할꺼야. 스킬명은 'math_exam'
이 스킬은 기본적으로 한글 스킬이 필요한데, 한글 스킬이 깔려있지 않은 컴퓨터에서도 실행가능하도록 필요한 예시 양식과 스크립트도 준비해
지금까지의 작업을 스킬화 할꺼야. 단순 스킬이 아니야. 폴더통째로 다른 디바이스에 복사하여 동일한 결과를 얻을 수 있는 스킬패지키 형태로 폴더째 압축할 수 있도록 준비해
해당 스킬은 코덱스, 클로드코드, 안티그래비티 등에서 모두 사용할수 있도록 대비해
1. 스킬 트리거는 너가 적절히 작성
2. 기존에 설치되어있는 한글 스킬 중에 이 스킬에 필요한 최소 스크립트만 첨부
3. 수능형 문제 양식은 form에 있는 양식을 기본베이스로, 사용자가 첨부할 경우에는 그것에 맞춰서 작업
4. 스킬에는 응용,변형문제를 생성하라고 할때, hwpx로 바로 만드는 것도 포함시켜
5. 이 스킬을 통해 수능형 수학문제는 이미지를 포함해서 편집가능한 hwpx 형태로 만들어질 수 있도록(사용자가 예시문항을 주거나, 문제 주제를 준다면)
스킬 패키징 시작해
JavaScript
복사
•
단순 스킬을 만드는 것보다 예시양식, 예시 결과물들이 담겨있는 스킬 패키지 형태로 만드는 것이 보다 시행착오를 줄일 수 있음
3-3. 스킬패키지의 구성
•
스킬에는 특정 작업의 상세 절차를 정리함.
◦
참고 양식 확인
◦
문항 데이터 작성
◦
이미지 명세 작성
◦
HWPX 생성
◦
PDF 확인
◦
오류 수정과 최종 검수
3-4. 만든 스킬을 Antigravity에서 Test
•
코덱스에서 만든 스킬패키지를 Antigravity에 이식 한후, Gemini모델로도 동일한 결과를 얻을 수 있다면?
•
약 3차례 정도 수정한 스킬 패키지
Ⅳ. 어떻게 활용하면 좋을까?
4-1. 과목별로 스킬을 세분화 하는 것을 추천
•
사탐과 과탐의 경우, 수리 영역과 다른 형태의 이미지가 많이 사용됨
•
사탐 국롤: 공자왈, 맹자왈
•
사탐에서 자주 등장하는 일종의 순서도
•
과탐에 자주 등장하는 그래프
•
이렇게 과목별로 각각 자주 출제되는 양식 중 텍스트가 아닌 부분을 Agent가 실수없이 한번에 작업할 수 있도록 스킬을 고도화하는 것이 필요
4-2. (방과후 수업용)출판사의 pdf문항을 한글 양식으로 변환
•
나만의 한글 양식이 있다면 그것을 스킬에 입힐수도 있음
4-3. 최후의 테스트
•
교육과정평가원의 모의고사 pdf를 hwpx로 변환해보기
•
현재 스킬패키지는 수학에 최적화되어있어 수학문항으로 테스트
•
GPT-6.1sol로는 자잘한 오류가 발생하여 최종적으로 궁극의 아스트라 모델을 사용(추론강도는 Medium)
•
작업에 걸린 시간은? 약 46분.
•
아래 그림처럼 잘못된 수식 1~2개는 한글의 수식편집기에서 즉각적으로 수정할 수 있음
4-4. 앞으로의 과제
•
작업 시간 단축을 위한 스킬최적화
•
40분이면 1문항당 1.5분.. 이게 맞나??ㅠㅠ
•
자잘한 수정 사항들은 실제 사용자들이 사용하면서 스킬을 업데이트 하는 것이 필요
•
수식은 맞게 표현도어 있으나, 수식의 높이를 조절하는 과정에서 벡터의 화살표 윗부분이 일부 잘린 현상이 발견됨
