SuperAPI AI Directory

issue-create

Coding & development

View repository

Updated 10-15 21:02

About this skill

Overall flow
flowchart TD
    A[/"변경 요청 감지 또는 명시 호출"/] --> A1{명시 호출?}
    A1 -- 예 --> B
    A1 -- 아니오 --> A2[mode: issue.createMode 확인]
    A2 -->|direct| Z1[조용히 종료 · 원래 요청 계속]
    A2 -->|issue-first| B{git repo + gh auth}
    B -- 실패 --> B1[초안만 남기고 중단] --> Z0[종료]
    B -- 통과 --> C[gate: 성숙도 신호 판정]

    C -->|SKIP| Z1[조용히 종료 · 원래 요청 계속]
    C -->|ASK| C1[AskUserQuestion: 이슈 등록할지 확인]
    C1 -- 아니오 --> Z1
    C1 -- 예 --> S
    C -->|READY| S[요청 분해: 원자 후보 추출·강결합 그룹화]

    S --> S1{분할안 승인?}
    S1 -- 병합·분리 --> S
    S1 -- 취소 --> Z0
    S1 -- 승인 --> D

    subgraph PER["항목마다 반복 (1~5건)"]
      D[search: 유사 열린 이슈 검색] -- 유사 이슈 있음 --> D1[이 항목만 건너뜀]
      D -- 없음 --> E{작업 성격 판정}
      E -->|UI 변경| F1[frontend 항목 채우기]
      E -->|서버 변경| F2[backend 항목 채우기]
      E -->|둘 다| F3[양쪽 모두]
      F1 --> G[labels 확인 후 초안 작성]
      F2 --> G
      F3 --> G
    end

    D1 --> H
    G --> H{초안 N건 일괄 승인?}
    H -- 일부 수정 --> G
    H -- 취소 --> Z0
    H -- 승인 --> I[create × N: 성격 라벨 + status:open · 실패는 건너뛰고 계속]

    I --> M[unlabeled: 성격·상태 라벨 점검]
    M -- 없음 --> J
    M -- 있음 --> M1[제목·본문으로 라벨 제안]
    M1 --> M2{일괄 적용 승인?}
    M2 -- 아니오 --> J
    M2 -- 예 --> M3[label: 이슈별 라벨 부착] --> J

    J[다음 행동 4지선다]
    J -->|착수| K[첫 번호로 issue-start 실행 · 나머지는 안내]
    J -->|이슈 더 등록| A
    J -->|라벨 정리| M1
    J -->|종료| L[이슈 번호와 명령만 안내]
Script path

Among the following the first path that exists를 <skill> is used. If none exist, perform the inline procedure of each reference as is.

.claude/skills/issue-create      # 현재 프로젝트 (Claude Code)
.codex/skills/issue-create       # 현재 프로젝트 (Codex)
~/.claude/skills/issue-create    # 홈 설치
~/.codex/skills/issue-create     # 홈 설치

<skill> 이 .claude/ If under claude, .codex/ If under codex . This determination is used to choose the subagent model.

Subagent

Premise check, duplicate check, and nature determination are judgment tasks, so they are delegated to a cheap model.

claude  .claude/agents/issue-verifier.md   (model: haiku)
codex   .codex/agents/issue-verifier.toml  (model = "gpt-5.6-luna")

If not present, migrate-skill-agent.sh --agent issue-verifier --target home --link --clone install with . If it fails, proceed with the default subagent and report "model pinning failed" in one line.

Execution order

Pre-step — check operation mode

Run this before other premises only when triggered implicitly.

node <skill>/scripts/issue-create.mjs mode
MODE=issue-first   기존 흐름을 계속한다. 설정이 없을 때의 기본값이다.
MODE=direct        조용히 종료하고 원래 변경 요청을 그대로 수행한다.
INVALID_MODE=1     잘못된 값이다. 경고를 남기고 안전하게 issue-first 로 진행한다.

$issue-create, /issue-create, if the user explicitly requested issue registration such as "make an issue" or "register an issue first", skip this step and execute the existing flow.

Step 0 — premise check

git rev-parse --show-toplevel

Tracker authentication is checked automatically by the script. create All modes except fall back to exit 4 when authentication is not set up, telling what needs to be filled in.

provider.type = github   gh 인증. 실패하면 `gh-setup` 스킬로 설치·로그인을 끝낸 뒤 이어서 진행
provider.type = jira     ~/.issue/settings.json 의 provider.jira (baseUrl·projectKey·email)
                         + tokenEnv 가 가리키는 환경변수

gh-setup If there is no in the environment, notify that fact, leave only the issue body draft as markdown, and stop. If it is not a git repository, stop as is.

Step 1 — maturity gate

node <skill>/scripts/issue-create.mjs gate

VERDICT It branches depending on .

