agentleFS
develeepdeveleep/dev-gongbang/skills/productivity/prompt-builder/SKILL.md

prompt-builder

Skill1 starsChanged 19 days agoMITView on GitHub

Claude·OpenAI 공식 best practice와 모델별 가이드(Claude, GPT)에 맞춰 시스템·에이전트 프롬프트, CLAUDE.md, SKILL.md를 인터뷰로 설계하거나 기존 초안을 고치고 리뷰한다.

9 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Prompt Builder

사용자와 인터뷰해 받은 값과 승인받은 제안으로 프롬프트를 조립한다. 구조와 문구 패턴은 공식 best practice를 따르고, 대상 모델에 맞춘 조정을 더한다.

핵심 규칙

  1. 내용은 사용자에게 받은 값과 사용자가 승인한 제안으로만 채운다. 역할, 목표, 도메인 지식, 규칙, 판단 기준, 예시, 출력 형식, 톤을 조용히 추측해 넣지 않는다. 답을 받지 못한 항목은 질문하고, 사용자가 "생략"을 고르면 뺀다.
  2. 품질을 좌우하는 빈 곳은 초안을 제안해 승인받는다. 받은 값만으로는 실행하는 모델이 기준 없이 판단해야 하는 곳(무엇을 보고하고 뺄지, 분류 경계와 확신도 기준, 모를 때의 행동)이 있으면 Claude의 전문성으로 초안을 써서 보여 주고 승인·수정·제외를 받는다. 조직이나 제품 고유의 사실(메뉴 경로, 정책, 가격, 연락처)은 제안하지 않고 질문한다. 절차는 reference/interview.md의 "보완 제안"을 따른다.
  3. 모호하거나 결정이 필요한 것은 질문한다. 해석에 따라 결과물이 달라지면 결정 사항이다. 답이 모호하면("간결하게", "알아서") 되묻는다. 빠른 모드의 기본값 표는 사용자가 보고 승인하는 절차이므로 조용히 고르는 것이 아니다. 기본값은 형식 항목에만 두고, 내용 항목(역할, 배경, 규칙, 예시)에는 두지 않는다.
  4. 스킬이 직접 넣는 것은 형식이다. 형식이란 XML 태그 구조(GPT 대상은 모델 가이드의 조립 골격), 배치 순서, best practice 문구 패턴을 말한다. 내용은 보완 제안으로만 보탠다. 모델 가이드의 스니펫과 공통 원칙 G·H 항목은 연결된 질문에 사용자가 해당된다고 답했을 때만 넣는다.
  5. 완성 프롬프트는 B2(프롬프트 언어) 답의 언어로 쓴다. 태그 이름, 코드, API 식별자는 영문 그대로 둔다. 인터뷰와 설명은 사용자의 언어로 한다.
  6. 결과물은 기본적으로 채팅의 코드블록으로 전달한다. SKILL.md에 번들 파일이 있거나 사용자가 저장을 요청하면, 경로를 확인받은 뒤에만 파일로 저장한다. 형식은 reference/output-format.md를 따른다.

주의할 점

  • 받은 값을 문장으로 풀 때 도메인 지식이 섞이기 쉽다. 예: 계약서 비교 프롬프트에 "조항이 없는 것도 위험으로 본다" 같은 판단 기준이나 "지체상금, 손해배상액의 예정" 같은 조항 동의어 목록을 넣는 것. 승인받지 않은 내용이므로 조용히 넣지 않는다. 필요해 보이면 보완 제안으로 보여 주고 승인받는다.
  • 선택지를 보여 주는 질문 도구와 답이 필요한 텍스트(서술형 질문, 승인받을 표·제안)를 한 메시지에 함께 내지 않는다. 텍스트를 먼저 보내 답을 받은 뒤 선택지를 묻는다.

워크플로

아래 체크리스트를 첫 응답에 한 번 보여 주고, 이후에는 단계가 바뀔 때만 갱신한다.

진행 상황:
- [ ] 1. 세션 모델 감지
- [ ] 2. 기본 설정 (종류, 대상 모델, 언어, 진행 방식)
- [ ] 3. 모델 가이드 로드 및 확인일 점검
- [ ] 4. 초안 분석 (있을 때)
- [ ] 5. 구성 요소 인터뷰
- [ ] 6. 보완 제안과 모델 특화 결정 질문
- [ ] 7. 조립
- [ ] 8. 자체 검수
- [ ] 9. 출력

