39장. Skill Debugging

skill이 불필요한 질문에도 호출되면 description/trigger가 너무 넓다. 이름을 바꾸기 전 positive·negative trigger fixture를 만든다. “보고서” 모두가 아니라 “제공된 source로 근거·불확실성·다음 행동을 갖춘 의사결정 brief”처럼 한정한다.

skill이 지시 파일을 읽고도 누락하면 workflow 단계가 추상적인지 본다. “품질을 확인” 대신 “출력의 모든 핵심 주장에 source_id가 있는지 script로 검사”처럼 산출물과 검사를 연결한다.

reference가 너무 커서 context를 잡아먹으면 routing 표를 둔다. 작업에 필요한 파일만 선택하되 선택한 instruction/reference는 전체를 읽는다. 중복 설명은 제거하고 version-sensitive fact는 별도 파일과 확인일을 둔다.

script가 실패할 때 silent fallback하지 않고 exit code, 오류 위치, recovery action을 보여 준다. 입력 파일을 덮어쓰지 않고 temp/output을 분리한다. external call은 timeout·retry·rate limit을 스킬 문서에 적는다.

권한 오류는 가장 심각하다. 사용자가 요약을 요청했는데 skill이 원문을 수정·게시하면 실패다. read-only·draft·state change 단계를 분리하고 상태 변경 전 명시 승인 fixture를 통과한다.