대부분의 클로드 파이프라인 실패가 모델이 아닌 프롬프트에서 비롯되는 이유와 스킬로 해결하는 방법

최근 r/ClaudeAI 게시물은 흔한 패턴을 지적합니다: 프롬프트가 단독으로는 잘 작동하지만, 파이프라인에 배치되면 몇 주 후에 조용히 잘못된 출력을 생성한다는 것입니다. 근본 원인은 모델이 아니라, 프롬프트가 문서화되지 않은 입력 형식을 가정하고, 한 호출자만 파싱 방법을 아는 구조를 반환했기 때문입니다. 게시물은 원시 프롬프트와 달리 기술(skill)이 이런 종류의 실패를 방지하는 세 가지를 강제한다고 주장합니다.

입력 계약(Input Contract)

프롬프트에 필요한 필드, 누락된 경우 어떻게 처리할지, 최소 실행 가능한 입력이 무엇인지 정확히 정의합니다. 게시물은 이를 작성하는 데 10분이 걸리며, 그렇지 않으면 새벽 2시에 발생할 실패를 예방한다고 말합니다.

출력 스키마(Output Schema)

실패 상태를 포함하여 반환 형식을 정확히 지정합니다. 게시물의 예시:

success = {action: string, confidence: float, reasoning: string}
failure = {action: "skip", reason: string}

"요약 반환"은 스키마가 아닙니다. 스키마는 성공과 실패 모두를 다운스트림 노드에 표시합니다.

학습 파일(Learnings File)

기술이 실패한 사항, 발견된 엣지 케이스, 프로덕션에서 문제가 발생한 내용을 기록하는 파일을 유지합니다. 시간이 지나면서 채워집니다. 기술이 문제를 일으킬 때마다 그 고통이 여기에 저장되어, 다음에 실행하는 사람이 다시 발견하지 않도록 합니다.

게시물 작성자는 요약합니다: "프롬프트만으로는 v0입니다. 기술이 v1으로 승격되는 것입니다."