1. 세션 모델 감지

시스템 프롬프트나 환경 정보에 적힌 자신의 모델 ID(예: "The exact model ID is claude-opus-5-5", OMP 등에서 GPT로 돌면 gpt-6-astra 같은 값)를 확인한다. Claude든 GPT든 이 값이 2단계 대상 모델 질문의 첫 선택지가 된다. 첫 응답에 한 줄로 알린다. 예: 감지된 세션 모델: gpt-6-astra. 모델 ID를 찾지 못하면 세션 모델: 확인 불가라고 알리고, B1을 세션 모델 선택지 없이 묻는다.

2. 기본 설정

reference/interview.md의 "0라운드"를 진행한다. 종류, B1 대상 모델, B2 프롬프트 언어, B3 진행 방식을 한 라운드에 묻는다.

종류는 다음 넷이다.

  • API 시스템 프롬프트: 챗봇이나 서비스에 들어가는 system 프롬프트
  • 에이전트/하네스 프롬프트: 도구를 쓰는 에이전트나 장시간 자율 실행용 프롬프트
  • 단발 작업 프롬프트: 분석, 문서 작성 같은 1회성 user 메시지
  • CLAUDE.md / SKILL.md 본문: 이 종류는 reference/skill-authoring.md도 함께 읽는다. B1 대신 K7(사용 모델, 다중 선택)을 묻는다.

3. 모델 가이드 로드

B1(또는 K7)에서 고른 대상 모델로 아래 표를 위에서부터 맞춰 보고, 처음 일치하는 줄을 쓴다. [1m]이나 날짜 같은 접미사는 무시한다.

모델 ID 패턴로드할 가이드
claude-opus-5-5*reference/models/opus-5-5.md
claude-opus-5*reference/models/opus-5.md
claude-sonnet-5-5*reference/models/sonnet-5-5.md
claude-sonnet-5*reference/models/sonnet-5.md
claude-fable-5-2*, claude-mythos-5-2*reference/models/fable-5-2.md
claude-fable-5-1*, claude-mythos-5-1*reference/models/fable-5-1.md
claude-haiku-5-5*reference/models/haiku-5-5.md
claude-haiku-4-5*reference/models/haiku-4-5.md
gpt-6-astra*reference/models/gpt-6-astra.md
gpt-6.1-sol*reference/models/gpt-6-1-sol.md (Astra 가이드도 함께 읽는다)
그 외 또는 확인 불가모델 가이드 없이 공통 원칙만 적용

결과를 한 줄로 알린다. 예: 대상 모델: claude-sonnet-5-5 → Sonnet 5.5 가이드 적용. 표에 없는 모델이면 "모델 특화 없이 공통 best practice만 적용합니다"라고 알린다. 공통 원칙 D·F의 prefill과 사고 설정 내용은 Claude 모델 세대에 따라 다르므로, 해당 모델에서 맞는지 확인할 수 없으면 실행 설정 권고에서 그 부분을 빼고 그렇다고 알린다. 표에 없는 GPT 모델(gpt-*)이면 Claude 전용 항목(원칙 D의 prefill, 원칙 F의 사고 설정)을 적용하지 않고, 실행 설정 권고는 모델 ID만 적는다.

확인일 점검: 가이드 맨 위의 확인일이 오늘보다 90일 이상 이전이고 웹 페이지를 가져와 읽을 수 있으면, 출처 문서를 가져와 가이드의 "특성 요약", "실행 설정 권고"를 대조한다. 대조할 항목은 기본 effort, 사고 설정(GPT는 지원하는 reasoning effort 값), 베타 헤더, 400 오류 조건이다. 다르면 출처를 따르고 차이를 사용자에게 한 줄로 알린다. 대조하지 못했으면 설계 요약에 가이드 확인일을 적는다.

4. 초안 분석

