Skip to content

prgrms-be-devcourse/NBE12-14-final-homestamp / .agents/skills/issue

GitHub 이슈를 템플릿대로 만들고, 사람이 승인하면 올린다. 사람이 /issue 또는 $issue로 부를 때만 쓴다

FileKindSize
SKILL.mdskill md2.8 KB
agents/openai.yamlconfig43 B
---
name: issue
description: GitHub 이슈를 템플릿대로 만들고, 사람이 승인하면 올린다. 사람이 /issue 또는 $issue로 부를 때만 쓴다
disable-model-invocation: true
---

# issue

할 일을 GitHub 이슈로 만든다. **초안을 먼저 보여 주고, 사람이 승인해야만** 올린다.

## 입력

할 일 설명. 예) `/issue 관리자 로그인 API 만들기, JWT로`
설명이 한 줄도 없으면 무엇을 할지 한 번 묻는다.

## 만드는 순서

1. `.github/ISSUE_TEMPLATE/task.md`의 칸과 순서를 그대로 따라 초안을 만든다
2. 제목: `타입: 내용` — 커밋과 같은 모양 (한국어 한 줄, 50자 이내, 범위 표시 없음, 타입은 `git-convention` 스킬 표)
3. 본문 칸 채우는 법

| 칸 | 채우는 법 |
|---|---|
| 작업 설명 | 무엇을 왜 하는지 1~2줄 |
| 요구 사항 | 해야 할 일을 체크박스로 2~5개 |
| 참고 사항 | 관련 문서(`docs/...`)·이슈 번호. 모르면 비워 둔다 |
| 완료 조건 | 끝났다고 판단할 기준을 체크박스로 (예: "테스트 통과", "API 문서 반영") |

설명에 없는 내용은 지어내지 않는다. 모르는 칸은 비워 두고 초안 아래에 "채울 칸: ○○"으로 알린다.

4. 초안과 함께 이 작업에 맞는 **브랜치 이름**도 `git-convention` 규칙으로 제안한다

## 라벨

제목의 타입과 **같은 이름의 라벨 하나**를 붙인다. 라벨은 저장소에 미리 만들어 둔 것만 쓴다(`gh label list`로 확인, 없으면 만들지 말고 알린다).

| 제목 타입 | 라벨 |
|---|---|
| `feat` | `feat` |
| `fix` | `fix` |
| `test` | `test` |
| `docs` | `docs` |
| `refactor` | `refactor` |
| `chore` | `chore` |

- **`style`**: UI 스타일·CSS만 바꾸는 일이면 타입 라벨에 **더해서** 붙인다(제목 타입은 위 여섯 개 중 하나, `style`은 커밋 타입이 아님)
- 라벨은 초안에 `라벨: feat`처럼 보여 주고 승인받는다

## 올리기 (사람이 "올려줘"라고 승인한 뒤에만)

```
gh issue create --title "<제목>" --label <라벨>[,style] --body-file - <<'BODY'
<본문>
BODY
```

- 승인 없이 올리지 않는다. 초안을 고쳐 달라고 하면 고친 초안을 다시 보여 주고 다시 승인을 받는다
- 본문 끝에 `Generated with ...` 같은 AI 도구 서명을 넣지 않는다 (Claude·Codex 공통, `docs/decisions.md`)
- `gh`가 없거나 로그인이 안 돼 있으면 올리지 말고 `gh auth login`이 필요하다고 알린다
- 올린 뒤 **이슈 번호와 URL**을 보여 준다. 이 번호는 나중에 `pr-body`가 `closes #번호`로 PR에 연결한다
- 브랜치를 만들어 달라고 하면 `git switch -c <브랜치>`를 실행한다 (`dev` 최신 기준: 먼저 `git fetch origin` 후 `git switch -c <브랜치> origin/dev`)
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall