트라이에이지
프로젝트 이슈 트래커에서 이슈를 작은 상태 머신을 통해 트라이에이지 역할로 이동시킵니다.
트라이에이지 중 이슈 트래커에 작성되는 모든 댓글 또는 이슈 반드시 다음 면책 문구로 시작해야 합니다:
> *본 내용은 트라이에이지 중 AI가 생성했습니다.*
참고 문서
- AGENT-BRIEF.md — 지속 가능한 에이전트 브리프 작성 방법
- OUT-OF-SCOPE.md —
.out-of-scope/지식 베이스 작동 방식
역할
두 가지 카테고리 역할:
bug— 무언가 고장 남enhancement— 새로운 기능 또는 개선
다섯 가지 상태 역할:
needs-triage— 유지보수자가 평가해야 함needs-info— 신고자에게 추가 정보 대기 중ready-for-agent— 완전히 명세화되어 AFK 에이전트가 작업 가능ready-for-human— 사람이 구현해야 함wontfix— 처리하지 않음
트라이에이지된 모든 이슈는 정확히 하나의 카테고리 역할과 하나의 상태 역할을 가져야 합니다. 상태 역할이 충돌하면 플래그를 표시하고 다른 작업을 하기 전에 유지보수자에게 문의하세요.
이것들은 표준 역할 이름입니다. 실제 이슈 트래커에서 사용되는 레이블 문자열은 다를 수 있습니다. 매핑은 이미 제공되었을 것입니다. 그렇지 않으면 /setup-matt-pocock-skills를 실행하세요.
상태 전이: 레이블이 없는 이슈는 일반적으로 먼저 needs-triage로 이동합니다. 그런 다음 needs-info, ready-for-agent, ready-for-human 또는 wontfix로 이동합니다. needs-info는 신고자가 답변하면 needs-triage로 돌아갑니다. 유지보수자는 언제든지 재정의할 수 있습니다. 비정상적으로 보이는 전이에는 플래그를 표시하고 진행하기 전에 문의하세요.
호출
유지보수자가 /triage를 호출하고 자연어로 원하는 작업을 설명합니다. 요청을 해석하고 실행합니다. 예시:
- "제가 봐야 할 것 보여주세요"
- "#42를 봅시다"
- "#42를 ready-for-agent로 이동"
- "에이전트가 가져갈 준비가 된 것은?"
주의가 필요한 항목 표시
이슈 트래커를 조회하고 다음 세 개의 버킷을 오래된 순으로 표시합니다:
- 레이블 없음 — 한 번도 트라이에이지되지 않음.
needs-triage— 평가 진행 중.needs-info및 마지막 트라이에이지 노트 이후 신고자 활동 있음 — 재평가 필요.
각 버킷의 개수와 이슈당 한 줄 요약을 보여줍니다. 유지보수자가 선택할 수 있도록 합니다.
특정 이슈 트라이에이지
-
컨텍스트 수집. 전체 이슈(본문, 댓글, 레이블, 신고자, 날짜)를 읽습니다. 이전 트라이에이지 노트가 있으면 분석하여 이미 해결된 질문을 다시 묻지 않습니다. 프로젝트의 도메인 용어집을 사용하여 코드베이스를 탐색하고, 해당 영역의 ADR을 존중합니다.
.out-of-scope/*.md를 읽고 이 이슈와 유사한 이전 거부 사례를 표면화합니다. -
추천. 카테고리 및 상태 추천과 근거, 이슈와 관련된 간단한 코드베이스 요약을 유지보수자에게 알립니다. 지시를 기다립니다.
-
재현 (버그만 해당). 심층 분석 전에 재현을 시도합니다: 신고자의 단계를 읽고, 관련 코드를 추적하고, 테스트나 명령어를 실행합니다. 결과를 보고합니다 — 성공적인 재현과 코드 경로, 재현 실패, 또는 세부 정보 부족(강력한
needs-info신호). 확인된 재현은 훨씬 강력한 에이전트 브리프를 만듭니다. -
심층 분석 (필요한 경우). 이슈를 구체화해야 하는 경우
/grilling및/domain-modeling스킬을 함께 실행합니다. 한 번에 하나의 질문으로 이슈를 다듬고, 결정이 확정됨에 따라 도메인 용어를 명확히 하고CONTEXT.md/ADR을 인라인으로 업데이트합니다. -
결과 적용:
ready-for-agent— 에이전트 브리프 댓글 게시 (AGENT-BRIEF.md).ready-for-human— 에이전트 브리프와 동일한 구조지만, 위임할 수 없는 이유(판단 호출, 외부 접근, 설계 결정, 수동 테스트)를 명시합니다.needs-info— 트라이에이지 노트 게시 (아래 템플릿).wontfix(버그) — 정중한 설명 후 종료.wontfix(개선) —.out-of-scope/에 기록하고 댓글에서 링크한 후 종료 (OUT-OF-SCOPE.md).needs-triage— 역할을 적용합니다. 부분 진행 상황이 있으면 선택적 댓글.
빠른 상태 재정의
유지보수자가 "#42를 ready-for-agent로 이동"이라고 말하면 신뢰하고 직접 역할을 적용합니다. 수행할 작업(역할 변경, 댓글, 종료)을 확인한 후 실행합니다. 심층 분석을 건너뜁니다. 심층 분석 세션 없이 ready-for-agent로 이동하는 경우 에이전트 브리프 작성을 원하는지 물어봅니다.
Needs-info 템플릿
## 트라이에이지 노트
**지금까지 확인된 사항:**
- 포인트 1
- 포인트 2
**귀하(@reporter)로부터 아직 필요한 정보:**
- 질문 1
- 질문 2
심층 분석 중 해결된 모든 내용은 "지금까지 확인된 사항"에 기록하여 작업이 손실되지 않도록 합니다. 질문은 구체적이고 실행 가능해야 하며, "추가 정보를 제공해 주세요"가 아닙니다.
이전 세션 재개
이슈에 이전 트라이에이지 노트가 있는 경우 노트를 읽고, 신고자가 미해결 질문에 답변했는지 확인한 후 업데이트된 상태를 제시한 다음 계속 진행합니다. 이미 해결된 질문을 다시 묻지 않습니다.