요청에 프롬프트 초안(본문 붙여넣기, 파일 경로, 첨부)이 있으면:

  1. 초안을 끝까지 읽고 reference/interview.md의 구성 요소 카탈로그에 대응시킨다.
  2. 항목 | 초안에서 추출한 값 | 상태(확인됨/모호/없음) 표를 보여 주고 추출 결과가 맞는지 확인받는다. 상세 인터뷰에서는 표만 보내 확인받은 뒤 질문한다. 빠른 모드에서는 표와 첫 서술형 질문을 한 메시지에 보내고, 표 수정도 그 답에서 받는다.
  3. 이후 인터뷰에서는 모호와 없음 항목만 질문한다.
  4. 모델 가이드의 "제거 검토" 목록에 해당하는 문구가 초안에 있으면 목록으로 보여 주고, 하나씩 제거할지 묻는다.

초안이 없으면 5단계로 넘어간다.

5. 구성 요소 인터뷰

reference/interview.md에서 종류별 라운드 순서와 B3 진행 방식(빠른 모드 / 상세 인터뷰)에 맞는 절차를 확인하고 그대로 진행한다.

  • 선택형 항목: 선택지를 보여 주는 질문 도구가 있으면 그것으로 묻는다. 도구로 한 번에 묻는 선택형은 4문항까지, 문항마다 선택지는 2~4개로 둔다. 많으면 사용자가 비교하기 어렵고 도구가 받지 못하기도 한다. 한 메시지에 물을 선택형이 4개를 넘으면(빠른 모드에서 라운드를 합친 경우 등) 모두 번호 텍스트 질문으로 묻고 선택지를 (a)(b)(c)로 표기한다. 선택지는 형식의 후보이지 내용을 지어낸 것이 아니어야 한다. best practice가 뒷받침하는 선택지만 맨 앞에 두고 "(권장)"을 붙인다.
  • 서술형 항목(배경, 도메인 규칙, 예시, 역할 상세 등): 번호를 붙인 텍스트 질문으로 한 메시지에 모아서 묻고 답을 기다린다.
  • 선택지를 보여 주는 질문 도구가 없는 환경에서는 모든 질문을 번호 목록 텍스트로 묻는다. 선택형 항목은 선택지를 (a)(b)(c)로 표기한다.
  • 라운드마다 받은 답을 짧게 되짚어 보고 다음 라운드로 넘어간다.

6. 보완 제안과 모델 특화 결정 질문

reference/interview.md의 "보완 제안"에 따라 품질을 좌우하는 빈 곳에 초안을 제안한다. 제안의 답을 받은 뒤 로드한 모델 가이드의 "결정 질문" 중 조건이 현재 답에 맞는 것만 묻는다. 답에 따라 "프롬프트 반영" 스니펫과 "실행 설정 권고"를 고른다. 빠른 모드에서도 조건이 맞는 결정 질문은 묻는다. 5개 이상이면 스니펫을 넣을지 정하는 질문 4개를 먼저 묻고, 나머지는 기본값 표에 "미적용"으로 올려 승인받는다.

7. 조립

reference/principles.md의 조립 골격과 원칙에 따라 받은 값을 배치한다. 모델 가이드의 스니펫은 의미를 유지한 채 받은 값과 문맥에 맞게 B2 언어로 쓴다. B2=영어이면 스니펫 아래의 원문을 바탕으로 쓴다. 모델 가이드 스니펫과 공통 원칙 G 항목이 같은 행동을 다루면 모델 가이드 쪽만 넣는다. 조립 중에 빈 곳이 드러나면 조용히 채우지 말고, 사실이면 질문하고 판단 기준이면 보완 제안으로 승인받는다.

8. 자체 검수

reference/principles.md의 공통 검수 목록과 모델 가이드의 검수 항목으로 점검한다. 필요한 정보가 없어서 통과하지 못한 항목은 질문으로 해결한다. 사용자가 "생략"을 골라 끝내 통과하지 못한 항목은 출력의 "다음 단계"에 경고로 남긴다.

9. 출력

reference/output-format.md의 응답 구조로 전달한다.

참조 파일

  • reference/principles.md: 모든 모델에 공통인 원칙, 조립 골격, 검수 목록
  • reference/interview.md: 기본 설정, 구성 요소 카탈로그, 종류별 라운드, 빠른 모드
  • framing-problems 스킬: C16=예일 때 완성 프롬프트가 실행 시 호출하는 구체화 절차
  • reference/output-format.md: 최종 응답 구조와 파일 저장 조건
  • reference/skill-authoring.md: CLAUDE.md와 SKILL.md 작성 규칙

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.