speccommit 3e4240a · v0.1.0SKILL.md · 요구사항 분석

스펙 작성

다섯 단계에 걸쳐 질문해 모호한 의도를 실행 가능한 스펙으로 만들고 GitHub issue 로 등록합니다.

GitHub 에 issue 를 만들고, 스펙을 Codex 에 보내 평가할 수 있으며, --execute 사용 시 새 git worktree 에서 claude -p 를 실행합니다.

npx skills add garrytan/gstack --skill spec

권한: read-repo
write-files
shell
network
호환 도구: Claude Code, Codex, Cursor, Copilot
GitHub: 138.5k
출처: 커뮤니티 · Garry Tan
상태: 스캔 통과
라이선스: MIT
카테고리: 요구사항 분석
저장소: github.com/garrytan/gstack/spec

핵심 규칙

첫 메시지 직후 issue 를 만들지 않고 항상 1단계부터 시작하며, 구현 방안은 제안하지 않습니다.

실행 단계

01단계이유 파악
영향받는 사람, 현재 동작, 기대 동작, 왜 지금인지, 완료 기준을 확인하고 기본으로 gh issue list 로 중복을 검사합니다.
02단계범위 확정
제외 범위, 영향받는 시스템, 순서 제약, 최소 기능 단위, 실패와 롤백 방법을 정합니다.
03단계코드 읽고 질문
질문 전에 Grep, Glob, Read 로 코드를 확인해 path:line 을 인용하고 데이터 모델, API, 백그라운드 작업, UI, 인프라, 테스트를 묻습니다.
04단계초안 검토
issue 초안 전체를 보여 주고 틀린 점을 물으며 사용자가 확인할 때까지 수정합니다.
05단계품질 점검 후 등록
내용 검토, 필수 민감정보 스캔, Codex 품질 점수를 거쳐 issue 를 등록하고 로컬에 보관하며, --execute 로 에이전트를 실행할 수 있습니다.

권한 설명 (SKILL.md 기준)

기능	필요 여부	설명
파일 쓰기	필요 없음	allowed-tools 에 Write/Edit 이 없어 프로젝트 코드를 수정하지 않습니다. 스펙 보관본은 셸 스크립트가 로컬 상태 디렉터리에 씁니다.
명령 실행	필요	gh, gstack 보조 스크립트, git worktree, 그리고 --execute 시 claude -p 를 실행합니다.
네트워크 송신	일부 필요	gh 로 GitHub 에 접근해 중복 확인과 issue 생성을 하고, 품질 평가에 Codex 를 사용할 수 있습니다.

SKILL.md 프런트매터(YAML)commit 3e4240a · v0.1.0

---
name: spec
preamble-tier: 3
version: 0.1.0
description: Turn vague intent into a precise, executable spec in five phases. (gstack)
allowed-tools:
  - Bash
  - Read
  - Grep
  - Glob
  - AskUserQuestion
triggers:
  - spec this out
  - file an issue
  - write up a ticket
  - turn this into an issue
  - make this a github issue
  - turn this into a backlog item
---

핵심 규칙

실행 단계

01단계이유 파악

02단계범위 확정

03단계코드 읽고 질문

04단계초안 검토

05단계품질 점검 후 등록

권한 설명 (SKILL.md 기준)

SKILL.md 프런트매터(YAML)

관련 스킬