# 스펙 작성 (spec)

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

- 카테고리: [요구사항 분석](https://www.myskills.tools/ko/categories/requirements/)
- 출처: 커뮤니티 · Garry Tan
- 저장소: https://github.com/garrytan/gstack/tree/main/spec (commit 3e4240a · v0.1.0)
- SKILL.md: https://github.com/garrytan/gstack/blob/main/spec/SKILL.md
- 설치 명령: `npx skills add garrytan/gstack --skill spec`
- 라이선스: MIT
- 호환 도구: Claude Code, Codex, Cursor, Copilot
- 권한: read-repo ✓, write-files ✗, shell ✓, network ✓
- 상태: 스캔 통과
- 규칙 스캔으로 모든 위험을 찾을 수는 없습니다. 설치 전에 이 스킬의 SKILL.md를 읽고 권한을 확인하세요.
- ⚠ GitHub 에 issue 를 만들고, 스펙을 Codex 에 보내 평가할 수 있으며, --execute 사용 시 새 git worktree 에서 claude -p 를 실행합니다.

## 핵심 규칙

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

## 실행 단계

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

## 권한 설명 (SKILL.md 기준)

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

## SKILL.md 프런트매터(YAML)

```yaml
---
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
---
```

홈: https://www.myskills.tools/ko/ · URL: https://www.myskills.tools/ko/skills/spec/