일곱 상황의 말
원본: projects/skill-lens/design/content.md
목소리는 변하지 않고, 톤은 상황마다 바뀝니다(Polaris 방식). 목소리는 README의 콘텐츠 원칙(해요체, 이름 + 님, 실무자·담당자·렌지)이고, 아래는 상황별 톤과 실제 문장입니다. 새 화면의 문장은 이 일곱 중 하나에 넣어 보고, 들어맞는 do를 따라 씁니다.
1. 일상 작업: 짧게, 비켜서기
라벨은 동사 또는 결과. 같은 행동은 같은 말.
- do: "다음 →", "직무확인", "초대"(버튼은 명사형 2~4자, 숫자 없이. 아래 "버튼 글")
- don't: "다음 단계로 이동하기", "확인하시겠습니까?", "클릭하여 계속"
2. 단순 오류: 무슨 일인지 + 어떻게 고치는지
놀라게 하지 않고, 고치는 법을 같은 문장에.
- do: "최대인원 1,500명을 넘었어요. 45명을 빼거나 계약을 늘려 주세요."
- do: "8자 이상, 영문과 숫자를 섞어 주세요."
- don't: "유효하지 않은 입력입니다", "오류 403", "치명적인 문제가 발생했습니다"
- 자리: 입력란 아래, 행 아래. 토스트로 알리지 않음.
3. 심각한 문제: 영향을 정직하게, 다음 행동을 구체적으로
- do: "초대 1,248건 중 23건이 보내지지 않았어요. 23명의 이메일을 확인한 뒤 다시 보낼 수 있어요." + [23명 보기]
- do (해결책이 없을 때): "지금은 명단을 읽을 수 없어요. 원인을 찾는 중이고, 복구되면 알려 드릴게요."
- don't: "걱정 마세요, 일시적인 문제예요", "불편을 드려 죄송합니다"(해결책 없이)
- 사과는 우리 잘못일 때만, 한 번, 다음 행동과 함께.
4. 완료: 확인만, "성공"이라 부르지 않기
- do (토스트): "스킬셋을 저장했어요", "명단을 올렸어요, 1,248명"
- don't: "성공적으로 저장되었습니다!", "완료! 🎉"
- 사용자에게 수고를 시켰다면 한마디: "직무 46개를 다 확인했어요. 고마워요."
5. 축하: 마침 화면 하나뿐
- do: "AI 전환 진단을 시작했어요" (보고형. 축하가 아니라 시작 선언. 보드 시안의 "지금 위치 재기를 시작했어요"는 번역투라 버림)
- don't: "축하합니다!", "우리가 해냈어요", 설정 단계마다 "잘했어요"
- 성과는 사용자의 것. "SkillLens가 ~해 드렸어요"라고 공을 가져가지 않음.
6. 빈 상태: 왜 비었는지 + 다음 행동 하나
- do: "아직 올린 명단이 없어요. 엑셀이나 CSV를 올리면 직무를 자동으로 연결해 드려요." + [명단 올리기]
- don't: "데이터가 없습니다", "여기는 비어 있어요 :("
- 오류로 빈 것은 2번·3번으로.
7. AI 제안(렌지): 찾았다고 말하고, 확정하지 않기
- do: "렌지가 공개 직무 사전에서 찾았어요" + [맞아요] [다른 표준]
- do: "비슷한 이름이 둘 있어요. 어느 쪽인가요?"
- don't: "AI가 자동으로 완료했습니다", "AI 추천 ✨", "99% 정확해요"
- 렌지는 1인칭을 쓰지 않음("제가 찾았어요" ✗). 항상 "렌지가 ~했어요".
공통
- 숫자는 문장의 주인공: 천 단위 쉼표, 단위 붙이기, 제목에 한 번만.
- 영어 문장·영어 슬로건은 제품 화면에 없음(영문은
eyebrow라벨뿐). - 요금·가격·업셀 문구는 온보딩에 없음.
- 느낌표는 입구 인사("어서 오세요!") 한 곳.
버튼 글 (2026-11-06, 호준 결정. 완성도 원칙 8과 같은 규칙)
버튼은 문장이 아니라 이름표입니다. 명사형 2~4자가 기본입니다. 저장, 삭제, 추가, 확인, 수정, 선택, 확정, 전송, 제외, 다운로드, 업로드.
- "~하기"는 쓰지 않습니다. 저장하기, 시작하기, 더하기, 고르기 모두 금지. 더하기는 추가, 고르기는 선택, 고치기는 수정, 빼기는 제외(목록에서만 빠질 때) 또는 삭제(데이터가 사라질 때).
- 목적어가 화면에 있으면 뺍니다. 실무자 목록의 "추가", 명단 화면의 "다운로드". 목적어가 필요하면 붙여 씁니다. 직무확인, 직무선택, 직무수정, 결과보기, 참가현황. 붙여 쓴 것도 4자를 넘기지 않습니다(5자는 목적어를 다시 뺄 수 있는지 먼저 봅니다).
- 버튼 안에 숫자는 넣지 않습니다(대시보드 결정 220). "초대", "제외". 숫자는 버튼 옆 한 줄이나 대화상자 본문에 둡니다.
- 다른 화면으로 가는 버튼은 "○○으로". "홈으로", "결과로", "참가현황으로".
- 고유 이름은 조사 없이 붙입니다. "Google 시작", "Microsoft 시작", "'웅진스킬원' 계속".
- 예외: 확인 대화상자의 답("맞아요", "아직이요")은 질문에 대한 대답이라 문장 꼴을 둡니다. 화살표(→)는 여정 버튼에서만, 글 뒤에 한 칸 띄웁니다.
- 낱말은 카피 사전(완성도 원칙 §10)의 표준어만 씁니다. 사람은 "실무자", 삭제와 제외는 구분.
줄바꿈 (2026-11-06, 호준 결정)
글은 문장 단위로 줄이 바뀌는 게 가장 좋습니다. 안 되면 뜻이 끊기지 않는 자리에서 바뀌어야 합니다. 낱말 가운데서 끊기는 것은 금지입니다.
- 제목이 두 문장이면 문장 사이에
<br>을 넣습니다. 한 문장이면 넣지 않고text-wrap: balance에 맡깁니다(두 줄 길이가 비슷해짐). - 본문은
text-wrap: pretty. 마지막 줄에 한 낱말만 남는 것을 막아 줍니다. - 의존 명사는 앞 낱말과 붙어 다닙니다. "시작할 수 있어요"의 "할"과 "수", "할 것", "할 때", "갈 뿐". 띄어쓰기 자리에 공백 대신 줄 안 바뀌는 공백(U+00A0)을 씁니다. 미리보기는 스크립트로 넣었고, 코드 쪽은 글 넣는 함수에서 같은 규칙(정규식
([가-힣]) (수|것|때|뿐|듯), 코드 쪽은 빌드 단계에서 멱등으로)을 적용하면 됩니다. - 숫자와 단위("1,248명", "45명만", "3일 전"), 고유 이름("웅진스킬원"), 영문 약어("AI 전환")는 한 덩어리입니다. 끊기면
sl-nobr로 감쌉니다. - 전체에
word-break: keep-all(낱말 안에서 안 끊김),line-break: strict(줄 머리에 조사나 문장 부호가 오지 않음). - 버튼 글은 줄을 바꾸지 않습니다(
white-space: nowrap). 안 들어가면 글을 줄이지 줄을 늘리지 않습니다. - 확인 방법: 폰 390과 PC 서랍 열린 폭(600 안팎)에서 제목과 설명을 봅니다. "시작할 / 수 있어요"처럼 끊기면 규칙 위반입니다.
문장 부호 기준 (국립국어원 문장 부호 규정에 따름)
- 줄표(가로로 긴 대시)는 쓰지 않는다. 화면 글, 문서, 코드 주석 어디에도.
- 나열은 '와/과'나 쉼표로 쓴다. 예: 커밋과 푸시 / 읽기, 재기, 캡처
- 가운뎃점은 상·중·하처럼 짝을 이룬 짧은 말에만, 앞뒤를 붙여 쓴다. 앞뒤를 띄운 가운뎃점은 쓰지 않는다.
- 덧붙이는 설명은 쌍점이나 괄호로 쓰고, 길면 문장을 나눈다.
- 화면 글은 기호보다 줄바꿈과 목록을 먼저 쓴다.
- 단계 표기는 "1/5 회사, 목적, 목표 (2/3)"처럼 쓴다. 빗금 앞뒤는 붙이고, 작은 단계는 괄호.
렌지 소개와 검토 장치 (2026-11-09, 8판)
- 렌지 소개는 따로 상자를 두지 않습니다. 렌지가 처음 나오는 자리(예: 회사 조회 로딩 부제)에 "렌지는 SkillLens의 AI예요" 한 줄을 씁니다. 화면 제목은 폰 20자 안.
- 연출 다시 보기 같은 검토용 장치는 제품 화면 안에 두지 않고 시안 바깥 검토 띠에 둡니다.
숫자와 날짜
- 숫자: 천 단위 쉼표, 단위를 붙임(1,248명, 68점). 비율은 정수 %(91%).
- 증감: 부호를 늘 붙임(▲3, ▼2, +12%). 0이면 "변화 없음".
- 진단하지 않은 것은 0이 아니라 "진단 안 함", 계산할 수 없으면 "확인할 수 없음".
- 날짜: "11. 20. (금)", 해가 다르면 "2027. 1. 5. (화)". 시각은 24시간 "18:00". 모두 한국 시각.
- 가까운 때: 1시간 안은 "10분 전", 오늘은 "오늘 14:20", 그 밖은 날짜.
용어
- 화면 글의 낱말은 ideber 저장소의 SkillLens 용어 사전을 따릅니다(관리자, 실무자, 렌지, 반영, 미반영, 검토완료, 재진단, 결과확정, 필수 스킬, 확장 스킬, 진단스킬).
- 쓰지 않는 말: "결과 승인, 반려, 거부, 선택 스킬", "대상자"(실무자 본인에게).
이 사이트는 ideber 저장소 projects/skill-lens/ 에서 자동으로 만들어집니다. 고칠 때는 저장소를 고칩니다. 공개 주소이지만 검색엔진에는 나오지 않습니다.