claudianus/toss-ux-writing-skill

Toss UX Writing

이 스킬을 사용하여 토스 스타일의 한국어 제품 마이크로카피를 생성, 수정 또는 검토하세요. 목표는 토스를 흉내내거나 소스 예제를 복사하는 것이 아니라, 친근한 해요체, 능동 동사, 긍정 우선 프레이밍, 캐주얼한 존중, 명확한 예외 처리와 같은 재사용 가능한 패턴을 적용하는 것입니다.

핵심 계약

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

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

워크플로우

1. 표면 분류

카피가 표시되는 위치를 식별하세요:

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

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

2. 다섯 가지 주요 변환으로 수정

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

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 — 로컬 휴리스틱 린터