Skip to main content
PromptQuorumPromptQuorum
Home/Prompt Engineering/SPECS 프레임워크
Frameworks

SPECS 프레임워크

·8 min read·By Hans Kuepper · Founder of PromptQuorum, multi-model AI dispatch tool · PromptQuorum

SPECS 프레임워크는 모호한 요청을 정밀한 명세로 전환하여 대형 언어 모델이 예측 가능하고 파싱 가능한 출력을 생성하도록 하는 프롬프트 구조입니다. PromptQuorum에서 SPECS 프레임워크는 사용자가 앱에서 직접 선택하고 적용할 수 있는 기본 제공 옵션으로 제공됩니다.

SPECS 프레임워크는 모든 프롬프트를 간단한 채팅 메시지가 아닌 요구사항 문서처럼 작성하는 명세 우선 프롬프트 패턴입니다. Scope, Purpose, Examples, Constraints, Steps의 다섯 가지 구성 요소로 이루어져 있으며, 정확성과 반복성이 중요한 운영 워크플로에 특히 적합합니다.

SPECS 프레임워크

SPECS 프레임워크란 무엇인가

SPECS 프레임워크는 모든 프롬프트를 일상적인 채팅 메시지가 아닌 소형 요구사항 문서처럼 취급하는 명세 우선 프롬프트 패턴입니다. 개방형 창의성보다 정확성, 구조, 반복성이 더 중요한 작업을 위해 설계되었습니다. SPECS는 GPT-5.5, Claude Opus 4.8, Gemini 3.1 Pro, 그리고 로컬 모델과 같은 모델과 잘 작동하는데, 지시사항에서 모호성을 제거하기 때문입니다.

SPECS는 서로 다른 사람이나 시스템이 동일한 프롬프트를 실행하여 일관된 결과를 얻어야 할 때 특히 유용합니다. 프롬프트를 명확한 명세로 전환함으로써 문제를 디버깅하고, 모델 동작을 비교하며, 워크플로 전반에 걸쳐 표준을 적용하기가 더 쉬워집니다.

SPECS의 다섯 가지 구성 요소

강력한 SPECS 프롬프트는 다섯 가지 구성 요소를 모두 정의하여 모델이 무엇을, 왜, 어떤 형식으로 답변해야 하는지 정확히 알 수 있도록 합니다. 각 구성 요소는 지시사항의 서로 다른 부분에 초점을 맞춥니다.

일반적인 정의는 다음과 같습니다:

  • Scope: 작업이 다루는 범위와 명시적으로 제외되는 내용.
  • Purpose: 출력물이 지원해야 하는 근본적인 목표 또는 의사결정.
  • Examples: 모델을 고정하기 위한 하나 이상의 샘플 입력 및 출력.
  • Constraints: 길이 제한, 형식, 또는 금지된 동작과 같은 엄격한 규칙.
  • Steps: 모델이 출력에 도달하기 위해 따라야 하는 내부 순서.

SPECS 프레임워크가 유용한 이유

SPECS 프레임워크는 단순히 읽기 쉬운 산문이 아닌 기계가 사용할 수 있는 결과물이 필요한 분석, 운영, 통합 작업에 유용합니다. 숨겨진 가정을 줄이고 프롬프트의 모든 부분을 명시적으로 만들어 프로덕션 워크플로에 필수적입니다.

주요 이점은 다음과 같습니다:

  • 명세의 개별 구성 요소를 조정하거나 테스트할 수 있어 디버깅이 더 쉬워집니다.
  • Constraints와 Examples 덕분에 모델과 실행에 걸쳐 더 안정적인 출력물을 얻을 수 있습니다.
  • 구조가 미리 알려져 있으므로 다운스트림 처리에 더 잘 맞습니다.

예시: 나쁜 프롬프트 vs 좋은 SPECS 프롬프트

비구조적 요청과 SPECS 기반 요청의 차이는 같은 작업을 두 가지 방식으로 작성해 보면 명확해집니다. 텍스트에서 정보를 추출하는 예시를 살펴보겠습니다.

나쁜 프롬프트

"이 고객 이메일을 읽고 주요 내용을 요약해 주세요."

좋은 프롬프트

"Scope: 단일 고객 지원 이메일을 분석하여 지원팀과 관련된 핵심 정보를 추출하십시오. 마케팅이나 영업 기회는 무시하십시오. Purpose: 티켓팅 시스템에 기록하고 상담원이 더 빠르게 응답하는 데 사용할 수 있는 구조화된 요약을 생성하십시오. Examples: 입력: '오늘 비밀번호를 두 번 재설정하려고 했는데 링크가 두 번 다 만료되었습니다…' 출력: {"issue_type": "password_reset", "urgency": "medium", "summary": "사용자가 재설정을 완료하기 전에 비밀번호 재설정 링크가 만료됨"} Constraints: 출력은 `issue_type`, `urgency`, `summary` 키를 가진 유효한 JSON이어야 합니다. 추가 필드를 더하지 마십시오. `urgency`는 low, medium, high 중 하나여야 합니다. Steps: 1) 주요 문제를 파악하고, 2) 영향과 불편함을 바탕으로 긴급도를 추론하며, 3) 25단어 이내의 간결한 요약을 작성하십시오."

