korean-school-records-toolkit
Health Warn
- License — License: NOASSERTION
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Warn
- fs module — File system access in skills/korean-character-count/scripts/korean_character_count.js
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
교사가 확인한 관찰·평가 근거로 학교생활기록부 세특·창체·행특 초안을 쓰고 글자 수와 NEIS Byte를 계산하는 Codex·Claude Code 스킬 플러그인입니다. 2026 기재요령과 2022 개정 교육과정 고등학교·중학교 성취수준을 참고합니다.
한국어 학교생활기록부 도구
최근 업데이트: 2.1.0 — 자세한 변경 내역은 CHANGELOG.md를 확인하세요.
현재 버전은 2.1.0이다.
학교생활기록부 초안 생성과 글자 수·NEIS Byte 계산을 한 설치 단위로 제공하는 Codex·Claude Code 겸용 스킬 플러그인이다. 두 기능은 서로 독립적으로 사용할 수 있다.
포함 스킬
| 스킬 | 역할 | 주요 호출 범위 |
|---|---|---|
write-school-records |
실제 관찰·평가 근거 기반 학생부 초안·점검 | 세특, 창체 특기사항, 행특, 중학교 자유학기활동 특기사항, 기재요령·성취수준 참고 |
korean-character-count |
결정론적 글자 수·줄 수·UTF-8/NEIS Byte 계산 | 분량 확인, 문장·셀별 집계, 최대 한도 검사 |
여러 기능을 함께 요청하면 학생부 초안 → 글자 수·NEIS Byte 확인 순서로 연계한다. 한 기능만 요청하면 다른 스킬을 강제로 실행하지 않는다. |
사용 예시
학교생활기록부 작성
첨부한 학생별 교사 관찰과 결과물을 근거로 교과 세부능력 및 특기사항 초안을 작성해 줘. 사실이 확인되지 않는 내용은 추가하지 말고, 최종 문장의 글자 수와 NEIS Byte도 확인해 줘.
글자 수 확인
아래 문장의 글자 수와 NEIS 기준 Byte를 계산하고 1,500Byte 초과 여부를 알려줘.
통합 처리
첨부한 학생 자료로 세특 초안을 작성한 뒤 최종 글자 수와 NEIS Byte를 계산해 줘.
성취수준 찾기
[12화학03-03]성취기준의 수준별 설명을 찾아 줘.
중학교
[9과02-01]성취기준의 수준별 설명을 보여 줘.
성취수준 자료 범위
| 학교급 | 들어 있는 자료 | 쓰는 때 |
|---|---|---|
| 고등학교 | 과목 파일 231개 | 학교급이 고등학교일 때 쓴다 |
| 중학교 | 17개 교과, 성취기준 711개 | 학교급이 중학교이거나 [9…] 코드가 있을 때 쓴다 |
초안을 요청할 때 학교급을 알 수 없으면 먼저 묻는다. 중2, 고1, 성취기준 코드, 고등학교에만 있는 과목명으로 알 수 있으면 묻지 않는다.
중학교 초안은 2026 학교생활기록부 기재요령(중학교)를 따른다. 한도는 과목별 세특 500자, 창체 영역별 500자, 행특 300자, 자유학기활동 영역별 1,000자다. 공통과목 1·2 합산, 모의고사, 재학 학교 식별 금지처럼 고등학교판에만 있는 규정은 적용하지 않는다. 두 판의 차이는 skills/write-school-records/references/guidelines-middle/differences.md에 정리했다.
안전 원칙
- 이 도구를 활용하실 때에는 근무하시는 시도교육청의 AI 활용 지침 등을 확인하시기 바랍니다.
write-school-records는 CC BY-NC-SA 4.0 라이선스(© 2026 류기현, 부산 동아공고)이며, 비영리 목적에 한해 원저작자 표시·동일조건변경허락 조건으로 자유롭게 사용·수정·재배포할 수 있다. 상업적 이용은 금지되며 문의는 이 저장소의 GitHub Issue로 한다.- 실제 학생 자료를 예제·테스트·패키지에 포함하지 않는다.
- 배포 전 학생 이름, 학번, 학교명 등 개인정보를 제거한다.
- 테스트에는 합성 자료만 사용한다.
- 학생부 결과는 교사가 원자료와 학교 규정에 대조해 최종 확인한다.
- 플러그인은 학생 사실을 임의로 만들지 않는다.
- 분량 계산은 기록의 사실성을 대신하지 않는다.
- 성취수준 참고 자료의 공통과목·중고 합본과목은 NCIC 공공누리 제2유형, 선택과목은 NKIS 공공누리 제1유형 조건을 따른다. 자세한 출처 표시는
skills/write-school-records/references/achievement-standards/ATTRIBUTION.md를 따른다. - 중학교 성취수준 자료는 NCIC 저작권 정책의 공공누리 제2유형 조건을 따른다. 게시물별 표시는 개별로 확인하지 못했다. 자세한 출처 표시는
skills/write-school-records/references/achievement-standards-middle/ATTRIBUTION.md를 따른다. references/guidelines/의 기재요령 자료는 원문이 아니라 원문을 근거로 재가공한 참조본이다. 공식 효력을 갖는 것은 교육부 배포 원문이며, 내용이 다르면 원문을 따른다. 본 저작물은 교육부에서 2026년 작성하여 공공누리 제4유형(출처표시+상업적 이용금지+변경금지)으로 개방한 「2026학년도 학교생활기록부 기재요령 안내」를 이용하였으며, 해당 저작물은 교육부 홈페이지(https://www.moe.go.kr)에서 무료로 내려받으실 수 있다. 재가공 내역을 포함한 자세한 안내는skills/write-school-records/references/guidelines/ATTRIBUTION.md를 따른다. 같은 게시물의 중학교판을 재가공한references/guidelines-middle/도 같은 조건이며, 안내는 같은 폴더의ATTRIBUTION.md를 따른다.
Codex 설치·업데이트·제거 절차는 INSTALL.md를 따른다. Claude Code 설치와 로컬 검증은 README_CLAUDE_CODE.md를 따른다.
더 읽을 문서
| 문서 | 내용 |
|---|---|
| USER_GUIDE.md | 실제로 어떻게 요청하고 쓰는지 |
| docs/how-it-works.html | 이 도구가 왜 이렇게 판단하는지를 쉬운 말로 설명. 내려받아 브라우저로 연다 |
| docs/dev-vs-package.md | 개발본과 배포본의 의도된 차이 (기여자용) |
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found