학생 활동지를 AI에 맡겨 세특 초안을 만들고 싶지만, 학생을 잘못 연결하거나 없는 내용을 보태면 어떡하나 걱정되셨나요?
student-record-pipeline은 활동지 읽기부터 학생별 매칭, 근거 선택, 교과세특 초안 검수, NEIS 반영까지를 한 흐름으로 묶은 Claude Code 스킬이에요. 핵심은 AI가 완성본을 대신 쓰는 데 있지 않습니다. 교사가 근거와 최종 확정을 통제하도록 설계해, 반복 업무는 줄이면서도 학생부 기록의 책임은 놓치지 않게 돕습니다.
이 글에서 배울 내용⏳ 읽기 7분
세특 AI 활용에서 먼저 막아야 할 3가지 위험
학생 활동지에서 초안까지 이어지는 7단계 흐름
형광펜 검수와 증거 대조표를 쓰는 이유
설치 전 준비물과 실제 활용 시 유의점
교과세특 AI, ‘자동 완성’보다 ‘근거 관리’가 먼저예요
학생 활동지를 한 장씩 읽고, 학생별 특징을 정리하고, 분량과 금지 표현까지 살피는 일은 시간이 많이 듭니다. 그래서 AI로 교과세특 초안을 만들고 싶어지죠. 다만 학생부는 문장이 자연스럽다는 이유만으로 넘길 수 있는 문서가 아니에요.
student-record-pipeline은 이 지점에서 출발합니다. 이 스킬은 AI가 학생 글을 알아서 골라 완성본을 내놓는 방식이 아니라, 학생 원문·교사의 판단·검수 절차를 연결하는 파이프라인을 지향해요.README
세특 초안에서 특히 조심할 3가지
학생을 잘못 연결하는 문제
활동지 파일명, 제출 순서, 활동지에 적힌 이름이 엇갈리면 다른 학생의 기록이 만들어질 수 있어요. 이 스킬은 명렬표·파일 순서·활동지 이름을 3중 대조하고, 하나라도 불확실하면 자동으로 넘기지 않고 교사에게 확인을 요청합니다.PROVENANCE
원문에 없는 내용을 채워 넣는 문제
사진이 흐리거나 학생의 문장이 짧을수록 AI는 빈칸을 자연스럽게 메우고 싶어 합니다. 하지만 세특에서는 그 자연스러움이 위험할 수 있어요. 읽지 못한 부분은 [판독불가]로 남기고, OCR 보정도 복원까지만 하도록 제한합니다.
초안을 최종본처럼 다루는 문제
이 도구가 내놓는 결과는 언제나 초안입니다. 점수·등급·석차를 본문에 넣지 않도록 점검하고, 교사가 근거와 문장을 나란히 확인해 확정한 것만 NEIS 반영 단계로 넘기는 구조예요.README
student-record-pipeline은 어떻게 움직이나요?
1. 먼저 과제의 맥락을 물어봐요
바로 활동지를 읽기 시작하지 않습니다. 과제의 목표, 평가 기준, 학생에게 기대한 활동, 문체와 분량, 명렬표, 활동지 칸 구성을 차례로 확인해요. 이렇게 모은 정보는 ‘이번 과제 설명서’가 되어 이후 판단의 기준이 됩니다.
교과나 수행평가가 바뀌면 AI에게 같은 문장을 반복해 설명하기보다, 이 맥락 문서만 새로 준비하면 돼요.
2. 활동지 형태에 맞춰 원문을 받아들여요
입력 형식은 한 가지로 고정하지 않았습니다.
구글폼 응답, 한글·워드 문서, 타이핑 텍스트는 그대로 연결합니다.
스캔본이나 사진은 사용하던 OCR 결과를 활용할 수 있어요.
별도 OCR이 없으면 AI가 사진을 보고 옮겨 적되, 맞춤법을 임의로 고치거나 미완성 문장을 완성하지 않도록 합니다.
즉, 자료를 읽는 방식은 바뀌어도 그다음의 학생 매칭·근거 선택·검수 흐름은 동일하게 유지돼요.
3. 명렬표와 활동지를 학생별로 매칭해요
이 단계는 편의 기능이 아니라 안전장치입니다. 확실하지 않은 매칭은 AI가 추측해서 통과시키지 않아요. 교사가 확인할 목록으로 남겨 두는 편이 훨씬 안전하니까요.
4. 교사가 중요한 근거를 직접 선택해요
가장 눈여겨볼 부분은 형광펜 화면입니다. 왼쪽에는 학생 원문, 가운데에는 선택한 이유를 적는 주석, 오른쪽에는 도달한 역량과 수준을 정리하는 총평이 배치됩니다.
교사는 학생 글에서 의미 있는 대목을 직접 칠하고, AI는 그 재료를 바탕으로 초안을 작성해요. 형광펜을 생략하고 AI에게 선택을 위임할 수도 있지만, 그 경우 검수에서 더 꼼꼼히 확인해야 한다는 점을 화면에서 구분해 줍니다.README
💡
팁: AI에게 ‘잘 쓴 세특’을 알아서 골라 달라고 하기보다, 교사가 어떤 근거를 중요하게 보는지 먼저 표시해 주세요. 생성 문장을 다시 고치는 것보다, 재료를 처음부터 통제하는 편이 보통 더 빠르고 안전합니다.
세특 문장과 학생 원문을 어떻게 검수하나요?
문장마다 근거를 함께 남기는 증거 ledger
이 파이프라인은 세특 문장만 만들지 않고, 문장이 의지한 학생 원문의 구간도 함께 남기는 증거 ledger 방식을 사용합니다. 검수할 때 ‘이 표현은 어디에서 나온 걸까?’를 다시 찾는 대신, 문장과 원문 스팬을 나란히 볼 수 있어요.
원문과 정확히 일치하는지, OCR 오독일 가능성이 있는 근사 일치인지, 유사한 근거조차 없는지를 구분해 표시합니다. 다만 이것은 날조를 기계가 단정하는 판결이 아니라, 사람이 먼저 살펴볼 항목을 좁히는 분류 도구라는 점이 중요해요.DESIGN-DECISIONS
기계가 확인할 일과 교사가 판단할 일
모든 검수를 AI에게 맡기지 않습니다. 문자열로 명확히 확인할 수 있는 항목은 자동 점검에 맡기고, 문맥이 필요한 판단은 교사에게 남깁니다.
자동 점검에 적합한 일
NEIS 바이트 수와 분량 상한
금지 표현, 점수·등급 언급 여부
명사형 종결이나 특수문자 같은 형식
원문 스팬과 앵커 정보의 존재 여부
교사가 최종 판단할 일
원문이 문장의 주장을 실제로 뒷받침하는지
의역·학술어 정리가 정당한지, 없던 내용을 만든 것인지
평가 맥락에 맞는 역량 표현인지
학생별 초안을 확정·보류·재작성할지
이 구분이 중요한 이유는 간단해요. 바이트 수나 금지어처럼 문자 자체가 답인 문제와, 학생의 생각을 얼마나 정직하게 해석했는지처럼 맥락이 답인 문제는 같은 방식으로 판단할 수 없기 때문입니다.DESIGN-DECISIONS
설치 전 준비물과 사용 흐름을 확인하세요
이 스킬은 Claude Code에서 사용하도록 구성되어 있습니다. Python 3과 Node.js가 기본으로 필요하고, 확정본을 NEIS 엑셀 파일에 되돌려 넣는 단계까지 쓸 때만 openpyxl을 추가로 설치하면 됩니다.
설치 방법 1: 터미널에서 바로 설치하기
터미널을 쓸 수 있다면 아래 명령 한 줄이 가장 간단합니다. 이 명령은 전체 저장소가 아니라 student-record-pipeline 스킬 하나만 설치해요. 설치가 끝나면 Claude Code를 재시작하세요.
Windows — PowerShell
Win + R을 누르고 powershell을 입력한 뒤, 아래 명령을 붙여넣어 실행합니다.