‹ 스킬공유자료실#012 · 9월 7일 꿀팁

한 줄이 완성 프롬프트로

/prompt-spec 스킬 파일 1개

단계 3개
AI 공부방 오픈카카오톡 · 막히면 같이 공부해요
입장하기

한눈에 보기

1/prompt-spec 스킬 만들기아래 내용을 붙여 넣기만 하면 돼요›2써 보기한 줄 → 25줄›3결정을 기억해요prompt-decisions.md›4막히면 이렇게자주 묻는 것 · 되돌리기›
"로그인이 가끔 안 돼요, 고쳐 주세요" 같은 한 줄을, 클로드가 헤매지 않게 6칸이 채워진 완성 프롬프트(제대로 된 작업 지시서)로 바꿔 주는 스킬이에요. 6칸은 목표 · 건드릴 파일 · 건드리지 않을 것 · 출력 형식 · 멈출 조건 · 확인 질문이에요.

트렌드코어가 직접 만들어 실제로 돌려 본 것이고, 남의 것을 설치하는 게 아니라 아래 내용을 붙여 넣기만 하면 끝이에요.
준비물
  1. 클로드 코드(Claude Code)가 설치돼 있으면 돼요.
  2. 작업할 프로젝트 폴더 하나. 그 폴더에서 클로드 코드를 여세요.
1

/prompt-spec 스킬 만들기아래 내용을 붙여 넣기만 하면 돼요

클로드 코드에 아래 문장을 붙여 넣은 뒤, 그 아래 상자 내용을 복사해서 이어 붙이세요. 파일 만드는 건 클로드가 해요.

이 프로젝트에 /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)은 숨김 폴더 표시예요. 탐색기에서 안 보이면 "숨김 항목 표시"를 켜세요.

이렇게 되면 성공 — 클로드 코드를 새로 켠 뒤 대화창에 /prompt-spec 을 쳤을 때 자동완성 목록에 떠요.
2

써 보기한 줄 → 25줄

/prompt-spec 뒤에 평소 하던 부탁 한 줄을 그대로 붙이면 돼요.

/prompt-spec 로그인이 가끔 안 돼요. 고쳐 주세요.

클로드가 폴더를 읽고 6칸(목표 · 건드릴 파일 · 건드리지 않을 것 · 출력 형식 · 멈출 조건 · 확인 질문)을 채운 완성 프롬프트를 보여 주고 "이대로 진행할까요?"라고 물어요. 확인 질문이 있으면 먼저 답해 주세요. 짐작으로 채운 칸에는 (추정) 표시가 붙으니 그 부분만 고쳐 주면 돼요.

이렇게 되면 성공 — 건드릴 파일에 적힌 파일이 내 폴더에 실제로 있는 파일이에요. 없는 파일을 지어냈다면 클로드가 폴더를 못 읽은 거예요. 아래 '막히면 이렇게'를 보세요.
3

결정을 기억해요prompt-decisions.md

"진행"이라고 답하면 클로드가 그 결정(목표 + 건드릴 파일)을 prompt-decisions.md(결정 기록 메모) 맨 아래에 날짜와 함께 적어 둬요. 다음에 같은 폴더에서 /prompt-spec 을 부르면 그 기록을 먼저 읽고 시작하니까, 같은 걸 다시 안 물어봐요.

진행
기록은 이렇게 쌓여요
2026-09-07 정상 계정은 항상 로그인 성공 — src/api/login.js, src/LoginForm.jsx
이렇게 되면 성공 — "진행" 뒤에 클로드가 "결정 기록 1줄 추가했어요"라고 알려 줘요. 이 메모는 그냥 글이라 직접 고치거나 지워도 돼요.
이 스킬은 프롬프트를 써 주는 것까지예요. "진행"이라고 답한 뒤에 클로드가 실제 작업을 시작해요. 완성 프롬프트에 적힌 "멈출 조건"이 마음에 안 들면 진행 전에 고쳐 달라고 하세요.
4

막히면 이렇게자주 묻는 것 · 되돌리기

/prompt-spec 을 쳐도 반응이 없어요 — 클로드에게 이렇게 말하고, 끝나면 클로드 코드를 새로 켜세요.

/prompt-spec 스킬이 안 잡혀요. 파일 위치랑 맨 윗부분이 맞는지 확인해서 고쳐 주세요.

폴더 파일을 못 골라요 — 이 스킬은 깃(git, 파일 변경 기록 장치)으로 폴더 목록을 읽어요. 깃이 꺼진 폴더면 이렇게 말하세요. 다음번부터 파일 목록이 들어가요.

이 폴더에 깃(변경 기록)을 켜고 지금 있는 파일들을 다 등록해 주세요.

결정 기록이 너무 쌓여서 엉뚱한 옛날 결정을 참고해요 — 스킬은 마지막 20줄만 읽어요. 오래된 줄을 지우면 돼요.

prompt-decisions.md 에서 오래된 기록은 지워 주세요.

되돌리고 싶어요 — 스킬과 결정 기록을 지우면 원래대로예요. 다른 설정엔 아무 영향이 없어요.

prompt-spec 스킬이랑 prompt-decisions.md 를 다 지워서 원래대로 돌려 주세요.
직접 명령어로 하고 싶다면
$ git init
$ git add .

반응이 없을 땐 경로가 정확히 .claude/skills/prompt-spec/SKILL.md 인지, 파일 맨 위 --- 두 줄이 빠지지 않았는지 확인하세요. 되돌리려면 .claude/skills/prompt-spec 폴더와 prompt-decisions.md 를 지우면 돼요.

AI 공부방 오픈카카오톡 · 막히면 같이 공부해요
입장하기
‹ 다른 자료 보러 가기

트렌드코어 스킬공유자료실 · 무료