modu-ai ai-prompting-basics — 비개발자용 Claude 대화 가이드
cowork 플러그인 스킬 —
skills/카테고리만 사용 (commands/·agents/ 없음).
핵심 6원칙 (Claude 공식)
- 명확하고 직접적으로 — Claude를 '맥락 없는 똑똑한 새 동료'로 대해. 원하는 출력 형식·제약을 직접 명시. "도움말 만들어줘" (X) → "초보용 5단계 설치 도움말, 단계당 2문장, 이모지 1개" (O).
- 맥락·동기 추가 — 왜 중요한지 설명하면 Claude가 올바르게 일반화. "소리 내어 읽을 거니 줄임표 금지" > "줄임표 금지".
- 예시로 보여주기 (multishot) — 3–5개 잘 만든 예시가 형식·톤·구조를 가장 안정적으로 유도.
<example>태그로 감싸. 긍정 예시가 부정 지시보다 강하다. - XML 태그로 구조화 — 혼합 프롬프트는
<instructions>,<context>,<input>,<output_format>태그로 나누면 Claude가 헷갈리지 않음. - 역할 부여 — 시스템 프롬프트에 한 문장 역할("너는 10년 차 카피라이터야")로 톤·행동 집중.
- 긴 자료는 상단에 — 20k+ 토큰 입력은 데이터를 상단에, 질문·지시는 하단에 배치 (품질 ~30% 향상).
비개발자 실전 치트키
| 이런 요청은 | 이렇게 바꾸세요 |
|---|---|
| "글 써줘" | "50대 주부 대상 건강보험 블로그 글, 3문단, 핵심 혜택 1개" |
| "잘 만들어줘" (모호) | 원하는 형식의 예시 1개를 직접 보여주기 |
| "~하지 마" (부정) | "~하게 써" (긍정) — 부정 지시는 잘 안 지켜짐 |
| "더 좋게" (평가어) | 구체 기준("초등 5학년이 이해 가능하게, 문장당 25자 이내") |
자주 묻는 질문
Q: Claude가 너무 길게 써요 → 출력 형식 명시: "3문단, 문장당 25자 이내" 또는 "한 슬라이드당 핵심 1줄".
Q: 내 뉘앙스가 안 살아요 → 역할 + 예시 2–3개 제공. "이런 톤으로: [예시1] [예시2]".
Q: 거짓말(할루시네이션)해요 → "모르면 모른다고 해. 추측하지 마" + 확인 가능한 출처 요청.
참고
- Claude 공식 프롬프트 엔지니어링 가이드: https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices
- 본 스킬은
/harness:plugin하네스(skill-builder)가 Claude 공식 문서 기반으로 생성한 cowork 플러그인 스킬입니다.