1. 무엇을 어느 파일에 둘까요?

「위니브 Skill 모음」 교안에서 본 md-to-hwpx는 요청을 이해하는 부분과 변환을 실행하는 부분을 나누었고, weniv-quote는 단가표와 견적서 양식을 따로 두었습니다. 폴더를 보기 좋게 정리하려는 것이 아니라, 바뀌는 이유가 다른 내용을 따로 관리하기 위해서입니다.

1.1 바뀌는 주기로 판단하기

회의록에서 결정과 논의를 구분하는 규칙은 좀처럼 바뀌지 않습니다. 이번 회의의 참석자와 일정은 매번 바뀝니다. 회사 문서의 색상은 가끔 바뀌고, 단가표는 따로 개정일을 갖습니다. 이것을 모두 SKILL.md에 넣으면 고칠 때마다 업무 규칙과 오늘의 사실이 뒤섞입니다.

inputs는 Agent Skills의 필수 폴더가 아니라 이 실습 자료 묶음의 관례입니다. 설치용 ZIP에는 이번 사업의 입력을 넣지 않습니다.

1.2 세 가지 잘못된 분리

첫째, 자료를 나눴지만 지침에 파일 위치를 쓰지 않는 경우입니다. 언제 읽으라는 연결이 없으면 폴더가 있어도 빠뜨릴 수 있습니다. 둘째, 한 규칙을 지침과 참고 자료 여러 곳에 복사하는 경우입니다. 한 군데만 고쳐져 서로 모순됩니다. 셋째, 계산 스크립트 안에 회사의 실제 계좌나 직인을 넣는 경우입니다. 업무 로직을 공유하는 순간 비공개 정보도 같이 나갑니다.

이 책의 견적 Skill에는 계좌와 도장이 없고, 가산율은 실행 인수로 받습니다. 수료 기준은 네 번 중 세 번이라는 실습 규칙으로 고정되어 있습니다. 여섯 회 교육으로 바꾸려면 CSV 열뿐 아니라 정의 파일과 코드도 함께 바꿔야 합니다.

1.3 스크립트로 옮길 시점

정해진 산식, 파일 형식 검사, 합계 계산은 코드로 만들 가치가 큽니다. 반면 학습자의 의견을 해석하고 개선안을 제안하는 일은 문맥 판단이 필요합니다. 만족도 평균은 코드로 계산하고, 낮은 점수와 의견을 읽어 개선안을 쓰는 일은 지침에 맡기는 식으로 나눕니다.

코드가 있다고 저절로 정답이 되지는 않습니다. 수료율 분모를 잘못 구현하면 틀린 결과를 매번 정확히 재현합니다. 그래서 스크립트에는 손으로 계산해 볼 수 있는 작은 데이터가 필요합니다. 이 책의 열두 명짜리 출석부는 그 용도로 만들었습니다.

1.4 실습: 색상만 바꾸기

program-plan의 assets/template.html을 복사하고 강조 색상만 바꾸세요. 같은 과정 개요로 계획서를 다시 만들 때 일정과 인원은 바뀌지 않아야 합니다. 반대로 program-brief.md의 모집 목표를 24명으로 고치면 목표는 바뀌어야 하지만, 기관 실적 24명이 이번 모집 인원과 합쳐져서는 안 됩니다.

완료 기준은 “수정한 파일이 바꾸려던 부분만 바꾸었는가”입니다.