ux-writing

ux-writing skill

목적

화면 문구가 이미 있고 더 낫게 다듬어야 할 때 쓰는 재작성 조력 skill이다. 판정(카피가 기준에 맞는가)은 design skill의 quality bar G6(카피)·G8 (다크패턴)이 하고, 이 skill은 어떻게 고칠 것인가를 담는다 — 같은 규칙을 두 곳에서 다시 정의하지 않고, 여기서는 재작성 원칙·절차·before/after 예시만 다룬다.

산출은 항상 제안이다. 코드나 문구 파일을 실제로 고치기 전에 사용자 확인을 받는다 — 확인 없이 문자열을 일괄 치환하지 않는다.

언제 쓰나

• 화면에 이미 문구가 있고, 더 나은 카피로 다듬고 싶을 때.
• design skill의 품질 판정에서 G6(카피)에 "조정 필요"가 나와서 실제로 손을 대야 할 때.

/ait:ux-writing [화면 또는 파일]
                          # 말로: "이 화면 문구를 UX 라이팅 기준으로 다듬어줘"

대상을 지정하지 않고 불러도 된다 — 1단계에서 현재 프로젝트의 화면 문구를 먼저 훑어 대상 목록을 함께 확인한다.

문구 원칙

아래 축으로 문구를 점검하고 고친다. 괄호 안 표기는 design skill의 references/quality-bar.md에 있는 대응 판정 항목이다 — 이 skill은 그 기준을 참조할 뿐 다시 정의하지 않는다.

• 사용자가 하는 일을 주어로 쓴다 — "시스템이 처리 중입니다" 같은 수동 문장 대신 사용자가 지금 무엇을 기다리는지, 무엇을 하는지로 쓴다. (판정 항목 아님 — 재작성 관점. quality-bar에 대응 항목이 없다.)
• 얻는 것으로 말한다 — 손실·불안을 자극하는 프레이밍("놓치면 손해")을 쓰지 않는다(G6-6).
• 확인 가능한 사실로 쓴다 — 사용자의 감정을 대신 단정하지 않는다 (G6-7).
• 문장을 나눈다 — 한 문장에 조건·수치를 몰아넣지 않는다(G6-8).
• 반복하지 않는다 — 같은 주장을 제목·부제·본문에서 표현만 바꿔 되풀이하지 않는다(G6-9).
• 원인과 다음 행동을 함께 말한다 — 에러 문구는 "오류가 발생했습니다"로 끝내지 않는다(G6-2).
• 버튼은 결과를 말한다 — "확인"·"완료" 같은 모호한 라벨 대신 눌렀을 때 일어나는 일을 라벨에 담는다. (판정 항목 아님 — 재작성 관점. quality-bar에 대응 항목이 없다.)
• 어투를 일관되게 유지한다 — 존댓말 수준·숫자 단위 표기를 화면 전반에서 통일한다(G6-1).
• 언어를 섞지 않는다 — 한 화면 안에서 한국어와 다른 언어를 섞어 쓰지 않는다(G6-4).
• 사용자를 몰아붙이지 않는다 — 선택을 왜곡하거나 재촉하는 문구를 쓰지 않는다. 패턴 차원(가짜 버튼·닫기 함정 등)의 판정은 G8이 한다 — 여기서는 문구 표현 차원만 본다.

작업 절차

1. 전수 수집 — 대상 화면의 코드·시안에서 사용자 문구를 훑어 화면별 표로 정리한다: 화면 | 위치(파일·컴포넌트) | 원문.
2. 축별 점검 — 위 "문구 원칙"의 각 축을 원문에 대조해 위반을 짚는다. 위반이 없으면 그 축은 통과로 표시한다.
3. before/after 제안 — 위반이 있는 문구마다 대안 문구를 만들고, 무엇이 바뀌었는지 한 줄로 붙인다.
4. 사용자 확인 후 적용 — 제안을 표로 보여주고, 사용자가 승인한 항목만 실제 코드·문구 파일에 반영한다. 승인 없이 진행하지 않는다.
5. design G6 재판정으로 hand-off — 반영이 끝나면 design skill로 넘겨 G6를 다시 채점한다(아래 "design과의 관계").

before/after 예시

아래는 이 skill이 새로 쓴 예시다(실제 제품 문구를 그대로 옮긴 것이 아니다). 실제 대상 화면에서는 3단계 절차로 표를 만들어 제안한다.