한 줄이 완성 프롬프트로
/prompt-spec 스킬 파일 1개
한눈에 보기
1/prompt-spec 스킬 만들기아래 내용을 붙여 넣기만 하면 돼요›2써 보기한 줄 → 25줄›3결정을 기억해요prompt-decisions.md›4막히면 이렇게자주 묻는 것 · 되돌리기›트렌드코어가 직접 만들어 실제로 돌려 본 것이고, 남의 것을 설치하는 게 아니라 아래 내용을 붙여 넣기만 하면 끝이에요.
- 클로드 코드(Claude Code)가 설치돼 있으면 돼요.
- 작업할 프로젝트 폴더 하나. 그 폴더에서 클로드 코드를 여세요.
/prompt-spec 스킬 만들기아래 내용을 붙여 넣기만 하면 돼요
클로드 코드에 아래 문장을 붙여 넣은 뒤, 그 아래 상자 내용을 복사해서 이어 붙이세요. 파일 만드는 건 클로드가 해요.
---
description: 한 줄짜리 요청을 완성된 작업 프롬프트(목표·건드릴 파일·출력 형식·멈출 조건)로 바꿔 준다. 사용자가 "/prompt-spec", "프롬프트로 만들어줘", 또는 짧고 두루뭉술한 요청("로그인 버그 고쳐줘", "이거 빠르게 해줘")을 던졌을 때 사용.
---
## 지금 프로젝트 상태 (자동 수집)
폴더 구조:
!`git ls-files 2>/dev/null | head -80`
최근 커밋:
!`git log --oneline -5 2>/dev/null`
이전에 내린 결정:
!`cat prompt-decisions.md 2>/dev/null | tail -20`
## 할 일
사용자의 한 줄 요청을 아래 6칸이 전부 채워진 **완성 프롬프트**로 다시 쓴다.
비어 있는 칸은 위 프로젝트 상태를 근거로 추정해서 채우고, 추정한 칸에는 `(추정)` 표시를 붙인다.
코드를 고치지 말고, 완성 프롬프트만 보여 준 뒤 "이대로 진행할까요?"라고 묻는다.
```
## 목표
한 문장. 무엇이 어떻게 달라져야 끝인지.
## 건드릴 파일
- 경로 — 이유 (위 폴더 구조에 실제로 있는 파일만. 새로 만들 파일은 [새 파일] 표시)
## 건드리지 않을 것
- 요청과 무관한 파일·기능. 스타일 정리, 리팩터링 금지.
## 출력 형식
결과를 어떤 모양으로 돌려줄지 (diff / 파일 전체 / 표 / 명령어 한 줄 …).
## 멈출 조건
- 이게 확인되면 끝: (테스트 통과 / 화면에서 X가 보임 / 명령 Y가 0으로 종료 …)
- 이 상황이면 멈추고 물어봄: (파일 3개 넘게 건드려야 할 때 / 삭제가 필요할 때 / 두 가지 해석이 갈릴 때)
## 확인 질문
사용자가 답해야만 하는 것만, 최대 2개. 없으면 "없음".
```
## 결정 기록 (진행 답을 받으면 가장 먼저)
사용자가 "진행"(또는 "ㅇㅇ", "고", "해줘")이라고 답하면, **코드를 건드리기 전에 먼저** 아래 한 줄을
`prompt-decisions.md` 맨 아래에 덧붙인다. 파일이 없으면 만든다. 이 단계를 건너뛰지 않는다.
```
YYYY-MM-DD <목표 한 줄> — <건드릴 파일들 쉼표로>
```
기록한 뒤 "결정 기록 1줄 추가했어요" 라고 한 줄 알리고, 그 다음에 작업을 시작한다.
다음에 같은 프로젝트에서 이 스킬이 다시 불리면 위 "이전에 내린 결정"에 그 내용이 올라온다.
## 규칙
- 사용자가 안 한 말을 지어내지 않는다. 모르면 `(추정)` 또는 확인 질문.
- 완성 프롬프트는 화면 한 장에 들어가게. 6칸 합쳐 25줄 안쪽.
- 사용자 요청이 이미 6칸을 다 갖췄으면 그대로 정리만 하고 바로 "진행할까요?"를 묻는다.맨 위 설명(description) 한 줄이 "언제 이 스킬을 쓸지"를 정해요. 느낌표로 시작하는 줄은 스킬이 시작될 때 폴더 상태와 지난 결정을 먼저 읽어 오게 하는 부분이에요.
직접 명령어로 하고 싶다면
프로젝트 폴더 안에 아래 경로로 파일을 만들고 위 내용을 붙여 넣으세요. 폴더 이름 prompt-spec 이 그대로 명령어 /prompt-spec 가 돼요.
.claude/skills/prompt-spec/SKILL.md
앞의 점(.claude)은 숨김 폴더 표시예요. 탐색기에서 안 보이면 "숨김 항목 표시"를 켜세요.
써 보기한 줄 → 25줄
/prompt-spec 뒤에 평소 하던 부탁 한 줄을 그대로 붙이면 돼요.
클로드가 폴더를 읽고 6칸(목표 · 건드릴 파일 · 건드리지 않을 것 · 출력 형식 · 멈출 조건 · 확인 질문)을 채운 완성 프롬프트를 보여 주고 "이대로 진행할까요?"라고 물어요. 확인 질문이 있으면 먼저 답해 주세요. 짐작으로 채운 칸에는 (추정) 표시가 붙으니 그 부분만 고쳐 주면 돼요.
결정을 기억해요prompt-decisions.md
"진행"이라고 답하면 클로드가 그 결정(목표 + 건드릴 파일)을 prompt-decisions.md(결정 기록 메모) 맨 아래에 날짜와 함께 적어 둬요. 다음에 같은 폴더에서 /prompt-spec 을 부르면 그 기록을 먼저 읽고 시작하니까, 같은 걸 다시 안 물어봐요.
2026-09-07 정상 계정은 항상 로그인 성공 — src/api/login.js, src/LoginForm.jsx
막히면 이렇게자주 묻는 것 · 되돌리기
/prompt-spec 을 쳐도 반응이 없어요 — 클로드에게 이렇게 말하고, 끝나면 클로드 코드를 새로 켜세요.
폴더 파일을 못 골라요 — 이 스킬은 깃(git, 파일 변경 기록 장치)으로 폴더 목록을 읽어요. 깃이 꺼진 폴더면 이렇게 말하세요. 다음번부터 파일 목록이 들어가요.
결정 기록이 너무 쌓여서 엉뚱한 옛날 결정을 참고해요 — 스킬은 마지막 20줄만 읽어요. 오래된 줄을 지우면 돼요.
되돌리고 싶어요 — 스킬과 결정 기록을 지우면 원래대로예요. 다른 설정엔 아무 영향이 없어요.
직접 명령어로 하고 싶다면
$ git init $ git add .
반응이 없을 땐 경로가 정확히 .claude/skills/prompt-spec/SKILL.md 인지, 파일 맨 위 --- 두 줄이 빠지지 않았는지 확인하세요. 되돌리려면 .claude/skills/prompt-spec 폴더와 prompt-decisions.md 를 지우면 돼요.
트렌드코어 스킬공유자료실 · 무료