Communitygithub.com

트라이에이지 (Triage)

이슈 트래커의 이슈들을 분류, 재현, 심층 분석을 통해 상태 머신으로 이동시키며 에이전트가 작업할 수 있는 브리프를 작성합니다.

트라이에이지 (Triage)란 무엇인가요?

이 스킬은 프로젝트 이슈 트래커에서 이슈를 체계적으로 분류(triage)하는 프로세스를 자동화합니다. 버그, 개선 요청 등 카테고리 역할과 needs-triage, needs-info, ready-for-agent 등 상태 역할을 조합하여 이슈에 정확한 레이블을 부여하고, 필요한 경우 재현 및 심층 분석(grilling)을 수행합니다. 최종적으로 ready-for-agent 상태의 이슈에는 AI 에이전트가 바로 작업할 수 있는 에이전트 브리프를 작성해줍니다. 깃허브 이슈, 지라 등 다양한 이슈 트래커에서 사용할 수 있으며, `/triage` 명령어로 호출하여 자연어로 원하는 작업을 지시할 수 있습니다. 유지보수자는 이 스킬을 통해 반복적인 분류 작업을 줄이고, 에이전트에게 명확히 위임 가능한 작업을 신속히 식별할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/triage

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

트라이에이지

프로젝트 이슈 트래커에서 이슈를 작은 상태 머신을 통해 트라이에이지 역할로 이동시킵니다.

트라이에이지 중 이슈 트래커에 작성되는 모든 댓글 또는 이슈 반드시 다음 면책 문구로 시작해야 합니다:

> *본 내용은 트라이에이지 중 AI가 생성했습니다.*

참고 문서

역할

두 가지 카테고리 역할:

  • 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로 이동"
  • "에이전트가 가져갈 준비가 된 것은?"

주의가 필요한 항목 표시

이슈 트래커를 조회하고 다음 세 개의 버킷을 오래된 순으로 표시합니다:

  1. 레이블 없음 — 한 번도 트라이에이지되지 않음.
  2. needs-triage — 평가 진행 중.
  3. needs-info 및 마지막 트라이에이지 노트 이후 신고자 활동 있음 — 재평가 필요.

각 버킷의 개수와 이슈당 한 줄 요약을 보여줍니다. 유지보수자가 선택할 수 있도록 합니다.

특정 이슈 트라이에이지

  1. 컨텍스트 수집. 전체 이슈(본문, 댓글, 레이블, 신고자, 날짜)를 읽습니다. 이전 트라이에이지 노트가 있으면 분석하여 이미 해결된 질문을 다시 묻지 않습니다. 프로젝트의 도메인 용어집을 사용하여 코드베이스를 탐색하고, 해당 영역의 ADR을 존중합니다. .out-of-scope/*.md를 읽고 이 이슈와 유사한 이전 거부 사례를 표면화합니다.

  2. 추천. 카테고리 및 상태 추천과 근거, 이슈와 관련된 간단한 코드베이스 요약을 유지보수자에게 알립니다. 지시를 기다립니다.

  3. 재현 (버그만 해당). 심층 분석 전에 재현을 시도합니다: 신고자의 단계를 읽고, 관련 코드를 추적하고, 테스트나 명령어를 실행합니다. 결과를 보고합니다 — 성공적인 재현과 코드 경로, 재현 실패, 또는 세부 정보 부족(강력한 needs-info 신호). 확인된 재현은 훨씬 강력한 에이전트 브리프를 만듭니다.

  4. 심층 분석 (필요한 경우). 이슈를 구체화해야 하는 경우 /grilling 및 /domain-modeling 스킬을 함께 실행합니다. 한 번에 하나의 질문으로 이슈를 다듬고, 결정이 확정됨에 따라 도메인 용어를 명확히 하고 CONTEXT.md/ADR을 인라인으로 업데이트합니다.

  5. 결과 적용:

    • 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

심층 분석 중 해결된 모든 내용은 "지금까지 확인된 사항"에 기록하여 작업이 손실되지 않도록 합니다. 질문은 구체적이고 실행 가능해야 하며, "추가 정보를 제공해 주세요"가 아닙니다.

이전 세션 재개

이슈에 이전 트라이에이지 노트가 있는 경우 노트를 읽고, 신고자가 미해결 질문에 답변했는지 확인한 후 업데이트된 상태를 제시한 다음 계속 진행합니다. 이미 해결된 질문을 다시 묻지 않습니다.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Teach the user a new skill or concept, within this workspace.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

관련 스킬