SPECS 버전은 모델이 출력해야 하는 내용, 사고 방식, 결과가 어떻게 사용될지를 정확히 정의합니다.

SPECS 프레임워크를 사용해야 할 때

탐색적 브레인스토밍보다 구조화되고 신뢰할 수 있는 출력이 주요 목표일 때 SPECS 프레임워크를 사용해야 합니다. 주요 사례는 다음과 같습니다:

  • 이메일, 채팅, 또는 문서에서 고정된 스키마로의 데이터 추출.
  • 엄격한 규칙이 있는 코드 변환, 문서 생성, 리팩토링.
  • 섹션 제목, 지표, 형식이 미리 정해진 보고서 생성.
  • AI 출력물이 다른 시스템이나 스크립트에 직접 입력되는 모든 워크플로.

PromptQuorum이 SPECS 프레임워크를 구현하는 방법

PromptQuorum은 사용자가 처음부터 직접 만들지 않고도 명세 스타일의 프롬프트를 설계할 수 있도록 SPECS 프레임워크를 기본 제공 프롬프트 구조 중 하나로 제공하는 멀티모델 AI 디스패치 도구입니다. PromptQuorum에서 SPECS를 선택하면 앱이 Scope, Purpose, Examples, Constraints, Steps에 대한 전용 필드를 표시하고 이를 하나의 잘 구조화된 지시사항으로 조합합니다.

PromptQuorum 내에서 SPECS 프레임워크를 사용하면:

  • 각 구성 요소를 별도의 필드에 입력하여 명세를 읽기 쉽고 편집하기 쉬운 상태로 유지할 수 있습니다.
  • 동일한 SPECS 기반 프롬프트를 여러 모델에 병렬로 적용하여 서로 다른 공급업체가 엄격한 형식을 어떻게 처리하는지 쉽게 비교할 수 있습니다.
  • 티켓 요약, 보고서 생성, 코드 리뷰 등 반복적인 워크플로를 위한 SPECS 템플릿을 저장하고 공유할 수 있습니다.

다른 프레임워크와 SPECS 함께 사용하기

SPECS 프레임워크는 구조화된 출력의 근간으로 활용하고, 보완적인 작업을 위해 다른 프레임워크와 결합해야 합니다. 실용적인 패턴은 다음과 같습니다:

  • 예측 가능한 구조를 생성하거나 도구에 입력되어야 하는 모든 작업에는 SPECS를 사용하십시오.
  • 마케팅 및 카피라이팅에는 CRAFT와 같은 창의적 프레임워크를 사용하십시오.
  • 가시적인 중간 추론을 원할 때는 Analyze–Plan–Execute (APE)와 같은 추론 지향 프레임워크를 사용하십시오.
  • 전체 명세를 작성할 필요가 없는 빠른 작업에는 단일 단계의 일반 프레임워크를 사용하십시오.

SPECS 프레임워크 사용 방법

  1. 1
    Setting: 환경, 시스템, 또는 도메인에 대한 맥락을 제공하십시오. 예시: '당신은 의료 회사의 데이터 분석가입니다. 환자 개인 정보 보호가 매우 중요합니다. 모든 쿼리는 HIPAA를 준수해야 합니다.'
  2. 2
    Problem statement: 해결하고자 하는 구체적인 문제를 명시하십시오. 예시: '지난 90일 동안 약물 복용 순응도가 낮은 환자 코호트를 파악하십시오.'
  3. 3
    Examples: 좋은 출력의 구체적인 예시를 2–3개 제공하십시오. 분석의 경우 샘플 출력 테이블이나 결과를 보여주십시오. 코드 생성의 경우 스타일에 맞는 작동하는 코드를 보여주십시오.
  4. 4
    Constraints: 엄격한 규칙과 선호사항을 나열하십시오. 예시: 'SQL만 사용하십시오 (Python 불가). 쿼리는 5초 이내에 실행되어야 합니다. 출력물은 익명화되어야 합니다 (환자 이름 불가).'
  5. 5
    Style: 어조, 언어, 형식 선호사항을 지정하십시오. 예시: '기술적인 독자 대상. 정확한 용어를 사용하십시오. 마크다운 보고서로 반환하십시오.'

Apply these techniques with a local LLM or your own API keys — PromptQuorum works with any backend.

Try PromptQuorum free →

← Back to Prompt Engineering