Skip to content

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

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

issue

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

입력

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

만드는 순서

  1. .github/ISSUE_TEMPLATE/task.md의 칸과 순서를 그대로 따라 초안을 만든다
  2. 제목: 타입: 내용 — 커밋과 같은 모양 (한국어 한 줄, 50자 이내, 범위 표시 없음, 타입은 git-convention 스킬 표)
  3. 본문 칸 채우는 법
칸채우는 법
작업 설명무엇을 왜 하는지 1~2줄
요구 사항해야 할 일을 체크박스로 2~5개
참고 사항관련 문서(docs/...)·이슈 번호. 모르면 비워 둔다
완료 조건끝났다고 판단할 기준을 체크박스로 (예: "테스트 통과", "API 문서 반영")

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

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

라벨

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

제목 타입라벨
featfeat
fixfix
testtest
docsdocs
refactorrefactor
chorechore
  • 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: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated 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: 319kUpdated 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: 319kUpdated Claude CodeCodexVerifiedInstall