claudianus/토스-ux-라이팅-스킬

Toss UX Writing

이 스킬은 토스 스타일에서 영감을 받은 방식으로 한국어 제품 마이크로카피를 생성, 재작성 또는 검토할 때 사용합니다. 목표는 토스를 사칭하거나 원본 예제를 복사하는 것이 아니라 재사용 가능한 패턴(친근한 해요체, 능동 동사, 긍정 우선 프레이밍, 캐주얼한 존중, 명확한 예외 처리)을 적용하는 데 있습니다.

핵심 규약

한국어 UX 카피를 개선할 때:

1. 모든 곳에서 해요체를 사용하세요. 합니다/됩니다/하십시오와 같은 격식체와 반말을 피하세요.
2. 능동적인 표현을 선호하세요. 사용자, 제품 또는 객체가 동작을 수행하도록 하고 되다/됐어요/되어요에 의존하지 마세요.
3. 긍정적인 내용을 먼저 배치하세요. 차단된 내용을 말하기 전에 사용자가 무엇을 할 수 있고 어떤 조건에서 가능한지 먼저 말하세요.
4. 격식을 낮춘 존댓말을 유지하세요. 지나치게 격식 있는 ~시겠어요, 시나요, 셨나요, 께, 계시다, 여쭙다는 예외가 아닌 이상 사용하지 마세요.
5. 명사형 표현을 피하세요. 딱딱한 {명사}+{명사} 구조와 한자어 명사를 동사, 원인, 구체적인 행동으로 대체하세요.
6. 예외를 존중하세요. 법률/정책적 명확성, 사용자 안심, 서비스 종료/만료, 결과 설명을 위해 수동태나 부정문이 필요한 경우 긍정 표현이나 능동태를 강제로 적용하지 마세요.

워크플로

1. 표면 유형 분류

카피가 나타나는 위치를 식별하세요:

• 버튼 또는 CTA
• 다이얼로그 / 확인
• 토스트 / 스낵바
• 오류 / 복구 메시지
• 빈 상태
• 폼 라벨, 도움말 텍스트, 유효성 검사
• 혜택 자격 또는 보상 안내
• 정책/법적 제한
• 알림/푸시
• 개인정보, 동의, 녹음, 데이터 사용

표면별 기본값은 references/surface-patterns.md를 참조하세요.

2. 5가지 주요 변환으로 재작성

다음 순서로 변환을 적용하세요:

1. 격식: 해요체로 변환합니다.
2. 주체성: 수동태/상태 표현을 능동 표현으로 변환합니다.
3. 가치: 피할 수 있는 부정문을 가능 조건으로 변환합니다.
4. 거리감: 존댓말의 격을 낮추되 존중은 유지합니다.
5. 동사화: 명사 더미를 동사 또는 원인절로 변환합니다.

대체 패턴은 references/vocabulary.md를 참조하세요.

3. 예외 게이트 확인

최종 결정 전에 다음을 확인하세요:

• 이것이 엄격한 법률/정책/제품 제한사항인가요? 그렇다면 부정적인 표현이 더 명확할 수 있습니다.
• 서비스 종료, 기간 만료, 연체, 해지, 적용, 기록, 녹음, 또는 정보 수집에 관한 내용인가요? 그렇다면 수동태가 더 명확할 수 있습니다.
• 질문이 사용자의 실제 맥락, 추론된 상황을 사용하거나 호의/의견을 묻는 것인가요? 그렇다면 시나요/셨나요가 허용될 수 있습니다.
• 긍정적인 표현이 사용자로 하여금 전체 서비스를 사용할 수 없다고 오해하게 할 수 있나요? 그렇다면 영향을 받는 혜택/기능을 구체적으로 명시하세요.

references/decision-tree.md를 참조하세요.

4. 감사 가능한 결과 반환

재작성의 경우 다음 표를 반환하세요:

원문	개선안	적용 규칙	예외 여부

생성 작업의 경우 표면별로 그룹화하세요:

1. 기본 카피
2. 보조/도움말 카피
3. CTA 라벨
4. 해당되는 경우 오류/빈 상태/복구 카피
5. 위험, 예외 또는 누락된 컨텍스트에 대한 참고 사항

감사의 경우 다음을 반환하세요:

1. 종합 평결: 좋음, 수정 필요 또는 위험
2. 심각도별 발견 사항
3. 제안된 재작성
4. 규칙 참조

엄격한 규칙

• 되어요를 출력하지 마세요. 수동태가 의도적으로 허용된 경우 돼요를 사용하세요.
• 다이얼로그에서는 사용자가 시작한 작업을 실제로 취소하는 경우가 아니라면 왼쪽 버튼 닫기를 취소보다 선호하세요.
• 동작 이름을 지정할 수 있는 경우 확인, 진행, 제출과 같은 일반적인 CTA를 피하세요.
• 사용자를 비난하지 마세요. 시스템/제품 제약 사항과 다음 단계를 선호하세요.
• 법률/정책 제한을 밝은 표현 뒤에 숨기지 마세요.
• 생성된 카피가 "공식 토스 카피"라고 주장하지 마세요.
• 전체 토스 가이드를 재배포하거나 인용하지 마세요. 패턴을 요약하고 필요할 때 출처를 인용하세요.

빠른 패턴

카드를 해지하시겠어요?      → 카드를 해지할까요?
알림이 설정됐어요          → 알림을 설정했어요
보호자가 허락하기 전에는 가입할 수 없어요 → 보호자가 허락하면 가입할 수 있어요
잔액 부족으로 결제 실패    → 잔액이 부족해서 결제하지 못했어요
자동차를 가지고 계시나요?  → 자동차가 있나요?

사용 시기

• 한국어 앱/웹 제품 카피에 토스 스타일의 톤이 필요할 때
• 오류, 다이얼로그, 버튼, 혜택, 온보딩, 폼, 알림 또는 정책 안내를 위한 UX 라이팅이 딱딱하게 느껴질 때
• PR에 한국어 UI 문자열이 추가되어 스타일 리뷰가 필요할 때
• 친근한 해요체로 여러 변형이 필요할 때
• 한국어 문구가 너무 격식적이거나, 수동적이거나, 부정적이거나, 명사 위주인 이유를 설명해야 할 때

사용하지 말아야 할 때

• 법적 용어를 그대로 재현해야 할 때
• 브랜드 목소리가 의도적으로 격식체 합니다체를 사용할 때
• 대상 사용자가 기관 또는 정부 스타일의 존댓말을 요구할 때
• 카피가 한국어가 아닐 때
• 토스의 독점 UI를 복제하거나 공식 예제 전체를 복사하라는 요청을 받았을 때

참조

• references/tone-model.md — 음성 모델에 대한 심층 분석
• references/decision-tree.md — 예외 우선 결정 게이트
• references/vocabulary.md — 대체 패턴 및 안티 패턴
• references/surface-patterns.md — UI 표면별 카피 레시피
• references/examples.md — 합성 전/후 예제
• references/review-rubric.md — 감사용 평가 루브릭
• scripts/toss_style_lint.py — 로컬 휴리스틱 린터