READY   바로 2단계로 진행
ASK     AskUserQuestion 으로 한 번 확인. 아니면 종료
SKIP    아무 말 없이 종료하고 원래 요청을 그대로 수행

The criteria are references/maturity-gate.md. If the user /issue-create invoked directly, skip this step.

Step 2 — request decomposition and split approval

references/split-requests.md Follow . Find work boundaries that can be independently implemented, verified, and reverted, not sentence count.

원자 추출       대상 + 변화/증상 + 완료 신호 단위로 후보를 모두 펼친다
강결합 그룹화   API/UI 계약, 공통 완료 기준·근본 원인, 배포·마이그레이션·사용자 흐름 결합을 묶는다
독립성 확인     그룹별 별도 배포 / 검증 / 취소 / 되돌리기가 모두 가능할 때만 쪼갠다
라벨            차이는 보조 신호다. 같은 라벨도 독립적이면 쪼갠다
부분 결합       연결된 후보만 묶고 나머지는 별도 이슈로 둔다
상한            최대 5개. 6개 이상이면 범위를 3~5개로 조정하거나 급한 5개를 고르게 한다

If there is only one task, skip this step and go to Step 3. If there are multiple, title + one-line summary + expected labels show only the list and use AskUserQuestion to receive approve / merge / split / cancel. Do not write the body yet.

Step 3 — per-item duplicate check

Run separately for each confirmed item.

node <skill>/scripts/issue-create.mjs search "<항목 키워드>"

MATCHES If is not 0 and the content overlaps, show that number and title, and excluding only that item proceed with the rest. Omitted items are left in the 건너뜀 line of the final report. If there was only one item, /issue-start #N suggest and exit. If it is ambiguous whether it overlaps, ask with AskUserQuestion whether to "attach to an existing issue / create a new one". For each candidate, subject, outcome, scope, acceptancefilled with candidate/targets create JSON and create for the call, --duplicate-review-filepass as . Open candidates where all four conditions match are not automatically blocked, but without a structured duplicate-of Without a decision id, do not create a new issue. If it cannot be determined or if there is a discrepancy, review-or-createproceed. Only exceptions where review itself is impossible are recorded as --skip-duplicate-review.

Step 4 — Determine the nature of each item

issue-start Use the same signals as in Step 3. The determination result decides the body items and labels.

frontend 신호   화면·버튼·레이아웃·반응형·깨짐, 스크린샷이 있는 요청
backend 신호    API·쿼리·성능·타임아웃·정합성·배치
both            사용자 플로우 전체를 다루거나 API 계약 변경이 화면에 영향

Each item may have a different nature. Do not determine by lumping the entire request together.

Step 5 — Draft creation and batch approval

references/issue-draft.md Follow. If the repository has issue templates, prioritize them. Fill in a draft for each item and the full text at once show it, then receive batch approval / partial revision / cancel via AskUserQuestion.

Step 6 — Registration

references/create-and-handoff.md Follow. Do not register without a nature label. If there is not a single label to use in the repository, references/label-audit.md first go through the label creation procedure of .

For each item, create call separately. For failed items, skip and continue , and collect successes and failures and report once at the end. status:open is automatically attached by the script immediately after successful registration. --label Do not pass it directly.

Step 7 — Check existing issue labels

node <skill>/scripts/issue-create.mjs unlabeled --state open

The output is divided into two axes. UNLABELED_NUMBERSis issues without a nature label, and NO_STATUS_NUMBERSis issues without a progress status label. If both are 0, proceed as is. Otherwise, read the title, body, and PR/branch status to create a suggestion list, receive approval at once via AskUserQuestion, and attach them. For details, references/label-audit.md.

Step 8 — Next action

references/next-actions.md Present the 4-choice options of as is. If "start immediately" is chosen, execute issue-start continuing with the first number, and only guide the remaining numbers. Do not start multiple issues simultaneously because worktrees will conflict.

Final report

When there is one case.

이슈      [#{issue_number} <제목>](<이슈 URL>)
라벨      <붙인 성격 라벨> + status:open
라벨 점검  성격 <n>건 확인 / <m>건 보정, 상태 <p>건 확인 / <q>건 보정
기본 브랜치 <base> (<판별 출처>)
요청 기록  .issue/{issue_number}/request.md
다음      <사용자가 고른 행동>

When there are multiple cases.

이슈      #61 대시보드 기간 필터 추가        (enhancement)
          #62 주문 목록 빈 렌더링 수정        (bug)
          #63 레거시 export 스크립트 제거      (chore)
건너뜀    "알림 배지" — #48 과 중복
실패      없음
라벨 점검  성격 12건 확인 / 3건 보정, 상태 <p>건 확인 / <q>건 보정
요청 기록  .issue/{61,62,63}/request.md
다음      <사용자가 고른 행동> — /issue-start #61 (이후 #62, #63)

건너뜀 과 실패 If there is no corresponding item, omit the line itself.