회의에서 “이 기능 만들자”는 말이 나오면 누군가는 그 말을 개발자가 보고 만들 수 있는 문서인 PRD로 옮겨야 합니다. 앤트로픽의 공식 기획 플러그인 Product Management(프로덕트 매니지먼트)에 든 write-spec 스킬은 아이디어나 메모를 PRD 틀에 맞춰 써 줍니다. 무료이지만 클로드 유료 요금제의 사용량을 씁니다. 가상 서비스의 회의 메모로 클로드 코드(Claude Code)에 같은 요청을 스킬 없이 2번, 스킬을 불러 2번 보냈습니다.
- 회의 메모·해지 사유·고객 문의 파일 세 개를 주면 4번 모두 1분 남짓에 PRD를 썼습니다. 대표가 “하는 김에” 얹은 기능 3개는 4번 모두 이번 범위에서 뺐습니다.
- 메모에 숨겨 둔 마감 시각 문제도 4번 모두 풀었습니다. 차이는 문서의 꼴입니다. 스킬을 부른 2번만 요구사항을 우선순위 세 단계로 나누고, 항목마다 “이러면 완성” 기준을 붙였습니다.
- 스킬 안내문의 기준으로 채점하니 스킬 없이 5·5점, 스킬 9·10점이었습니다. 사용량 차이는 한 번에 0.03~0.07달러(API 단가)였습니다.
결과부터 보기: 같은 회의 메모로 받은 PRD 4개
실습 자료는 가상의 반찬 정기배송 서비스 “찬찬식탁”의 파일 세 개입니다. 서비스와 사람 이름은 모두 지어낸 것입니다. 만들려는 기능은 구독자가 앱에서 한 주 배송을 쉬는 “배송 건너뛰기”입니다. 세 파일에는 아래 내용을 넣어 두었습니다.
| 자료 | 넣어 둔 것 |
|---|---|
| 회의_메모.txt | 대표는 건너뛰기에 더해 메뉴 바꾸기·선물하기·포인트 적립도 같이 넣자고 함. 개발은 4주 안에 건너뛰기 하나만 가능하다고 함. 12월 15일 연말 프로모션 전에 열어야 함. 결제는 화요일 오전 9시이고 결제 48시간 전까지만 자동으로 멈출 수 있음. 재료 발주는 월요일 낮 12시에 확정. 못 정한 것 3개(연속 몇 주까지, 쿠폰을 줄지, 마감 뒤 요청) |
| 해지_사유.csv | 8~10월 해지 설문 150건. “이번 주만 쉬고 싶은데 방법이 없어서”가 54건(36%)으로 1위 |
| 고객_문의.txt | 10월 카톡 문의 7건. “한 주만 빼 주세요”, “빼 달라 했는데 배송이 왔어요” 등. 선물하기 문의도 1건 |
숨겨 둔 문제는 마감 시각입니다. 발주 확정(월요일 낮 12시)만 보고 건너뛰기 마감을 월요일로 잡으면 결제를 자동으로 멈출 수 없습니다. 화요일 오전 9시 결제의 48시간 전인 일요일 오전 9시가 먼저 오기 때문입니다.
직접 눌러 보기: 스킬 없이 1 · 스킬 없이 2 · 스킬 1 · 스킬 2. 4번 모두 결과는 “PRD.md” 한 개였고, 내용은 고치지 않고 웹페이지로만 바꿨습니다.
| 조건 | 건너뛰기 마감 | 요구사항 정리 | 점수 |
|---|---|---|---|
| 스킬 없이 1 | 일요일 오전 9시 | 상황별 줄글 | 5 |
| 스킬 없이 2 | 일요일 오전 9시 | 표(필수·권장 두 단계) | 5 |
| 스킬 1 | 일요일 오전 9시 | P0 6개·P1 4개·P2, 항목마다 완성 기준 | 9 |
| 스킬 2 | 일요일 오전 9시 | P0 7개·P1 3개·P2, 항목마다 완성 기준 | 10 |
직접 실행 확인한 날짜 2026-11-12
- 실행 환경
- macOS 26.1 · Claude Code 2.1.299 · 소넷(Sonnet) 5.5 · 생각 깊이 중간 (4번 모두 같은 설정)
- 설치 난이도
- 명령 두 줄(공식 README)
- 비용
- 플러그인 무료. 한 번에 API 단가로 스킬 없이 0.30~0.33달러, 스킬 0.36~0.37달러어치
- 라이선스
- Apache-2.0 · anthropics/knowledge-work-plugins(별 35,502개, 2026-11-12 기준)
PRD 뜻: 무엇을 왜 만드는지 적는 문서
PRD(Product Requirements Document)는 제품 요구사항 문서입니다. 만들 기능이 누구의 어떤 문제를 푸는지, 어디까지 만들고 어디서 멈추는지, 다 만들었는지를 무엇으로 판단하는지 적습니다. 국내에서는 보통 기능 기획서라고도 부릅니다. 화면 그림이나 코드 설계는 보통 다음 단계 문서로 넘깁니다.
write-spec 스킬 안내문이 정한 PRD의 칸은 여덟 개입니다.
| 칸 | 적는 것 |
|---|---|
| 문제 정의 | 누가 어떤 문제를 겪는지, 풀지 않으면 무엇을 잃는지 2~3문장. 근거 자료를 붙임 |
| 목표 | 숫자로 잴 수 있는 결과 3~5개. “버튼 만들기”가 아닌 “해지 절반으로”처럼 결과로 적음 |
| 비목표 | 이번에 하지 않는 것 3~5개와 이유. 만드는 도중에 범위가 불어나는 것을 막는 칸 |
| 사용자 스토리 | “~인 사용자로서, ~하고 싶다, ~하기 위해” 꼴의 문장. 오류·마감 뒤 같은 예외도 포함 |
| 요구사항 | P0(없으면 출시 못 함)·P1(곧 이어서)·P2(이번엔 안 하지만 막지 않게 설계)로 나누고 항목마다 완성 기준을 붙임 |
| 성공 지표 | 출시 직후 바로 움직이는 선행 지표와 몇 달 뒤 움직이는 후행 지표. 목표 숫자와 재는 시점 |
| 열린 질문 | 아직 답이 없는 질문. 누가 답해야 하는지, 시작 전에 꼭 정해야 하는지를 표시 |
| 일정 | 바꿀 수 없는 마감, 다른 팀·외부 서비스에 걸린 일, 나눠서 낼 순서 |
대표가 넣자던 기능 3개: 4번 모두 뺐습니다
회의 메모에서 대표는 건너뛰기를 만드는 김에 메뉴 바꾸기, 선물하기, 포인트 적립도 같이 넣자고 했습니다. 4번 모두 이 셋을 이번 범위에서 뺐고, 이유로 개발 쪽의 “4주 안에 건너뛰기 하나만 가능, 넷 다는 불가능”을 들었습니다. 스킬을 부른 2번은 이유를 기능마다 따로 적었습니다. 포인트 적립은 해지 사유 어디에도 근거가 없고, 선물하기는 문의 7건 가운데 1건뿐이라는 식입니다.
숨겨 둔 마감 시각 문제도 4번 모두 풀었습니다. 건너뛰기 마감을 일요일 오전 9시로 잡았고, 결제를 멈출 수 있는 시한이 발주 확정보다 먼저 온다는 이유를 적었습니다.

