본문으로 건너뛰기

한 덩어리였던 단어시험지 Skill을 세 책임으로 나눠 보았다

JoyKim

2026.08.01

## 한 줄 요약

+1주차에 만든 vocabulary-test-maker를 입력 검수, 시험지 생성, 독립 검증의 세 작은 Skill로 나누고, 상위 Umbrella가 실행 순서와 실패 반환을 맡도록 연결했다. 공개용 가상 단어 10개로 실제 실행한 결과 정상 입력은 PASS, 오류 입력은 partial과 Human Gate HOLD로 구분됐다.

## 왜 1주차 Skill을 다시 보게 됐나

+1주차에는 단어 목록 하나를 넣어 학생용 시험지와 정답지를 만드는 데 성공했다. 하지만 하나의 Skill 안에 다음 일이 모두 들어 있었다.

- 입력 형식과 중복 확인

- 문제 순서와 시험지 형식 결정

- 학생용 시험지와 정답지 생성

- 문항 수·정답·답 노출 검증

- 실제 배포 전 교사 승인

처음에는 한 번에 처리돼 편했지만, 오류가 생겼을 때 어디를 고쳐야 하는지가 흐렸다. 입력이 잘못된 문제와 정답지 순서가 어긋난 문제는 실패 원인도, 확인 방법도, 수리 방법도 달랐다.

## 원본과 작업 사본을 먼저 분리했다

기존 Skill은 learner-owned 원본으로 보존하고, 2주차 작업은 별도 working copy에서 진행했다. 후보 파일을 만들기 전 자동 백업을 수행하고 파일별 SHA-256을 대조했다. 백업 payload를 새 경로에 복사해 다시 해시를 비교하는 복원 리허설도 PASS였다.

작업 중 변경 전 백업 영수증은 총 10개가 남았고 모두 PASS다. 배포받은 수업 자료나 기존 1주차 원본은 수정하지 않았다.

## 전체 절차를 빠짐없이 펼쳐 본 결과

요청을 받는 순간부터 실제 외부 배포 전까지 절차를 18개로 펼쳐 분류했다. 그 결과 작은 Skill로 분리할 경계는 세 곳이었다.

1. `vocabulary-list-validator`

word | meaning 목록을 읽고 유효 항목, 형식 오류, 중복을 구분한다.

2. `vocabulary-test-composer`

검수된 pair와 제목·배점·seed를 받아 학생지와 정답지를 같은 순서로 만든다.

3. `vocabulary-test-verifier`

생성기와 독립적으로 문항 수, 순서, 입력 뜻, 학생용 답 노출, 재현성을 판정한다.

제 판단으로 실제 인쇄·배포 승인은 아직 별도 Skill로 만들지 않았다. 현재는 단어시험에만 쓰고 있고 외부 행동도 없으므로, 상위 Umbrella 안의 교사 Human Gate로 유지하는 편이 더 단순했다.

## 나누지 않고 남긴 것

모든 작은 동작을 Skill로 만들지는 않았다.

- 제목·배점·문항 수 결정: 전체 요청을 조정하므로 Umbrella 내부

- pair를 섞는 동작: 독립 판단이 없는 Composer의 지원 코드

- 파일 쓰기와 SHA-256 계산: 각 Skill의 지원 코드

- 중복을 유지할지 판단: 교사가 결정하므로 Human Gate

- 실제 인쇄·발송·게시: 이번 Skill Tree 밖의 별도 작업

이렇게 나누니 “작은 함수”와 “독립적인 책임을 가진 Skill”이 같은 것은 아니라는 점이 보였다.

## 만든 Interface

각 후보에 공통으로 다음 경계를 적었다.

name / role / use_when / input / steps / output / verifier / failure_return

가장 중요한 연결은 파일 이름보다 출력 계약이었다.

Validator → validation-report.json

Composer → test.md + composition-receipt.json

Verifier → proof.json

Umbrella → 다음 Skill 선택 또는 실패 책임으로 반환

## Umbrella Tree: 어디에 속하는가

vocabulary-test-maker-umbrella

├─ vocabulary-list-validator

├─ vocabulary-test-composer

├─ vocabulary-test-verifier

└─ Human Gate: 교사 배포 승인

 └─ 실제 print/send/publish는 Tree 밖 별도 작업

## Circuit: 무엇이 전달되고 어디로 돌아가는가

omitted 91 diff line(s) across 1 additional file(s)/section(s)

4

함께 이야기해요 4

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.08.03

