티켓 기술적 사후분석(Post-Mortem) (하나의 필드 + 포인터)
사용자는 모든 내용을 하나의 필드에 넣고 다른 분석 필드는 이를 가리키도록 설정하여, 동일한 내용을 두 번 말하지 않습니다. 이 워크플로우를 그대로 재현하세요.
설정
다른 어떤 작업보다 먼저 ~/.config/skills/analyse-causes/config.md를 읽으세요. 이 파일은 트래커와 그 도구, 프로젝트 및 티켓 키 패턴, 필드 형식, 작성 언어와 제목, 작성 필드, 포인터 텍스트가 있는 전환된 필드, MR 링크 필드를 설정합니다. 파일이 없으면, 사용자에게 이 파일 옆에 있는 config.example.md를 ~/.config/skills/analyse-causes/config.md로 복사하고 내용을 채우도록 안내한 후 중지하세요.
대상: 인자로 전달된 티켓, 또는 세션에서 진행 중인 수정 사항(diff / branch / MR).
생성할 내용
하나의 완전한 작성본을, 설정된 언어로, 마크다운 형식으로, 설정된 제목 아래 두 개의 섹션으로 작성합니다:
- 근본 원인 - 기술적 WHY. 초기 상황(증상 / 티켓 설명)을 재언급하지 마세요. 실제 원인으로 거슬러 올라가세요: 설계 선택,
상수/파일:라인, 잘못된 가정. 절대 가시적 증상은 안 됩니다. - 수정 사항 - 무엇이 변경되었고 왜 근본 원인을 제거하는지. 사실적으로: 선택된 메커니즘, 수정된 파일/상수, 결과 동작. 여기에 MR 링크는 넣지 마세요: 설정된 MR 링크 필드에 들어갑니다.
규칙: 간결하게, 짧은 글머리 기호, 정확한 용어(상수, 함수, 파일:라인) 사용, 실제 코드와 대조 확인. 줄표(U+2014) 사용 금지 - 하이픈, 쉼표 또는 문장을 다시 구성하세요.
절차
- 티켓 식별: 인자가 설정된 패턴과 일치하는 키면 그 티켓; 그렇지 않으면 진행 중인 수정 사항(세션의 diff / branch / MR).
- 필요한 경우 설정된 도구를 통해 티켓을 읽되, 그 설명을 복사하지 마세요.
- 코드에서 근본 원인을 추적하고 수정 사항의 변경 사항(git diff / MR)을 나열합니다.
- 완전한 작성본을 작성합니다.
- 작성본을 보여준 후, 설정된 형식으로 필드를 작성합니다:
- 작성 필드 <- 완전한 작성본
- 각 전환된 필드 <- 설정된 포인터 텍스트가 포함된 한 문단 분량의 문서 대상 티켓이 없는 경우(키 없이 세션에서 수정 중), 작성본만 보여주고 필드 작성을 제안합니다.