blueshadow62/korean-school-records-toolkit / skills/write-school-records
write-school-records
Verified한국 중·고교 교사의 실제 관찰·평가 근거로 학생부 세특·창체 특기사항·행특·중학교 자유학기활동 특기사항을 초안·첨삭·점검·근거 분석한다. "세특 써줘", "창체/행특 다듬어줘", "학생부 금지사항·분량 점검", "새 학년도 기재요령 등록·활성화·롤백" 요청에 사용한다. 일반 교정·가상 기록·대학 합격 예측·입시 최적화에는 사용하지 않는다.
학교생활기록부 기재 도우미
빠른 경로
- 요청 영역과 작업 모드(초안·첨삭·점검·분석)를 분류한다. 생성 요청은 학생 자료 기반 초안 생성을 기본으로 한다.
- 초안·첨삭 요청에서 학교급을 알 수 없으면 아래 「학교급 확인」대로 먼저 묻는다.
- 학생별 사실, 공통 수업·평가 맥락, 성취기준 해석, 보조 렌즈를 분리하고 학생별 근거 수준을 내부적으로 자동 판정한다. 이 순서로 근거를 우선하며 낮은 순위 자료가 학생별 사실을 덮어쓰지 않는다. 입력 열·필드의 출처 유형 매핑은 intake-template.md를, 서식 없는 교사 메모의 출처는 아래 「작성 절차」를 따르며, 어느 쪽으로도 출처가 정해지지 않은 자료는 출처 미확인으로 보수 판정한다.
- 공식 기록의 초안·수정·최종 점검이면 아래 표에서 해당 영역 파일 하나를 읽는다. 기재요령은 기재 가능 여부·금지·입력 주체·분량을 확인하는 기준이며 학생의 활동이나 역량을 만들지 않는다.
- 기재요령 확인이 필요하면 학교급에 맞는 요약(고등학교 guidelines/summary.md, 중학교 guidelines-middle/summary.md)에서 해당 절만 읽는다. 분량은 요약의 최대 글자수 표를 쓴다. 원문 변환본을 등록해
scripts/update_guidelines.py verify가 통과하는 환경에서는 문구 확인이 필요할 때 같은 폴더의current.index.md로 원문 범위를 찾아 읽을 수 있다. - 초안을 먼저 만들고 사실 왜곡·기재요령·금지 표현·분량을 순서대로 점검한다. 단순 분석이거나 문장 생성을 원하지 않을 때만 초안을 생략한다.
- 스크립트는 생성 후 기계 점검 또는 기재요령 등록·목록·활성화·검증·롤백이 필요할 때만 실행한다. 생기부 최종본의 글자 수·바이트는
scripts/analyze_record.py를 단일 진입점으로 사용한다.
현행 공통 준수 게이트
- 규정 판단의 기준은 이 절의 게이트, 영역 파일의 규정 게이트, 학교급별 요약(
references/guidelines/summary.md,references/guidelines-middle/summary.md)이다. 요약은 교육부 「2026학년도 학교생활기록부 기재요령」(2026-02-12 개정)을 바탕으로 이 스킬이 정리한 것이며 공식 효력은 원문에 있다. 원문 변환본이 등록되어 검증을 통과하면 문구 확인에 쓰고, 요약과 다르게 읽히거나 등록된 원문의 학년도가 요약과 다르면 원문을 따르며 요약 갱신이 필요하다고 알린다. 문구가 결과를 가르는 사안과 요약에 없는 사안은 규정을 지어내지 않고 원문 확인과 교육지원청 문의를 안내한다. 이후 개정 지침이나 해당 시도교육청·학교 규정이 충돌하면 더 최신이고 구체적인 규정을 따른다. - 아래 항목 끝 괄호는 근거를 나눈다.
기재요령 n-m은 학교급별 요약의 규칙 번호이며(아래 번호는 고·중이 같다) 교육부 기재요령이 정한 것이다.스킬 원칙은 이 스킬이 기재요령보다 보수적으로 정한 작업 원칙이다. 스킬 원칙에 어긋난 것을 사용자에게 기재요령 위반이라고 안내하지 않는다. - 실제 학교 교육활동에서 교사가 직접 관찰·평가한 사실만 사용한다(기재요령 1-4). 활동·역할·책·성과·변화를 만들거나 과장하지 않는다(기재요령 1-7).
- 학교교육계획·학교교육과정에 따른 활동과 허용된 예외만 기록한다(기재요령 1-2, 1-3). 교외·학교 밖 활동은 영역별 허용 조건(창체는 기재요령 5-10)이 확인되지 않으면 쓰지 말고 질문한다(스킬 원칙).
- 판단 하나마다 행동·산출물·피드백·변화 중 하나 이상의 근거를 연결한다(스킬 원칙).
- 공인어학시험, 교내·외 대회와 수상, 교외상, 인증시험, 모의고사·전국연합학력평가 성적(고등학교), 논문 투고·등재·학회 발표, 도서 출간, 지식재산권 출원·등록, 해외 활동실적, 부모·친인척의 사회·경제적 지위, 장학금 관련 내용은 서술형 전 영역에서 제외한다(기재요령 2절).
- 구체적인 대학명·기관명·상호명·강사명, 자격증 명칭·취득 사실, 재학 학교를 식별할 수 있는 내용(고등학교)은 공식 예외 항목이 아니라면 제외한다(기재요령 2절).
- 학생이나 보호자가 작성한 문장을 교사 관찰 기록처럼 사용하지 않는다(기재요령 1-4~1-6). 기재요령은 생성형 AI로 만든 자료를 서술형 항목에 그대로 입력하지 않도록 유의하게 하고, 윤문 같은 보조 수단으로 도움을 받았다면 최종 입력 전에 허위·과장과 유의사항 준수를 철저히 확인하게 한다(기재요령 1-9, 1-10). AI 생성문은 윤문 보조안일 뿐이며, 교사가 사실·과장·금지사항을 최종 대조하기 전에는 입력용 확정문으로 제시하지 않는다(스킬 원칙).
- 예시 문장을 복사하거나 과목·명사만 바꿔 쓰지 않는다(스킬 원칙. 기재요령은 기재예시를 참고 자료로 두고 뜻이 바뀌지 않는 범위에서 다르게 쓸 수 있게 한다, 1-14). 대학 인재상에 맞춰 사실을 왜곡하지 않는다(기재요령 1-7).
- 공식 기록에 대학명을 넣지 않는다(기재요령 2절). 합격 가능성, 입시 유불리, 인재상 부합 표현도 넣지 않는다(스킬 원칙).
- 확인되지 않은 활동·결과·성취를 사실처럼 쓰지 않는다(기재요령 1-7). 다만 자료 수준에 맞는 보수적 후보를 생성하고, 교사 확인이 필요한 요소만
[확인 필요]로 표시한다(스킬 원칙).
학교급 확인
초안·첨삭 요청에서 학교급을 알 수 없으면 근거를 판단하거나 초안을 쓰기 전에 학교급이 어디인가요? (중학교/고등학교)라고 한 번 묻고, 답을 받은 뒤 진행한다. 다음 경우에는 묻지 않는다.
- 사용자가 학교급을 밝혔거나
중2,고1처럼 학년으로 드러난 경우 - 성취기준 코드가 있는 경우:
[9…]는 중학교,[10…],[12…]는 고등학교 공통국어1,대수처럼 고등학교에만 있는 과목을 쓴 경우- 점검·분석만 요청했거나 기재요령 등록·활성화를 요청한 경우
엑셀·표 일괄 작업은 처음에 한 번만 묻고 학생별로 묻지 않는다. 이 질문에 근거 수준이나 작성 모드를 함께 묻지 않는다. 초등학교는 기재요령과 성취수준 자료가 없어 지원하지 않는다고 알린다.
중학교 초안
근거 판단, 사실성, 출력 형식은 고등학교와 같게 적용하고, 기재요령은 2026 학교생활기록부 기재요령(중학교)를 쓴다.
- 먼저 guidelines-middle/differences.md를 읽는다. 규정 세부는 guidelines-middle/summary.md에서 찾고, 원문이 등록되어 있으면 같은 폴더의
current.index.md로 원문 범위를 찾아 읽을 수 있다. - 한도는 중학교판 표를 따른다: 과목별 세특 500자, 창체 영역별 500자, 행특 300자, 자유학기활동 영역별 1,000자. 공통과목 1·2 합산과 전공실무과목 한도는 없다.
- 교과 세특은 특기할 만한 사항이 있는 과목·학생에 입력하고 입력 대상 범위는 학교 학업성적관리위원회가 정한다. 자유학기에 이수한 과목은 모든 학생에게 입력한다.
- 모의고사, 재학 학교 식별 금지, 공통과목 합산, 연구보고서(소논문) 예외 과목처럼 고등학교판에만 있는 규정은 적용하지 않는다. 연구보고서(소논문) 관련 사항은 예외 없이 쓰지 않는다.
- 성취기준과 수준 표현은 중학교 자료를 쓴다.
- 분량 줄의 기준에는
2026학년도 학교생활기록부 기재요령(중학교)를 적는다.
최소 참조 라우팅
| 요청 | 기록 생성·수정·최종 점검 시 읽을 파일 |
|---|---|
| 국어·사회·역사·도덕·영어·제2외국어·한문 세특 | subject-humanities.md |
| 수학·과학·정보·인공지능·보건·환경 세특 | subject-stem.md |
| 기술·가정·체육·음악·미술·진로와 직업 세특 | subject-practical-arts.md |
| 창의적 체험활동 | field-creative.md |
| 중학교 자유학기활동 특기사항 | field-free-semester.md |
| 행동특성 및 종합의견 | field-behavior.md |
| 2022 교육과정 핵심역량 분석 | curriculum-2022.md |
| 학종 평가요소 분석 | holistic-evaluation.md |
| 인문·사회·상경·국제 전공 렌즈 | major-humanities-social.md |
| 자연·생명·의학·보건 전공 렌즈 | major-stem-health.md |
| 공학·컴퓨터·교육·예술·융합 전공 렌즈 | major-technology-arts.md |
| 초안·첨삭의 문장 품질 정밀화 | evidence-writing-guide.md |
| 초안 문장 구조 선택(S1–S10)·배치 반복 점검 | sentence-structures.md |
| 교사 자료 입력 형식·엑셀 열 정의 | intake-template.md |
| 응답 골격·D 판정 작성 틀 | output-skeleton.md |
| 스킬 행동 검증(합성 케이스·채점 절차) | tests/eval-cases/README.md |
| 현행 규정·출처·자료 시점 질문 | source-policy.md |
| 기재 가능 여부·금지·입력 주체·한도 같은 규정 질문(지원하지 않는 영역 포함) | 학교급에 맞는 guidelines/summary.md 또는 guidelines-middle/summary.md에서 해당 절만 읽는다. 요약에 없는 세부는 지어내지 않고 요약이 가리키는 원문 장을 안내한다 |
| 중학교 기재요령과 고등학교판의 차이 | 학교급이 중학교이면 guidelines-middle/differences.md를 읽고, 규정 세부는 guidelines-middle/summary.md에서 찾는다 |
| 교과별 성취수준 공식 서술과 대조 | 공통 개념은 achievement-standards/common.md, 교과·과목 원문과 단계 체계는 achievement-standards/index.md에서 확인한 뒤 필요한 파일만 읽는다. 출처·라이선스 표시가 필요하면 그때 교과별 index.md가 가리키는 sources.json과 ATTRIBUTION.md를 읽는다 |
| 중학교 교과 성취수준 대조 | 학교급이 중학교이거나 [9…] 코드가 있으면 achievement-standards-middle/index.md에서 필요한 파일을 찾는다. 학교급이 고등학교이면 쓰지 않는다 |
지원 영역
지원: 교과 세특(과목별, 한도 과목별 500자), 창체 특기사항(자율·자치(3학년은 자율)/동아리/진로, 영역별 500자), 행특(300자). 2026학년도 3학년의 봉사활동 영역은 특기사항 없이 실적만 입력하므로 아래 봉사활동 실적과 같이 다룬다. 이 절의 한도는 모두 guidelines/summary.md의 「영역별 입력 가능 최대 글자수」 표에 있다. 이 표는 원문의 '학교생활기록부 영역별 입력 가능 최대 글자수' 표를 옮긴 것이며, 원문이 등록되어 있으면 원문의 같은 제목 표로 확인할 수 있다. 학년도마다 장 번호와 행 위치가 바뀌므로 행 번호 대신 이 제목으로 찾는다. 중학교는 자유학기활동 특기사항(진로탐색·주제선택, 3학년은 예술·체육·동아리 추가, 영역별 1,000자, guidelines-middle/summary.md의 같은 제목 표)도 지원하며, 세특·창체·행특 한도는 같은 표를 따른다.
미지원(요청 시 한도와 원문 위치만 안내하고 문장을 생성하지 않음, 한도는 같은 표, 위치는 요약의 '지원하지 않는 영역' 절): 개인별 세특(500자), 독서활동상황(공통 500자·과목별 250자), 봉사활동 실적(객관 기술 50자, 정성평가 제외), 출결 특기사항(500자), 학적 특기사항(500자), 정정대장 문안.
교과별 성취수준 자료는 curriculum_basis 등급으로만 사용한다. 학생의 실제 성취를 이 자료로 새로 만들거나 단정하지 않으며, 교사가 확인한 사실을 서술할 때 공식 어휘·강도를 맞추는 용도로만 쓴다.
기재요령 갱신 요청은 scripts/update_guidelines.py로 처리한다. 새 원문은 import, 버전 전환은 activate, 이전 버전 복귀는 같은 activate --version으로 수행하고, 작업 전후 verify를 실행한다. 중학교판은 모든 명령에 --level middle을 붙이며 고등학교판과 따로 관리된다. 공식 확인이 없는 원문은 기본적으로 활성화하지 않으며 결과에 [확인 필요]를 남긴다. 배포본에는 원문 변환본이 들어 있지 않아 요약 기준으로 동작한다. 원문 문구가 필요한 사용자는 교육부 PDF를 Markdown(.md)으로 바꿔 import로 등록할 수 있다(절차는 플러그인의 USER_GUIDE.md). 새 학년도 원문을 등록해도 요약과 검사 규칙은 자동으로 바뀌지 않는다.
대학·전공 렌즈는 사용자가 진로 연계를 요청하고 관련 사실이 있을 때만 보조적으로 사용한다. 학생부종합전형 평가요소와 대학인재상은 분석 렌즈일 뿐 학생의 실제 활동·역량보다 우선하지 않으며, 공식 기록에 대학 맞춤 표현을 넣지 않는다.
작성 절차
초안 전에 문장 요소별 근거표를 내부적으로 만든다: 내용 → 출처 유형 → 확인 수준 → 사용 범위. 출처 유형은 teacher_observation(교사 직접 관찰), student_product(검토된 결과물), student_self_report(소감·자기평가·진로 진술), assessment_result(점수·루브릭·교사 평가), shared_class_context(실제 공통 활동), curriculum_basis(성취기준·수업 목표), supporting_lens(핵심역량·평가요소·대학인재상)로 구분한다.
teacher_observation, 검토된 student_product, 확인된 assessment_result는 직접 사용한다. student_self_report는 학생의 진술·성찰 범위로만, shared_class_context는 참여 사실이 확인된 경우에만 개인 문장으로 사용한다. curriculum_basis와 supporting_lens는 교육적 해석과 어휘 선택에만 사용하며 학생의 행동·성취를 새로 만들지 않는다.
교사가 자기 수업·학급·담당 활동에서 학생이 한 행동을 직접 서술한 메모는 '관찰함'·'확인함' 같은 표지가 없어도 teacher_observation으로 본다. 표지가 없다는 이유로 직접 관찰 여부를 묻거나, 확인 수준을 낮추거나, [확인 필요]를 붙이지 않는다. 이 규칙은 누가 보았는지를 정할 뿐, 메모에 적힌 것보다 강한 해석이나 메모에 없는 사실을 허용하지 않는다. 같은 메모 안이라도 다음 서술은 교사 관찰로 보지 않는다.
- 전해 들은 서술(
~했다고 한다, 다른 교사·학생·보호자에게 들은 내용): 초안에 사실로 쓰는 대신 교사 확인 사항에 적는다. - 학생이 쓴 글을 옮긴 것(소감문·자기평가·활동지의 자기 서술):
student_self_report이며 아래 「내부 근거 판정 A–D」의 B 항목을 따른다. - 교사가 볼 수 없는 것(학생의 내면·의도·가정 사정, 교외나 다른 교사의 수업처럼 교사가 없던 자리의 일): 교사 관찰로 쓰지 않는다. 필요하면 교사 확인 사항에 적는다.
- 행동 없이 평가·인상으로 된 서술(
성실함,리더십 있음): 관찰 사실이 아닌 판단이므로 근거가 되는 행동을 교사 확인 사항으로 요청한다. - 누가 보았는지 문맥으로 알 수 없는 서술(작성자가 교사인지 불분명한 붙여넣기 등): 출처 미확인 자료로 다룬다.
내부 근거 판정 A–D
A–D는 사용자 선택지가 아니라 학생별 생성 범위를 정하는 내부 분류다. 사용자가 모드를 지정하지 않아도 자동 판정하며, 지정하더라도 근거 수준보다 높게 적용하지 않는다. 사용자에게 모드 선택을 묻지 않는다.
teacher_observation을 가장 먼저, 확인된student_product·assessment_result,student_self_report, 실제shared_class_context, 수업·평가 목표, 보조 참고 자료 순으로 판단한다. 자료의 양이 아니라 출처와 확인 수준을 함께 본다.- A: 교사 관찰·수행 과정·결과물·피드백 또는 수정 등 복수의 충분한 근거가 있으면 확인된 과정·결과·변화로 완성도 높은 세특 초안을 생성한다.
- B: 보고서·활동지·수행평가·소감문·발표 자료 등 제한된 학생별 근거만 있으면 자료에서 직접 확인되는 범위의 보수적 초안을 생성한다. 발표 원고·자료의 구성은 사용할 수 있지만 실제 발표 수행은 교사 확인 전까지 제외한다. 결과물을 교사 관찰로, 자기보고를 지속 행동·태도로 확대하지 않는다. 활동지·소감문에 학생이 자기 행동을 적은 내용은
~했다고 적음처럼 학생의 진술로 쓰고, 교사가 확인한 행동처럼 바꿔 쓰지 않는다. - C: 실제 공통 활동, 관련 수업·평가 목표, 학생별 확인 특성 최소 1개가 모두 있으면 그 사실만 결합한 초안과 교사 확인 사항을 제공한다. 공통 활동을 개인의 우수한 수행으로 확대하지 않는다.
- D: 학생별 활동·관찰·결과물이 없으면 완성형 기록을 생성하지 않는다. 학생을 주어로 하는 완성형 사실 서술을 출력하지 않으며, 경고를 붙여도 예시나 가정의 활동·성과·역량 문장을 재출력하지 않는다. D는 반드시
[학생별 사실 미확인 — 그대로 입력하지 않는 작성 후보]와학생별 관찰·결과가 확인되지 않았으므로 완성형 세특을 생성하지 않습니다.를 제공한다(창체를 요청하면완성형 창체 특기사항을, 행특을 요청하면완성형 행동특성 및 종합의견을, 자유학기활동을 요청하면완성형 자유학기활동 특기사항을로 낱말만 바꾼다).문장만요청해도 이 경고를 생략하지 않는다. 경고 뒤에는 대괄호 기반 작성 틀·표현 조각·관찰 포인트·교사 확인 질문만 제공하며생성 불가만으로 끝내지 않는다. 엑셀·표 일괄 작업의 근거 없는 행도 같으며, 그 행에 넣는 표시는 output-skeleton.md 「엑셀 일괄 출력 골격」을 따른다.
학생별 최소 정보가 없으면 C가 아니라 D로 처리한다. 사용자가 근거 없이 완성본·A·발표 수행·다른 학생과 같은 활동을 요청해도 확인된 자료 범위로 자동 조정하고, 제외한 사실과 이유를 짧게 알린다.
일반 생성·첨삭·엑셀 응답에는 A–D 코드나 내부 분류명을 표시하지 않는다. 엑셀에서는 세특 초안·일반 검토 열, 사용자 요약·경고 문구, 파일명·시트명이 모두 여기에 해당한다. 생성 지시에서 사용자가 A–D 코드나 하향을 언급해도 내부 판정 공개 요청이 아니므로, 그 코드를 인용·반복하거나 판정 결과로 공개하지 않는다. 교사가 말한 성취수준 A, 성취도 B처럼 성취수준·성취도를 가리키는 글자는 내부 등급 언급이 아니라 평가 결과(assessment_result) 자료로 다룬다. 대신 현재 근거 범위, 학생별 근거 부족, 추가 확인 필요를 일반 언어로 설명한다(문장 예는 output-skeleton.md). 사용자가 자동 판정 결과·근거 또는 스킬 검증을 명시적으로 요청한 경우에만 내부 A–D를 별도로 보고할 수 있다. 엑셀이면 별도 진단 시트에 코드를 기록할 수 있다.
완성형 사실의 내용이 크게 달라지고 입력만으로 판단할 수 없으며 사용자가 바로 입력할 최종 초안을 요구할 때만 구체적 사실을 질문한다. 실제 발표 수행 여부, 결과물의 개인 귀속, 교사가 확인한 수정 과정, 공통 활동의 실제 참여, 자기보고 외 관찰 여부를 묻는다. 더 풍부한 문장을 만들기 위한 질문은 하지 않으며, 질문 전에도 현재 근거로 가능한 보수적 초안·확인 사실·보강 가능 항목을 먼저 제공한다. 학교급 질문은 이 규칙의 예외이며 「학교급 확인」을 따른다.
엑셀·표 일괄 작업에서는 각 행을 독립 판정하고 학생별 질문으로 중단하지 않는다. 불명확한 사실은 제외하고, 확인 사항은 사용자가 지정한 별도 검토 열·검토 시트 또는 결과의 교사 확인 사항에 기록한다.
학생별 사실 확인 전의 완성 예시는 문체 참고일 뿐 근거가 아니다. 이름·성별·과목·주제·일부 명사만 바꾸어 재출력하지 않고, 예시에서는 관찰 항목과 확인 질문만 추출한다. 실제 teacher_observation, student_product, assessment_result가 제공되면 예시가 아닌 그 근거만으로 새 문장을 구성한다.
모든 모드에서 확인되지 않은 발표·보고서·리더십·수상·성과는 추가하지 않는다. 근거 사슬은 맥락·과제 → 출처가 표시된 행동 또는 결과 → 제한적인 해석 또는 교사 확인 필요로 유지한다.
사실 창작, 예시 이름·명사만 바꾼 재출력, D 모드의 완성형 기록 제시, 학생 자기보고의 교사 관찰화, 성취기준·보조 렌즈의 학생 성취 사실화, 금지 내용 기록 유도는 한 번만 확인되어도 즉시 수정하는 안전 오류다. 문체·어미·표현 다양성 문제는 독립 사례 2회 이상 재현될 때 수정한다.
- 교과세특: 성취수준, 수행 과정·결과, 교과역량, 총평 중 근거가 있는 요소만 조합한다.
- 창체: 역할, 상호작용, 문제 해결, 공동체 영향, 후속 성찰을 중심에 둔다.
- 행특: 반복 관찰과 대표 사례를 연결하고 성격 단정·낙인·근거 없는 미래 예측을 피한다.
학생부 문체가 요청되면 ~함, ~보임, ~확인됨, ~향상됨으로 간결하게 쓴다. 활동명 나열보다 학생의 사고·행동·변화에 분량을 배분한다.
근거 기반 서술 구조
초안 전에 가장 구체적이고 확인 수준이 높은 핵심 근거를 고른 뒤, sentence-structures.md의 S1–S10 중 근거 성격에 맞는 구조를 선택한다. 구조 코드는 내부 계획에만 사용하고 결과에 노출하지 않는다. 우선순위는 학생별 사실 → 출처의 표현 강도 → 실제 수업 맥락 → 성취기준 연결 → 기재요령 → 문장 다양성이다. 학생이 10명 이상인 배치 작업의 반복 검토 기준도 같은 파일을 따른다.
문장 품질 게이트
초안 생성·첨삭 때 writing-quality.json을 읽고 quality_dimensions, required_evidence_fields, rules, review_questions를 적용한다. 사실성과 규정 준수가 문장 다양성보다 우선한다.
출력과 점검
초안·첨삭·작성 지원으로 답하기 전에는 반드시 output-skeleton.md를 읽고 그 골격을 따른다. 영역별 라벨, 근거표의 열과 출처 유형 표기, 분량 줄, D 작성 틀, 엑셀 열과 근거 없는 행의 표시, 근거 부족을 알리는 일반 문장, 응답에 쓰지 않는 내부 명칭은 그 파일에 있다.
- 생성 요청은
세특/창체/행특 초안 또는 작성 지원 → 활용 근거 → 교사 확인 사항 → 분량순으로 답한다. - 내부 코드 표시는 「내부 근거 판정 A–D」의 코드 규칙을, 근거가 없을 때의 경고는 같은 절의 D 항목을 따른다.
- 생성과 검사를 함께 요청한 경우 검사가 초안 생성을 대신하지 않으며, 분석·점검만 요청한 경우에는 초안을 새로 만들지 않는다.
최종 확인:
- 모든 판단에 근거가 있는가
- 교사가 관찰하지 못한 내면·가정·교외 성과를 단정하지 않았는가
- 기재요령(요약, 등록된 원문이 있으면 원문)의 공통 금지사항과 해당 영역 파일의 제한을 통과했는가
- 해당 영역의 나이스 바이트 한도와 학년별 합산 규칙을 지켰는가
- 과정과 변화가 활동명보다 구체적인가
- 오래된 사례를 현행 규정으로 오인하지 않았는가
- 결과에 사용한 기재요령의 학년도·개정일과, 원문을 대조했는지 요약 기준인지를 일반 언어로 표시했는가
- 대학 맞춤·입시 예측 표현이 없는가
- 학교급을 확인했고, 중학교 초안이면 중학교 기재요령의 한도와 고등학교판과의 차이를 적용했는가
초안 생성 뒤에만 기계 점검이 유용한지 판단한다.
python scripts/analyze_record.py --file draft.txt --field subject --target-chars 500
중학교 기록은 --school-level middle을 붙여 중학교 기재요령과 한도로 점검하고, 자유학기활동은 --field free_semester로 점검한다. 학년·과목 유형·창체 영역이 확인되면 --grade, --subject-type common|elective|vocational(공통·전공실무는 고등학교만), --area autonomy|club|career(봉사활동 실적의 활동내용은 service, 실적별 50자)를 붙여 해당 한도로 점검하고, 공통과목 1·2 합산은 --combine-with, 10명 이상 배치의 반복률은 --batch draft.tsv로 확인한다. 출력은 등록된 원문(없으면 요약)과 검사 규칙의 학년도가 일치할 때만 제공하는 보조 신호이며, 원문이 없으면 '원문 미등록, 요약 기준'으로 표시된다. 최종 준수 판정은 교사가 원자료·학교 규정과 대조해 수행한다.
실제 NEIS 입력값 대조가 필요하면 기재요령상 실제 입력 가능한 문자로 만든 tests/neis-validation 합성 표본과 scripts/compare_neis_counts.py를 사용한다. 실제값이 충분히 수집되기 전에는 계산 계약을 확정하지 않으며, 검증되지 않은 계산값은 참고값으로 표시한다. NEIS 검증에는 실제 학생 기록을 사용하지 않고, 이모지·분해형 자모 같은 일반 Unicode 경계 사례는 생기부 계산 계약에서 제외한다.
최종 검수
- 원자료·사실 근거와 기재요령 기준(요약, 등록된 원문이 있으면 원문)을 확인한다.
- 금지 표현·개인정보·근거 부족을 점검한다.
- 최종본을
analyze_record.py로 검사해 글자 수·바이트를 다시 확인한다.
다른 스킬의 설치 경로를 import하거나 복사하지 않는다. 일반 글자 수 요청에는 korean-character-count를 사용한다.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |