Community생산성 & 협업github.com

write-issue

문제(버그, 기능 또는 작업)에 대한 설명을 프로젝트의 issues 폴더에 CommonMark 파일로 작성하여 이슈 트래커(Redmine, GitHub, GitLab)에 복사할 수 있도록 준비합니다. 사용자가 해결해야 할 문제나 수행해야 할 작업을 설명할 때 사용하세요.

write-issue란 무엇인가요?

이 스킬은 사용자의 설명을 바탕으로 이슈 텍스트를 준비하여 `issues/` 폴더에 CommonMark 파일로 저장합니다. 사용자는 이 파일의 내용을 복사하여 Redmine, GitHub, GitLab 등의 이슈 트래커에 붙여넣고 담당자, 우선순위, 버전 등을 설정합니다. 스킬은 이슈를 트래커에 직접 생성하지 않으며, 읽기 전용 작업만 수행합니다. 버그, 기능, 작업 세 가지 유형을 분류하고 프로젝트 코드를 검토하여 설명의 정확성을 확인하며, 누락된 정보가 있으면 사용자에게 질문합니다. 최종 파일은 `issues/<YYYY-MM-DD>-<slug>.md` 형식으로 생성되며, 제목, 컨텍스트, 설명, 재현 단계(버그 시), 예상 동작, 수용 기준, 기술 노트, 참조 등의 구조를 포함합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gabriele-murara/team-skills/tree/HEAD/plugins/issues/skills/write-issue

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

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

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

문서

이슈 작성하기

사용자의 설명($ARGUMENTS 및 대화 내용)을 바탕으로 이슈 텍스트를 준비합니다. 사용자는 이 텍스트를 이슈 트래커에 복사하여 이슈를 생성하고 담당자, 우선순위, 버전 등을 설정합니다. 이 스킬은 이슈 트래커에 이슈를 생성하지 않습니다.

이슈 트래커: 읽기 전용

이슈 트래커(Redmine, GitHub, GitLab)에서 에이전트는 이슈를 읽기만 할 수 있습니다. 사용자가 요청하더라도 이슈를 절대 수정해서는 안 됩니다:

  • 생성, 수정, 닫기, 재열기, 삭제 금지;
  • 댓글, 노트, 첨부파일, 소요 시간 금지;
  • 상태, 담당자, 우선순위, 버전, 레이블 변경 금지.

읽기 전용 요청만 사용하세요: -X나 데이터 없이 curl(GET만 사용), gh issue view, gh issue list. POST, PUT, PATCH, DELETE는 절대 금지, gh issue create, edit, comment, close, reopen, delete 같은 명령도 금지입니다. 이슈 트래커에 텍스트를 입력해야 한다면 issues/ 폴더에 파일을 작성하세요. 사용자가 직접 복사합니다.

1. issues 폴더

프로젝트 루트(git 저장소 루트, 있다면)에는 issues/ 폴더가 있어야 하며, 자기 자신을 제외한 모든 내용을 무시하는 .gitignore 파일이 포함되어야 합니다:

*
!.gitignore

폴더나 .gitignore가 없으면 생성하세요. .gitignore가 다른 내용으로 이미 존재한다면 수정하지 말고 사용자에게 알리세요.

2. 정보 수집 및 확인

  1. 요청을 분류하세요: 버그, 기능 또는 작업 (유지보수, 업데이트, 리팩토링, 문서화 등).
  2. 설명된 내용을 프로젝트 코드에서 확인하세요: 언급된 파일, 클래스, 라우트, 테이블, 동작을 찾아 실제로 존재하고 설명대로 동작하는지 확인하세요. 관련 파일을 기록하세요.
  3. 누락되거나 모호한 정보를 파악하세요, 예:
    • 버그: 재현 단계, 예상 동작과 실제 동작, 환경(프로덕션, 스테이징, 로컬), 오류 메시지 또는 로그;
    • 기능: 사용자, 수행해야 할 작업, 경계 사례, 제약 조건;
    • 모든 유형: 이슈가 해결되었다고 판단할 기준.
  4. 필요한 정보가 누락되었거나 코드가 설명과 일치하지 않으면 파일을 작성하기 전에 사용자에게 물어보세요. 질문은 한 번에 모두, 정말 필요한 것만 하세요.

해결책을 제안하거나 구현하지 마세요: 이슈는 문제와 예상 결과를 설명합니다. 기술 노트는 작업을 수행할 사람을 안내하기 위한 것입니다.

3. 파일 작성

issues/<YYYY-MM-DD>-<slug>.md 파일을 작성하세요. 여기서 slug는 제목을 소문자로, 단어를 -로 연결하고 특수 문자를 제거한 것입니다(최대 50자). 파일이 이미 존재하면 -2, -3... 접미사를 추가하세요.

파일 구조:

# <간결하고 구체적인 제목>

## 컨텍스트

[문제 또는 작업이 위치한 곳과 필요한 이유.]

## 설명

[버그: 현재 동작. 기능/작업: 수행해야 할 작업.]

## 재현 단계

1. [...]

## 예상 동작

[...]

## 수용 기준

- [ ] [확인 가능한 조건]

## 기술 노트

- `경로/파일` — [해당 파일이 중요한 이유]

## 참조

- [링크, 관련 이슈, 로그, 스크린샷]

규칙:

  • 재현 단계는 버그에만 포함하세요. 예상 동작은 버그와 기능 모두에 포함하세요. 기술 노트와 참조가 비어 있으면 생략하세요.
  • # 제목 행은 이슈 트래커의 제목 필드에 들어가고, ## 제목 이하는 설명에 들어갑니다.
  • CommonMark 형식; 코드와 로그는 언어를 지정하여 코드 블록으로 작성하세요.
  • 언어: 한국어. 이모지 사용 금지.
  • 대화에 참여하지 않은 사람도 이해할 수 있도록 간결하고 명확하게 작성하세요: "위에서 말한 대로" 또는 세션에 대한 언급은 금지입니다.

4. 사용자에게 응답

다음을 알리세요:

  • 생성된 파일의 경로;
  • 제안된 제목과 유형(버그, 기능, 작업);
  • 이슈 트래커에 이슈를 생성한 후에는 파일 이름에 이슈 번호를 포함하여 (예: issues/123-<slug>.md) 이름을 변경하는 것이 좋습니다. 이렇게 하면 트래커에 접근할 수 없어도 open-issue 123 명령으로 파일을 찾을 수 있습니다.

관련 스킬