Community라이팅 & 에디팅github.com

K3639284/skills

프로덕션 엔지니어링 작업을 위한 모듈형, 구성 가능한 AI 에이전트 스킬을 구축합니다.

skills란 무엇인가요?

이 스킬은 사용자가 마주한 문제에 대해 GitHub 이슈를 구조화하고 제출하는 대화형 QA 세션을 제공합니다. 개발자는 문제를 설명하기만 하면 되며, AI 에이전트가 코드베이스를 탐색하여 맥락을 이해하고, 사용자 관점에서 명확하고 내구성 있는 이슈를 작성합니다. 각 이슈는 파일 경로나 라인 번호 대신 프로젝트의 도메인 언어를 사용하여 기술적 세부 사항이 변경되어도 오래 지속되도록 합니다. 복잡한 문제는 여러 개의 독립적인 이슈로 분할하여 병렬 작업을 극대화하며, 종속 관계를 명확히 표시합니다. 이 스킬은 에이전트가 이슈를 제출하기 전에 사용자에게 검토를 요청하지 않으므로, 신속한 문제 보고가 가능하고 개발자는 버그 수정에 집중할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add K3639284/skills

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

문서

QA 세션

대화형 QA 세션을 실행합니다. 사용자가 겪고 있는 문제를 설명합니다. 질문을 명확히 하고, 코드베이스를 탐색하여 맥락을 파악한 후, 내구성이 있고 사용자 중심이며 프로젝트의 도메인 언어를 사용하는 GitHub 이슈를 제출합니다.

사용자가 제기하는 각 이슈에 대해

1. 듣고 가볍게 명확히 하기

사용자가 자신의 말로 문제를 설명하도록 하십시오. 최소 2~3개의 간단한 명확화 질문을 다음에 집중하여 하십시오:

  • 기대한 것과 실제 발생한 것
  • 재현 단계 (명확하지 않은 경우)
  • 일관된 문제인지 간헐적인 문제인지

과도하게 인터뷰하지 마십시오. 설명이 이슈를 제출할 만큼 명확하다면 다음 단계로 넘어가십시오.

2. 백그라운드에서 코드베이스 탐색

사용자와 대화하는 동안 백그라운드에서 에이전트(subagent_type=Explore)를 시작하여 관련 영역을 이해하십시오. 목표는 수정 사항을 찾는 것이 아니라 다음을 수행하는 것입니다:

  • 해당 영역에서 사용되는 도메인 언어 학습 (UBIQUITOUS_LANGUAGE.md 확인)
  • 기능이 무엇을 해야 하는지 이해
  • 사용자 대면 동작 경계 식별

이러한 맥락은 더 나은 이슈를 작성하는 데 도움이 되지만, 이슈 자체는 특정 파일, 라인 번호 또는 내부 구현 세부 사항을 참조해서는 안 됩니다.

3. 범위 평가: 단일 이슈 또는 분할?

제출하기 전에 이것이 단일 이슈인지 여러 이슈로 분할해야 하는지 결정하십시오.

다음과 같은 경우 분할하십시오:

  • 수정 사항이 여러 독립적인 영역에 걸쳐 있는 경우 (예: "양식 유효성 검사가 잘못되었고 성공 메시지가 없으며 리디렉션이 손상됨")
  • 서로 다른 사람이 병렬로 작업할 수 있는 명확히 분리 가능한 문제가 있는 경우
  • 사용자가 여러 개의 별개 실패 모드나 증상을 가진 문제를 설명하는 경우

다음과 같은 경우 단일 이슈로 유지하십시오:

  • 한 곳에서 잘못된 하나의 동작인 경우
  • 모든 증상이 동일한 근본 동작으로 인해 발생하는 경우

4. GitHub 이슈 제출

gh issue create로 이슈를 생성하십시오. 사용자에게 먼저 검토를 요청하지 말고, 그냥 제출하고 URL을 공유하십시오.

이슈는 내구성이 있어야 합니다. 즉, 대대적인 리팩터링 후에도 의미가 있어야 합니다. 사용자 관점에서 작성하십시오.

단일 이슈의 경우

다음 템플릿을 사용하십시오:

## 발생 상황

[사용자가 경험한 실제 동작을 평이한 언어로 설명]

## 기대한 상황

[예상 동작 설명]

## 재현 단계

1. [개발자가 따라할 수 있는 구체적이고 번호가 매겨진 단계]
2. [내부 모듈 이름이 아닌 코드베이스의 도메인 용어 사용]
3. [관련 입력, 플래그 또는 구성 포함]

## 추가 컨텍스트

[이슈 설명에 도움이 되는 사용자 또는 코드베이스 탐색의 추가 관찰. 예: "파일 시스템 레이어가 아닌 Docker 레이어를 사용할 때만 발생" — 도메인 언어를 사용하되 파일을 인용하지 마십시오]

분할의 경우 (여러 이슈)

실제 이슈 번호를 참조할 수 있도록 종속성 순서로 이슈를 생성하십시오 (차단 항목 먼저).

각 하위 이슈에 대해 다음 템플릿을 사용하십시오:

## 상위 이슈

#<상위-이슈-번호> (트래킹 이슈를 생성한 경우) 또는 "QA 세션 중 보고됨"

## 문제점

[이 특정 동작 문제 설명 — 전체 보고서가 아닌 이 부분만]

## 기대한 상황

[이 특정 부분에 대한 예상 동작]

## 재현 단계

1. [이 이슈에 특화된 단계]

## 차단 항목

- #<이슈-번호> (다른 이슈가 해결되어야 이 이슈를 수정할 수 있는 경우)

차단 항목이 없으면 "없음 — 즉시 시작 가능"으로 표시하십시오.

## 추가 컨텍스트

[이 부분과 관련된 추가 관찰]

분할 시:

  • 두꺼운 이슈보다 얇은 이슈를 선호하십시오 — 각각 독립적으로 수정 및 검증 가능해야 함
  • 차단 관계를 정직하게 표시하십시오 — 이슈 B가 이슈 A가 수정될 때까지 실제로 테스트할 수 없다면 그렇게 명시하십시오. 독립적이라면 둘 다 "없음 — 즉시 시작 가능"으로 표시하십시오
  • 종속성 순서로 이슈를 생성하십시오 — "Blocked by"에서 실제 이슈 번호를 참조할 수 있도록
  • 병렬성을 최대화하십시오 — 목표는 여러 사람(또는 에이전트)이 동시에 다른 이슈를 가져갈 수 있도록 하는 것입니다

모든 이슈 본문에 대한 규칙

  • 파일 경로나 라인 번호 없음 — 이는 오래되어 유효하지 않게 됨
  • 프로젝트의 도메인 언어 사용 (UBIQUITOUS_LANGUAGE.md가 있으면 확인)
  • 동작을 설명하고 코드를 설명하지 마십시오 — "동기화 서비스가 패치 적용에 실패합니다"라고 말하고 "42번째 줄에서 applyPatch()가 예외를 던집니다"라고 말하지 마십시오
  • 재현 단계는 필수 — 결정할 수 없으면 사용자에게 물어보십시오
  • 간결하게 유지하십시오 — 개발자가 30초 안에 이슈를 읽을 수 있어야 함

제출 후 모든 이슈 URL(차단 관계 요약 포함)을 출력하고 "다음 이슈, 또는 끝났습니까?"라고 물으십시오.

5. 세션 계속

사용자가 끝났다고 말할 때까지 계속 진행하십시오. 각 이슈는 독립적입니다. 배치하지 마십시오.

관련 스킬