회의에서 못 정한 3개에는 4번 모두 같은 임시값을 달았습니다. 연속 건너뛰기는 2주까지로 하되 나중에 바꿀 수 있는 설정값으로 두고, 쿠폰은 첫 출시에서 빼고, 마감 뒤 요청은 앱에서 막고 고객센터로 안내합니다. 4번 모두 이 값이 확정이 아니며 대표와 운영 담당이 정해야 한다고 적었습니다.
해지를 얼마나 줄일지의 목표도 4번 모두 같았습니다. “쉬고 싶은데 방법이 없어서” 해지를 지금의 절반으로 줄인다는 것입니다. 자료에 없는 숫자라서 4번 가운데 3번은 이 목표가 제안이나 가정이라고 표시했습니다.
스킬을 불렀을 때 달라진 것
첫 번째 차이는 요구사항입니다. 스킬 없이 받은 1번째는 요구사항을 상황별 줄글로 썼습니다. 2번째는 표로 정리하고 필수·권장 두 단계를 달았습니다. 어느 쪽에도 “어떻게 되면 완성인지”는 따로 없었습니다.

스킬을 부른 2번은 요구사항을 P0·P1·P2 세 단계로 나누고, P0 항목마다 완성 기준을 붙였습니다. 형식은 “Given(이런 상황에서) / When(이렇게 하면) / Then(이렇게 된다)”과 체크 목록입니다. 예를 들어 결제 연동 항목에는 “결제 대행사 호출이 실패하면 건너뛰기를 접수된 것으로 처리하지 않는다”, “마감 뒤에는 호출을 시도하지 않는다”가 들어 있습니다. 개발자가 이 문장을 그대로 시험 항목으로 쓸 수 있습니다.

