Bug Receipt
필수 closeout 출력
모든 버그 또는 장애 closeout 결정에 대해, 사용자가 간결한 응답을 요청하거나 이 형식을 언급하지 않더라도 아래의 완전한 receipt를 전체 사용자 대상 결과로 반환하십시오. 간결성은 필드 값을 줄일 뿐, 행을 제거하거나 이름을 변경하지 않습니다. receipt를 산문으로 대체하지 마십시오.
BUG RECEIPT · VERIFIED | PARTIAL | BLOCKED
Problem <관찰된 결함 및 의도된 동작>
Baseline <실패하는 상호작용 또는 명령과 결정적 결과; 또는 not run>
Root cause <입증된 메커니즘; 또는 unproven hypothesis>
Change <책임 있는 변경; 또는 none>
Proof <제공되거나 실행된 확인: 결과; 모든 결정적 계층 포함>
Gaps <없음; 또는 정확히 누락된 증명과 단일 다음 실험/패키지>
Source executed now | supplied | mixed
not run, unproven, none을 명시적으로 사용하십시오. receipt를 완전해 보이게 하기 위해 행을 생략하지 마십시오.
증거 경계 설정
편집하기 전에 관찰된 문제, 의도된 동작, 가장 강력한 직접 확인, 및 증거 출처(executed now, supplied, 또는 mixed)를 기록하십시오. 제공된 증거가 현재 실행에서 실행되었다고 암시하지 마십시오.
증거는 프라이버시를 최소화하십시오. 자격 증명, 토큰, 쿠키, 개인 데이터, 비공개 URL 및 민감한 페이로드를 삭제하고, 실패를 재현하거나 상호 연관시키는 데 필요한 식별자와 발췌문만 보존하십시오.
가능하면 가장 좁은 안전한 확인으로 실패를 재현하십시오. 재현이 불가능하면 획득한 증거를 보존하고 결과를 PARTIAL 또는 BLOCKED로 제한하십시오.
추적 및 수리
- 라이브 소유자 경로를 입력부터 증상까지 따라가십시오.
- 관찰된 사실, 제한된 추론 및 격차를 분리하십시오.
- 근본 원인을 명명하기 전에 구체적인 위치 또는 런타임 전환이 필요합니다.
- 가장 작은 책임 있는 변경을 수행하고, 관련 없는 정리, 재시도, 무음 대체 및 fixture별 예외를 피하십시오.
그럴듯한 패치, 오래된 로그, 소스 읽기 또는 통과 빌드를 사용자 가시 동작의 증명으로 전환하지 마십시오.
증명 루프 닫기
영향을 받는 계약에 필요한 검사만 실행하십시오:
- 원래 재현 또는 직접 수용 확인;
- 가장 가까운 부정 또는 회귀 확인;
- 영향을 받는 빌드 또는 통합 게이트;
- 해당 주장이 해당 경계를 넘을 때 실제 UI, API, 지속성, 동시성 또는 런타임 경로.
다음 결정적 경계를 사용하십시오:
| 표면 | 필요한 직접 증명 |
|---|---|
| 논리 또는 실패 테스트 | 원래 실패 입력 또는 집중 테스트가 이제 통과함 |
| UI 동작 | 실제 상호작용 + 관련 콘솔 및 네트워크 관찰 |
| API 또는 통합 | 요청, 응답 및 책임 서비스 동작 |
| 지속성 | 실제 소유자 경로를 통한 쓰기/읽기 또는 리로드 라운드 트립 |
| 경쟁 또는 라이프사이클 | 반복된 동시 트리거; 0 또는 1 성공; 영향 받은 행 및 트랜잭션 증거; 최종 불변 조건 |
| 교차 시스템 차단기 | 타임스탬프 또는 요청 ID가 있는 하나의 정리된 실패 요청/응답, 에지 및 애플리케이션 로그, 그리고 추적이 해당 소유자에 도달할 때 ID 제공자 로그 |
상태 할당
VERIFIED: 관찰된 기준선, 구체적인 원인, 책임 있는 변경, 선언된 모든 검사 통과, 중요한 격차 없음.PARTIAL: 유용한 증거가 존재하지만 필수 증명 계층이 누락되었거나 결정적이지 않음.BLOCKED: 특정 외부 조건으로 인해 재현, 수리 또는 증명이 불가능함.
PARTIAL 또는 BLOCKED의 경우, 결정적인 격차를 해소하는 단일 최소 실험 또는 상호 연관된 증거 패키지를 명명하십시오. 명령, 관찰, 개수, 위치 또는 결과를 발명하지 마십시오.
기계 판독 가능 receipt 또는 CI 통합의 경우 references/receipt-contract.md를 읽고 해당 JSON 필드, 증거 출처 마커, 호환성 규칙 및 상태 불변 조건을 준수하십시오.
JSON 아티팩트가 요청되면 assets/receipt.template.json에서 시작하여 작업 소유 경로에 쓰고, 이 스킬 디렉토리에서 node scripts/validate-receipt.mjs <receipt.json>을 사용하여 검증하십시오. 사용자가 요청하지 않는 한 생성된 receipt를 커밋하지 마십시오.