gh-issue-workflowlisted

# GitHub Issue Workflow ## Purpose 채팅(휘발성)과 plan.md(정적) 사이의 빈 곳을 GitHub Issue가 채운다. 1인 사용자 + AI agent 협업에서: - 사용자가 발견한 bug/feature 요청 → issue로 backlog (chat을 끊지 않고) - 의사결정이 필요한 갈림길 → issue body에 옵션 정리 → 사용자가 비동기로 결정 → AI agent가 fetch해서 작업 - 모든 결정의 영구 검색 가능 기록 (cross-link `#N`, label, milestone 활용) dyld-vantage 프로젝트의 실제 운용 패턴(`#52~#55`)을 일반화. 1인 시나리오에 최적화 (팀 assign / reviewer 자동화 같은 건 안 함). ## When to Invoke | 트리거 | 행동 | |--------|------| | `/uzys:spec` 시작 + GitHub remote 존재 | "epic issue 만들까?" 1회 권유 (선택) | | `/uzys:plan` 시작 | OPEN issue 목록 fetch → 우선순위 결정 후 todo.md로 이관 | | `/uzys:build` 중 사용자가 새 bug/req 발견 | "issue로 backlog?" 권유 | | `/uzys:build` commit | message에 `Refs #N` (작업 진행 기록) | | `/uzys:ship` PR 작성 | body에 `Closes #N` (자동 close) | | 의사결정 갈림길 등장 | issue body에 `방향성 (OPEN)` 로 등록 → 사용자 대기 | ## Pre-conditions - 프로젝트가 GitHub remote 보유 (`git remote -v`로 확인) - `gh` CLI 설치 + 인증 (`gh auth status`로 확인). MCP `mcp__github__*` 사용 가능하면 우선. - `docs/SPEC.md`에 `issue_tracking: enabled` 라인 있을 때만 활성 (opt-in). 기본 비활성. 조건 미충족이면 본 skill 자동 skip — 에러 X. ## Process ### 1. ISSUE.template.md 5섹션 강제 새 issue 생성 시 본 skill 디렉토리의 `ISSUE.template.md`를 body로 채운다. ``` ## 배경 — Why ## 전제 (Given) — 시작 전 의존성/조건 ## 방향성 — OPEN | YYYY-MM-DD 확정 ## 적용 대상 / AC (When → Then) ## 후속 작업 — Next ``` 비어있는 섹션은 통째로 삭제 (placeholder 금지). BDD 매핑: 전제(Given) → 적용 대상(When) → AC(Then). ### 2. 방향성 상태로 작업 가능 여부 판정 | 상태 | 의미 | AI agent 행동 | |------|------|--------------| | **OPEN** | 사용자 결정 대기 | 본