교사용 공문작성 에이전트 teacher_doc: 작년 공문으로 올해 초안 만들기
1년에 공문 100건, 2~3일에 한 건. 이 반복을 견디지 못한 교사가 직접 AI 플러그인을 만들어 GitHub에 공개했다.
이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.
✦ KR 주제: 교사용 공문 초안·검증 AI 플러그인 teacher_doc
✦ KR 핵심 요약: teacher_doc은 작년 공문 파일을 베이스로 올해 공문 초안을 만들고 확인표로 검증하는 Codex·클로드 코드 플러그인이다. 근거가 있는 값은 제안하고 근거가 없는 값은 '확인 필요'로 묶어 묻는 구조이며, 최종 검토와 발송은 사람이 담당한다.
🌐 Global Takeaway: teacher_doc is an open-source plugin for Codex and Claude Code that turns last year's Korean school document (.hwp/.hwpx) into a next-year draft. It finds changed fields via the academic calendar, asks only about values without evidence, and leaves final review and sending to the human teacher.
아래 그림은 teacher_doc이 작년 공문을 올해 초안으로 바꾸는 다섯 단계 흐름을 보여줍니다.
1. 공문 100건의 무게 — 교사가 직접 만든 도구
1년에 공문을 100건 가까이 상신하는 교사가 있다. 2~3일에 한 건꼴로 반복되는 이 업무를 견디지 못한 교사가 직접 AI 도구를 만들어 GitHub에 공개했다. 이름은 teacher_doc, 저장소 설명은 hwp documetary for teachers로 시작하며, 작년 공문 한 파일을 주면 올해 공문 초안을 만들고 검증까지 해 주는 교사용 플러그인이다. 게시일은 2026년 11월 5일이고, 작성자는 g1_ai_teacher다. 개발자는 스레드 원문에서 AI가 초안이 아니라 완성본에 가까운 공문을 써 줬으면 했다는 제작 동기를 직접 밝혔다.
이 도구는 독립 실행 파일이 아니다. Codex나 클로드 코드 같은 코딩 에이전트의 대화창에 붙이는 플러그인 형태로 배포되며, 양식 등록이나 설정 파일 작성 없이 동작한다. 모든 작업은 대화창에 문장을 입력해 부탁하는 방식이다. 저장소에는 현재 42개의 커밋이 쌓여 있고, 문서 작업을 위한 스킬과 스크립트, 테스트 코드가 디렉터리별로 정리되어 있다.
대상 사용자는 세 부류로 안내되어 있다. 작년에 낸 공문을 올해 다시 내야 하는 교사, 한글 양식은 그대로 두고 날짜·회차·학년도·담당만 바꾸고 싶은 교사, 그리고 명령어나 설정을 외우기 싫은 교사다. 공문 작성이 단순 반복 업무에 가깝다는 점을 전제로, 문서 자동화가 아니라 '초안 생성과 검증 보조'에 초점을 맞춘 설계다.
1-1. 확인된 사실
| 항목 | 내용 |
|---|---|
| 저장소 | github.com/raphysicst-create/teacher_doc |
| 성격 | Codex·클로드 코드용 교사용 문서 플러그인 |
| 입력 파일 | 작년 공문(.hwp 또는 .hwpx) |
| 출력 결과 | 올해 공문 초안과 검증용 확인표 |
| 실행 환경 | Codex 또는 클로드 코드 대화창 |
| 최종 책임 | 최종 검토와 발송은 사람이 수행 |
AI가 초안이 아니라 완성본에 가까운 공문을 써줬으면 좋겠다 — 개발자가 스레드에서 밝힌 제작 동기다. 다만 실제 구현은 완성본 자동 발송이 아니라, 사람이 확인할 수 있는 초안과 확인표를 만들어 주는 방향으로 설계되어 있다.
2. teacher_doc이 하는 일과 하지 않는 일
teacher_doc의 본질은 '문서 생성기'가 아니라 '문서 검토 보조 도구'다. 작년 공문이라는 이미 검증된 양식을 베이스로 삼아, 올해 바뀌어야 할 값만 골라내고 선생님의 확인을 받는 구조다. README가 명시하듯 최종 검토와 발송은 사람이 하며, 에이전트가 대신 공문을 제출하는 일은 없다.
하는 일을 정리하면 다음과 같다. 첫째, 작년 공문 파일을 입력받아 올해 버전의 초안을 만든다. 둘째, 학교를 처음에 한 번만 확인한 뒤 올해 학사일정을 가져와 날짜·회차·학년도 같은 변동 값을 대조한다. 셋째, 작년 문서에서 바뀔 칸을 찾아 확인표를 작성하고, 근거가 있는 칸에는 값을 제안하며 근거가 없는 칸은 '확인 필요'로 묶어 한 번에 질문한다. 넷째, 선생님의 답을 반영한 초안을 보여 준다.
하지 않는 일도 분명하다. 양식 등록이나 설정 파일 작성은 요구하지 않으며, 명령어를 외울 필요도 없다. 대화창에 문장을 입력하는 것만으로 설치부터 실제 문서 작업까지 진행된다. 또한 AI가 학사일정을 조회하고 문서 안의 바뀔 칸을 분석하는 과정은 에이전트가 수행하지만, 최종 판단과 발송 행위는 사람의 몫으로 남겨져 있다. 공문은 학교 행정 문서이므로, 이 책임 소재의 분리가 도구의 핵심 설계 원칙이다.
3. 작동 원리 — 확인표 중심의 문서 파이프라인
실제 사용 흐름은 다음 순서로 진행된다. 1단계에서 선생님은 작년 공문과, 있으면 올해 관련 공문을 작업 폴더에 둔다. .hwp든 .hwpx든 그대로 넣으면 된다. 2단계에서 대화창에 문서 작업을 부탁하면, 에이전트가 학교를 처음에 한 번만 확인하고 올해 학사일정을 가져온다. 3단계에서 작년 문서 안에서 바뀔 칸을 찾아 확인표를 만든다. 4단계에서 근거가 있는 칸은 값을 제안하고, 근거가 없는 칸은 '확인 필요'로 묶어 한 번에 묻는다. 5단계에서 선생님의 답을 반영한 초안을 보여 주고, 6단계에서 선생님이 최종 검토 후 발송한다.
이 흐름에서 눈에 띄는 장치는 확인표다. 공문 실수의 대부분은 새로 쓴 문장이 아니라 날짜·회차·학년도·담당 같은 반복값에서 발생한다. 에이전트는 이 값들을 학사일정과 대조해 근거가 있는 것은 값을 채워 제안하고, 근거를 찾지 못한 것은 추측하지 않고 '확인 필요'로 분류한다. 선생님은 확인표에서 맞는지만 보면 되므로, 문서 전체를 다시 읽으며 검토하는 부담이 줄어든다.
3-1. 확인표가 핵심 장치인 이유
AI 문서 도구의 흔한 실패는 그럴듯한 문장을 만들어 내면서 틀린 값을 섞어 넣는 것이다. teacher_doc은 이 문제를 구조로 해결한다. 값을 제안할 때는 학사일정 같은 근거를 붙이고, 근거가 없으면 아예 제안하지 않고 질문으로 돌린다. 결과적으로 선생님이 검토해야 할 범위는 문서 전체가 아니라 '확인 필요'로 묶인 칸들로 좁혀진다. 초안은 참고 자료이고, 확인표가 실제 작업 단위인 셈이다.
4. 설치와 첫 사용 — 대화창에 문장 한 줄
설치는 코딩 지식 없이 진행되도록 설계되어 있다. 파일을 다룰 수 있는 Codex 또는 클로드 코드 대화에 설치 요청 문장을 붙여 넣으면, 에이전트가 저장소를 읽고 설치부터 첫 연습 문서 생성까지 수행한다. 요청 문장에는 Python 포함 설치, 저장소와 설치 안내 읽기, 문서와 분리된 작업 폴더에서 기본 XML 점검과 첫 연습 문서 생성까지 포함하도록 지시한다.
git clone https://github.com/raphysicst-create/teacher_doc
Python 3.12가 없으면 공식 Astral uv와 CPython 배포본을 teacher_doc 전용 폴더에 받아 설치할 수 있다. 전역 PATH·레지스트리·보안 정책은 바꾸지 않는다고 명시되어 있어, 기존 개발 환경을 건드리지 않는다. 설치가 끝나면 작업 폴더에 개인정보가 없는 연습 HWPX가 생기며, 한글 프로그램이 없어도 설치와 연습 문서 생성까지는 가능하다. 학교 정보 서비스도 이 설치 과정에서 함께 등록된다.
4-1. 첫 실행 시 필요한 승인
실제로 쓰려면 두 가지 승인이 필요하다. Codex로 사용하려면 작업 폴더를 한 번 신뢰해야 하고, 클로드 코드로 사용하려면 첫 사용 때 뜨는 MCP 서버 승인에 동의해야 한다. 막혔을 때의 대처 방법과 세부 순서는 README의 '처음 시작하기' 문서에 정리되어 있다. 설치 후에는 결과 파일과 미확인 항목을 알려 달라고 요청할 수 있어, 무엇이 만들어졌는지 확인하는 절차가 포함되어 있다.
5. 파일 형식과 실제 사용법
지원 입력 형식은 .hwp와 .hwpx 두 가지다. 작년 공문 파일을 그대로 주면 되며, 별도 변환 작업을 선생님이 할 필요가 없다. 다만 .hwp 파일은 Windows에 한글이 설치되어 있는 환경에서만 에이전트가 HWPX 사본으로 바꿔 작업할 수 있다. 이 경우 원본 .hwp 파일은 그대로 보존되고, 작업은 사본에서 이루어진다. 한글이 없는 환경에서는 설치와 연습 문서 생성까지 가능하지만, 실제 공문 작업은 Windows와 한글이 있는 환경을 전제로 한다.
매번 사용하는 절차는 단순하다. 작년 공문과, 있으면 올해 관련 공문을 작업 폴더에 둔 뒤 대화로 요청한다. README의 예시 요청 문장은 '작년문서.hwpx를 베이스로 2026학년도 2학기 ○○ 계획을 만들어줘' 형태다. 베이스 파일과 학년도·학기·문서 종류를 문장으로 지정하면, 에이전트가 나머지 절차를 진행한다. 공문마다 양식을 새로 등록하거나 설정을 바꿀 필요가 없다는 점이 반복 업무에 적합한 이유다.
6. 설계 의도 — '발송은 사람이'라는 원칙의 의미
teacher_doc의 설계를 관통하는 원칙은 AI의 역할을 '작성'이 아니라 '근거 제시와 검증'으로 한정한 것이다. AI가 완성본을 쓰는 대신, 작년 문서에서 바뀔 칸을 찾아내고 근거 있는 값만 제안하며, 근거가 없는 값은 질문으로 돌린다. 최종 검토와 발송이 사람에게 남아 있다는 문구는 단순한 면책이 아니라, 공문이라는 행정 문서의 책임 소재를 명확히 한 설계 결정이다.
이 구조는 반복 문서 업무 자동화의 성숙한 패턴을 보여 준다. 첫째, 진입장벽을 낮추기 위해 양식 등록과 설정 파일을 없앴다. 둘째, 교사의 부담을 줄이기 위해 확인표 하나로 질문을 묶었다. 셋째, 안전을 위해 연습 문서는 개인정보 없이 생성하고 작업 폴더를 문서와 분리하도록 안내한다. 넷째, 모든 작업을 대화 문장으로 수행하게 해 명령어 지식을 요구하지 않는다.
- 작년 파일을 열어 하나씩 변경
- 날짜·회차 실수 위험
- 표와 예산을 다시 확인
- 전체를 다시 읽으며 검토
- 베이스 파일만 지정
- 바뀔 칸을 자동으로 추출
- 근거 없는 칸만 질문
- 초안 검토 후 직접 발송
6-1. 초안보다 확인표가 중요한 이유
AI가 만든 초안을 그대로 믿을 수 없는 이유는 문장이 매끄러울수록 틀린 값이 눈에 띄지 않기 때문이다. teacher_doc은 초안을 '제안물'로 취급하고, 실제 품질을 좌우하는 확인표를 별도로 만들어 검토 범위를 좁힌다. 공문에서 가장 위험한 날짜·회차·학년도 오류가 바로 이 확인표 단계에서 걸러지도록 설계된 것이다.
7. 한계와 이 도구가 보여 주는 것
먼저 실사용 환경의 제약이 있다. .hwp 원본을 작업하려면 Windows에 한글이 설치되어 있어야 하고, Codex 사용 시 작업 폴더 신뢰와 클로드 코드 사용 시 MCP 서버 승인 절차가 필요하다. 저장소에는 LICENSE 파일이 포함되어 있지만 구체적인 라이선스 종류와 조건은 README 본문에 나와 있지 않으므로, 실사용 전 라이선스 파일을 직접 확인하는 것이 안전하다.
둘째, 도구의 범위도 명확하다. 학사일정 조회와 문서 내 변경 칸 분석, 확인표 생성, 초안 작성까지가 에이전트의 역할이며, 문서의 최종 검토와 발송은 사람의 몫이다. AI가 공문을 완성해 대신 보내는 도구가 아니라, 사람이 빠르게 검토할 수 있게 준비하는 도구다.
이 사례가 의미하는 바는 코딩 에이전트가 개발자 바깥의 직군으로 확장되고 있다는 점이다. 교사처럼 코드와 무관한 사용자가 '대화에 문장을 입력한다'는 방식만으로 문서 업무 도구를 설치하고 쓰는 구조다. 무엇보다 초안 생성보다 근거 제시와 검증에 초점을 맞춘 설계는, 생성형 AI를 업무에 도입할 때 필요한 인간 중심 패턴을 보여 주는 참고 사례다.
자주 묻는 질문
Q. teacher_doc은 무료로 쓸 수 있나요?
A. 확인된 자료에는 가격 정보가 없으며, 저장소에는 LICENSE 파일이 포함되어 있습니다. 구체적인 라이선스 종류와 조건은 README 본문에 나와 있지 않으므로 실사용 전 라이선스 파일을 직접 확인하는 것이 좋습니다.
Q. 한글 프로그램이 없어도 사용할 수 있나요?
A. 설치와 개인정보 없는 연습 HWPX 생성까지는 한글이 없어도 가능합니다. 다만 .hwp 원본을 실제 작업 문서로 쓰려면 Windows에 한글이 설치되어 있어야 에이전트가 HWPX 사본으로 변환해 작업할 수 있습니다.
Q. AI가 공문을 자동으로 작성해서 보내주나요?
A. 아닙니다. teacher_doc은 초안 생성과 검증용 확인표 작성까지를 담당하며, 최종 검토와 발송은 사람이 수행한다고 README에 명시되어 있습니다.
Q. 어떤 파일을 준비해야 하나요?
A. 작년 공문 파일(.hwp 또는 .hwpx)을 작업 폴더에 두면 됩니다. 있으면 올해 관련 공문도 함께 두고, 대화창에 베이스 파일과 학년도·학기·문서 종류를 문장으로 지정해 요청합니다.



댓글 0개