--- name: principle-explain-the-number description: "측정하기 전에, 그리고 측정한 숫자를 신뢰, 보고 또는 조치하기 전에 적용: 속도 향상, 회귀, 처리량, 지연 시간 또는 eval 결과. 그것을 제한하는 것을 찾고, 생각하는 작업이 아닌 다른 것을 측정했다는 것을 배제." disable-model-invocation: true --- # Explain the Number (숫자 설명) - **실행하기 전에 결정을 작성하세요.** 결정을 변경할 결과와 노이즈 플로어를 명명하세요. 실행 간 스프레드가 효과보다 클 때 멈추세요. - **"왜 두 배가 아닌가?"라고 질문하세요.** 코어, 잠금, 디스크, 네트워크 또는 로드 생성기 자체와 같은 결과를 제한하는 리소스 또는 코드 경로를 명명하세요. 실행 중에 취한 프로파일 또는 시스템 카운터에서 가져온 다음, 소스에 매핑하세요. 코드를 읽는 것에서의 추측은 제한 요소가 아닙니다. 숫자가 왜 두 배로 좋지 않은지 말할 수 없다면, 무엇을 측정했는지 모릅니다. - **숫자가 측정할 수 있는 다른 것을 나열하고, 증거로 각각을 배제하세요.** 일반적인 용의자는 에러, 건너뛴 또는 캐시된 작업, 절대 실행되지 않은 코드, 튜닝되지 않은 측면(기본 설정에 남겨진 것), 노이즈, 엔드투엔드로 중요하지 않을 정도로 작은 조각입니다. - **숫자와 함께 증거를 유지하세요.** 실행 횟수, 스프레드, 제한 요소를 노트 또는 링크된 아티팩트에 넣으세요. 성능 숫자의 경우, [benchmark-checklist](../benchmark-checklist/SKILL.md) 스킬로 전체 절차를 실행하세요. eval 결과의 경우, 시도에 대해 동일하게 질문하세요: 모든 실행이 작업을 수행했는지, 간격이 시도와 모델에 걸쳐 유지되는지, 시나리오가 중요한지. 결정을 변경할 결과 없이 실행이 시작되었을 때, 숫자 뒤의 증거에 실행 횟수, 스프레드 또는 명명된 제한 요소가 없을 때, 또는 절약된 시간이 변경된 조각이 걸린 시간보다 클 때 이것을 건너뛰었습니다. 출력이 실제임을 확인하는 [Prove It Works](../principle-prove-it-works/SKILL.md)와 구별됩니다.