JoyKim님, 이번 글은 1주차 단어시험지 Skill을 “더 잘 만드는” 이야기라기보다, 오류가 났을 때 책임을 정확히 되돌려 줄 수 있도록 구조를 다시 세운 이야기로 읽혔어요. 입력 오류와 정답지 순서 오류는 원인도 수리법도 다른데 한 덩어리 안에서는 구분하기 어려웠다는 문제에서 출발해, Validator·Composer·독립 Verifier와 교사 Human Gate로 나눈 흐름이 자연스럽습니다.

분해 전에 learner-owned 원본을 보존하고 작업 사본·자동 백업·SHA-256 대조·복원 리허설을 먼저 한 점도 중요한 성취예요. 그 위에서 18개 절차를 펼쳐 독립 판단이 있는 세 책임만 Skill로 올리고, 섞기나 파일 쓰기처럼 독립 판단이 없는 동작은 지원 코드로 남겼죠. 기존 댓글들이 “작은 함수와 독립 Skill은 다르다”는 문장과 출력 계약을 잘 짚었는데, 저는 그 판단이 원본 보존과 실패 반환까지 연결됐기 때문에 실제로 안전한 Tree가 됐다는 점을 더 높게 봤어요.

본문에는 공개용 가상 단어 10개로 정상 입력 PASS, 오류 입력 partial과 Human Gate HOLD를 구분했다고 적혀 있어요. 즉 성공 경로만 예쁘게 보여준 것이 아니라 잘못된 입력을 다음 단계로 넘기지 않는 경계까지 시험한 셈입니다. 실제 인쇄·발송은 Tree 밖에 두고 교사 승인을 남긴 선택도 현재 사용 범위에 맞는 절제였어요.

댓글의 take처럼 뜻이 여러 개인 단어 사례는 이 구조의 좋은 다음 시험이 될 수 있어요. 다만 본문에는 복수 정답·허용 동의어 정책을 적용한 첫 실행 결과는 아직 확인되지 않았어요. Verifier가 임의로 의미를 넓히기보다, 교사가 제공한 허용 답안·동의어 목록과 “판단 보류” 기준을 입력 계약으로 받아 exact match·허용 match·Human Gate로 나눠보면 지금의 책임 경계를 흐리지 않고도 확인할 수 있겠습니다.

이 글은 Skill을 많이 만들수록 좋다는 이야기가 아니라, 실패 원인과 승인 주체가 달라질 때만 경계를 만든다는 사례라서 가치가 있어요. 단순한 파일 분해가 아니라 원본 보호→책임 분리→출력 계약→독립 검증→사람 승인으로 이어지는 전체 흐름을 독자가 그대로 가져갈 수 있습니다.

공대언니 프로필 이미지
공대언니2026.08.01

정말 유용할 것 같아요. 저도 AI가 검토할 수 있는 환경을 만들어 보고 싶습니다.

자연어회계처리 프로필 이미지

To be 값이 확실한 영단어에 있어서 스킬 3개 Validator-Composer-Verifier 요 구조는 개인적으로 하네스상 파레토 최적 상태로 보입니다. 제 생각에는 여기서 더 결합하거나 분해하면 뭔가 손해보는 파레토 최적의 임계점 같습니다.

저는 여기서 궁금한게 있는데 영단어중에 take란 단어가 있는데 이걸 어디까지 맞는 답으로 허용해 줄수있을까 입니다. 시간이 걸리다. 내쪽으로 가져오다. 데려가다. 수용하다 등 다양한 의미를 가진 이 단어를 범용적으로 포괄할수 있는 취하다 형태를 취하면 다맞게 O가 될수도 있다고는 보는데 그렇다면 어디까지 맞게 할것인가? 요거 점 궁금합니다

뽀짝이 프로필 이미지
뽀짝이2026.08.01

"작은 함수"와 "독립적인 책임을 가진 Skill"이 같은 것은 아니다 — 이 문장이 글의 핵심을 압축하고 있어요. 파일 쓰기나 SHA-256 계산처럼 독립적인 판단이 없는 동작은 Skill로 분리하지 않고 지원 코드로 남긴 판단도 깔끔했습니다.

출력 계약(validation-report.json → composition-receipt.json → proof.json)이 파일 이름보다 더 중요하다는 부분, 이걸 직접 설계해보셨으니 다음 Skill Tree에서도 자연스럽게 쓰실 것 같아요. 고롱고롱… 이런 정리 글, 쌓이면 나중에 진짜 재산이 돼요 ✨

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기