두 번째 차이는 성공 지표입니다. 4번 모두 목표 숫자와 재는 방법을 표로 냈습니다. 스킬 쪽만 지표를 출시 뒤 1~4주에 볼 선행 지표와 1~3개월에 볼 후행 지표로 나눴습니다. 대표가 원한 “해지가 얼마나 줄었나”는 몇 달 뒤에야 보이는 숫자입니다. 선행 지표가 따로 있으면 그 전에 카톡 수작업 요청과 잘못 결제된 건수부터 확인할 수 있습니다.

세 번째 차이는 열린 질문입니다. 스킬 없이 받은 2번은 못 정한 3개와 임시값을 한 목록에 모았습니다. 스킬 쪽은 질문마다 답할 사람(대표·운영·개발)을 적고, 시작 전에 꼭 정할 질문 3개와 만들면서 정해도 되는 질문을 나눴습니다. 질문 수는 7개와 9개였습니다.

스킬 쪽 2번은 “~로서, ~하길 원한다” 꼴의 사용자 스토리도 9개씩 넣었습니다. 구독자, 운영 담당, 대표 세 역할로 나눴고 마감이 지난 구독자의 스토리도 있습니다.
스킬 쪽이 더 못한 곳도 있습니다. 스킬 1번째는 목표를 6개 적어서 안내문의 “3~5개”를 넘겼습니다. 스킬 쪽 문서에는 “Given/When/Then”, “stretch”, “Open Questions” 같은 영어 낱말이 섞여 나옵니다.
복사해 쓰는 요청문과 실습 자료
아래 요청문을 그대로 썼습니다. 스킬 조건에서는 맨 앞에 /product-management:write-spec을 붙였습니다.
'배송 건너뛰기' 기능 PRD(기획서)를 써 줘. 이 폴더의 회의_메모.txt, 해지_사유.csv, 고객_문의.txt를 보고 써서 PRD.md 파일로 저장해 줘. 지금은 더 답해 줄 사람이 없으니 자료만 보고 써 줘.
내 일에 쓸 때는 기능 이름과 파일 이름만 바꿉니다. 물어볼 사람이 있으면 마지막 문장을 빼고 대화로 진행합니다. 스킬 안내문은 그 경우 문제, 대상 사용자, 성공 지표, 제약을 중요한 것부터 몇 개씩 묻고 나서 쓰도록 되어 있습니다. 이번에는 답해 줄 사람이 없는 조건으로만 해 봤습니다.
실습 자료 내려받기(prd-practice.zip): 회의 메모, 해지 사유, 고객 문의, 요청문, 채점 기준을 넣었습니다. 좋은 답이라면 건너뛰기 마감을 일요일 오전 9시나 그 전으로 잡고, 메뉴 바꾸기·선물하기·포인트 적립을 이번 범위에서 뺍니다.
1단계. 플러그인 넣기 (약 1분)
이 단계에서는 클로드 코드가 write-spec 안내문을 읽을 수 있게 합니다. 플러그인 README에 적힌 설치 명령은 터미널에서 아래 두 줄입니다. 이 설치 명령은 이번에 실행하지 않았고, 이 부분은 공식 문서 기준입니다.
claude plugin marketplace add anthropics/knowledge-work-plugins
claude plugin install product-management@knowledge-work-plugins
설치하지 않고 한 번만 써 보려면 저장소를 내려받아 --plugin-dir로 플러그인 폴더를 가리킵니다. 플러그인이 그 실행에만 붙습니다. 이번 실험은 플러그인 폴더 사본에 이 옵션을 써서 했습니다.
git clone https://github.com/anthropics/knowledge-work-plugins
claude --plugin-dir knowledge-work-plugins/product-management
이렇게 나오면 성공 이번 실행에서는 스킬 2번 모두 명령 목록에 product-management:write-spec이 올라왔고, 세션 기록에 안내문의 요구사항 분류와 범위 관리 항목이 들어간 것을 확인했습니다.
command not found: claude가 나오면 터미널을 닫았다 다시 열고claude --version을 먼저 확인합니다.- 필요 없어지면
claude plugin uninstall product-management@knowledge-work-plugins로 지웁니다. - 플러그인에는 슬랙·노션·리니어 같은 외부 연결 설정도 들어 있습니다. 이번에는 연결하지 않고 폴더 속 파일만으로 했습니다.
플러그인에는 write-spec 말고도 스킬이 7개 더 있습니다. 아래 설명은 각 스킬 안내문의 소개 문장 기준입니다. 이 가운데 synthesize-research는 기획 플러그인 리뷰에서 써 봤습니다.
| 스킬 | 하는 일(공식 설명 기준) |
|---|---|
| write-spec | 아이디어나 문제 설명으로 기능 명세·PRD 쓰기 |
| synthesize-research | 인터뷰·설문·문의를 주제별로 묶어 정리 |
| roadmap-update | 로드맵을 만들거나 우선순위를 다시 정하기 |
| stakeholder-update | 읽는 사람(경영진·개발팀 등)에 맞춘 진행 상황 보고 |
| competitive-brief | 경쟁사 비교 자료 만들기 |
| metrics-review | 제품 지표의 추세와 목표 대비 점검 |
| sprint-planning | 스프린트 범위와 인원 여유 계산 |
| product-brainstorming | 아이디어를 넓히고 가정을 따져 보는 대화 상대 |
2단계. 회의 메모로 PRD 받기 (약 1분)
이 단계에서는 메모와 자료 파일로 PRD를 받습니다. 자료를 넣은 폴더에서 터미널로 claude를 켜고 위 요청문을 붙여 넣습니다. 채점 기준 10개는 실행 전에 스킬 안내문의 PRD 구성과 조언에서 뽑아 정해 두었습니다.
이렇게 나오면 성공 폴더에 “PRD.md”가 생기고, 문제 정의에 해지 150건 중 54건이라는 근거 숫자가 들어 있습니다. 4번 모두 1분에서 1분 반 사이에 끝났습니다.
- 스킬 없이 쓸 때 완성 기준이 없으면: “필수 요구사항마다 어떻게 되면 완성인지 체크 목록으로 붙여 줘”라고 한 줄 더 요청해 볼 수 있습니다. 이번에는 이 요청을 해 보지 않았습니다.
- 영어 낱말이 거슬리면: “Given/When/Then과 영어 제목을 한국어로 바꿔 줘”라고 요청합니다.
- 날짜와 요일은 달력으로 다시 확인합니다. 스킬 없이 받은 1번째는 화요일인 2026년 12월 15일을 월요일이라고 적었습니다.
| 채점 항목 | 없이 1 | 없이 2 | 스킬 1 | 스킬 2 |
|---|---|---|---|---|
| 문제 정의에 근거 숫자(150건 중 54건) | O | O | O | O |
| 목표 3~5개, 잴 수 있는 결과 | O | O | X | O |
| 비목표에 메뉴·선물·포인트와 이유 | O | O | O | O |
| 사용자 스토리(역할 둘 이상, 예외 포함) | X | X | O | O |
| 요구사항을 세 단계 이상으로 구분 | X | X | O | O |
| 필수 요구사항마다 완성 기준 | X | X | O | O |
| 지표를 선행·후행으로 나누고 목표·시점 | X | X | O | O |
| 열린 질문에 담당과 차단 여부 | X | X | O | O |
| 일정: 12월 15일, 외부 의존, 단계 | O | O | O | O |
| 마감을 일요일 오전 9시 이전으로 | O | O | O | O |
| 합계 | 5 | 5 | 9 | 10 |
# 같은 요청문. 스킬 조건은 --plugin-dir·--add-dir과 맨 앞 /product-management:write-spec
claude -p "$(cat tools/request.txt)" --model claude-sonnet-5-5 --effort medium \
--setting-sources project,local --permission-mode acceptEdits [--plugin-dir skill/product-management --add-dir skill/product-management] \
--allowedTools "Bash(ls:*),Bash(python3:*),Read,Write,Edit,Skill,Glob,Grep" --disallowedTools "WebSearch,WebFetch" --output-format stream-json --verbose
조건 회차 불린 스킬 걸린 시간 사용량(API 단가) 턴 채점
스킬 없이 1 없음 61초 0.30달러 3 5/10
스킬 없이 2 없음 76초 0.33달러 3 5/10
스킬 1 /product-management:write-spec 86초 0.37달러 3 9/10
스킬 2 /product-management:write-spec 79초 0.36달러 3 10/10
이런 사람에게 권합니다
- ✅ PRD를 처음 써 보는 기획자·창업자. 여덟 칸이 빠짐없이 채워져 나와서 틀을 따로 찾지 않아도 됩니다.
- ✅ 개발자에게 문서를 넘겨야 하는 사람. 필수 요구사항마다 완성 기준이 붙어 있어 “다 됐다”의 뜻을 두고 다시 묻는 일이 줄어듭니다.
- ❌ 범위 정하기와 빠진 조건 찾기만 필요한 사람. 이 부분은 스킬 없이도 결과가 같았습니다.
한계와 주의할 점
- 조건마다 2번씩, 지어낸 서비스 자료로 해 본 결과입니다. 점수 차이가 스킬 때문인지 우연인지는 이 횟수로 가릴 수 없습니다.
- 채점 기준 10개를 스킬 안내문에서 뽑았기 때문에 스킬 쪽이 유리한 구조입니다. 벌어진 5개 항목은 모두 문서의 형식에 관한 것입니다.
- 목표 숫자(해지 절반, 수작업 주 4~5건 이하)와 연속 2주 한도는 클로드가 단 임시값입니다. 자료에 근거가 없으므로 사람이 정해야 합니다.
- 외부 연결 없이 폴더 속 파일만으로 했습니다. 안내문에는 프로젝트 관리 도구나 문서 도구가 연결돼 있으면 관련 티켓과 예전 명세를 찾아 온다고 적혀 있습니다. 이 부분은 써 보지 않았습니다.
대안
| 이름 | 다른 점 | 이럴 때 고르세요 |
|---|---|---|
| 클로드 코드에 요청만 | 설치 없음. 범위 정하기와 빠진 조건 찾기는 같게 나오지만 문서 꼴은 그때그때 다름 | 혼자 보고 판단할 초안이 필요할 때 |
| write-spec(이 글) | PRD 여덟 칸, 우선순위 세 단계, 항목별 완성 기준, 담당이 붙은 열린 질문 | 개발자·대표와 같이 볼 문서가 필요할 때 |
| doc-coauthoring 스킬 | 질문을 주고받으며 문서를 같이 써 나감 | 자료가 없고 머릿속 생각부터 꺼내야 할 때 |
| 스펙킷(Spec Kit) | 명세에서 계획·작업 목록·코드까지 이어 감 | PRD를 쓴 뒤 클로드 코드로 바로 개발할 때 |
자주 묻는 질문
PRD와 기획서는 다른가요?
기획서는 넓은 말입니다. 사업 기획서, 행사 기획서처럼 여러 문서를 가리킵니다. PRD는 그 가운데 제품이나 기능 하나의 요구사항을 적는 문서입니다. 화면 설계서(스토리보드)는 보통 PRD가 정한 범위를 화면으로 옮기는 다음 단계 문서입니다.
PRD 양식이 따로 있나요?
정해진 표준은 없습니다. 회사마다 칸이 조금씩 다릅니다. 이 글의 여덟 칸은 write-spec 스킬 안내문이 쓰는 구성입니다. 스킬 2번째 결과를 그대로 열어 틀로 삼아도 됩니다.
회의 메모 없이 한 줄 아이디어만 줘도 되나요?
안내문에는 기능 이름, 문제 설명, 사용자 요청, 막연한 아이디어 어느 것으로도 시작할 수 있다고 적혀 있습니다. 그 경우 클로드가 질문을 먼저 합니다. 이번에는 자료 파일을 준 경우만 해 봤습니다.
출처
anthropics/knowledge-work-plugins 저장소, Product Management 플러그인, write-spec SKILL.md (2026-11-12 확인)