ko-prompt-kit

한국어 LLM 프롬프트 키트 — Claude, GPT-4 등 AI를 한국어로 사용할 때 즉시 쓸 수 있는 프로덕션 품질의 프롬프트 컬렉션.

npx ko-prompt list
npx ko-prompt get coding/code-review

왜 ko-prompt-kit인가?

영어 프롬프트를 번역해서 쓰면 어색한 한국어 결과물이 나옵니다. ko-prompt-kit은 처음부터 한국어로 설계된 프롬프트를 제공합니다:

• 존댓말/비격식체 구분 (격식체 / 비격식체)
• 한국 비즈니스 관행과 문서 형식 반영
• 한국어 특유의 표현과 맥락 고려

프롬프트 목록 (14개)

| 카테고리 | ID | 설명 | |---|---|---| | 비즈니스 | business/email-reply | 비즈니스 이메일 답변 | | | business/meeting-minutes | 회의록 작성 | | | business/report-summary | 보고서 핵심 요약 | | 코딩 | coding/code-review | 한국어 코드 리뷰 | | | coding/commit-message | Git 커밋 메시지 | | | coding/bug-analysis | 버그 원인 분석 | | | coding/documentation | 한국어 JSDoc 생성 | | 고객서비스 | customer-service/complaint-reply | 고객 불만 응대 | | | customer-service/faq-answer | FAQ 답변 생성 | | 글쓰기 | writing/blog-post | SEO 블로그 포스팅 | | | writing/marketing-copy | 마케팅 카피 작성 | | 분석 | analysis/document-summary | 문서 3단계 요약 | | | analysis/sentiment-analysis | 감성 분석 | | | analysis/competitive-analysis | 경쟁사 분석 |

설치

npm install ko-prompt-kit

또는 설치 없이 CLI로 바로 사용:

npx ko-prompt-kit <command>

CLI 사용법

# 전체 목록
npx ko-prompt list

# 카테고리별 필터
npx ko-prompt list --category coding

# 검색
npx ko-prompt list --query 이메일

# 프롬프트 상세 (시스템 프롬프트 + 템플릿 확인)
npx ko-prompt get coding/code-review

# 변수를 채워 완성된 프롬프트 출력
npx ko-prompt build coding/code-review \
  --var language=typescript \
  --var code="function add(a, b) { return a + b }" \
  --var focus="타입 안전성"

# 카테고리 목록
npx ko-prompt categories

TypeScript API

import { getById, getByCategory, search, buildPrompt } from 'ko-prompt-kit';

// ID로 가져오기
const prompt = getById('coding/code-review');

// 변수 채워서 완성된 프롬프트 생성
const built = buildPrompt(prompt, {
  language: 'typescript',
  code: 'async function fetchUser(id) { ... }',
  focus: '보안',
});

console.log(built.system); // AI에 전달할 시스템 프롬프트
console.log(built.user);   // 사용자 메시지

// 검색
const codingPrompts = search({ category: 'coding' });
const formalPrompts = search({ speechLevel: 'formal' });
const emailRelated = search({ query: '이메일' });

Claude API와 함께 사용

import Anthropic from '@anthropic-ai/sdk';
import { getById, buildPrompt } from 'ko-prompt-kit';

const client = new Anthropic();
const prompt = getById('coding/code-review')!;
const built = buildPrompt(prompt, {
  language: 'python',
  code: yourCode,
  focus: '성능',
});

const message = await client.messages.create({
  model: 'claude-opus-4-7',
  max_tokens: 2048,
  system: built.system,
  messages: [{ role: 'user', content: built.user }],
});

OpenAI API와 함께 사용

import OpenAI from 'openai';
import { getById, buildPrompt } from 'ko-prompt-kit';

const openai = new OpenAI();
const prompt = getById('business/email-reply')!;
const built = buildPrompt(prompt, {
  receivedEmail: '다음 주 미팅 일정 확인 부탁드립니다.',
  replyPoint: '화요일 오후 2시 가능',
  additionalRequests: '간결하게',
});

const completion = await openai.chat.completions.create({
  model: 'gpt-4o',
  messages: [
    { role: 'system', content: built.system },
    { role: 'user', content: built.user },
  ],
});

API 레퍼런스

getById(id: string): Prompt | undefined

ID로 프롬프트를 가져옵니다.

getByCategory(category: Category): Prompt[]

카테고리로 필터링합니다. 카테고리: business | coding | customer-service | writing | analysis

search(options: SearchOptions): Prompt[]

복합 조건으로 검색합니다.

interface SearchOptions {
  category?: Category;
  tags?: string[];
  speechLevel?: 'formal' | 'informal';
  query?: string; // 이름, 설명, 태그에서 검색
}

buildPrompt(prompt: Prompt, variables: Record<string, string>): BuiltPrompt

템플릿 변수를 채워 완성된 프롬프트를 반환합니다. 필수 변수 누락 시 에러를 던집니다.

allPrompts: Prompt[]

전체 프롬프트 배열.

기여

새 프롬프트 PR 환영합니다. 다음 기준을 충족해야 합니다:

• 실제로 테스트된 프롬프트 (예시 입출력 필수)
• example.input → example.expectedOutput 포함
• 기존 카테고리에 맞게 분류, 또는 새 카테고리 제안

git clone https://github.com/k08200/ko-prompt-kit
npm install
npm test

라이선스

MIT