clarify

개요

clarify란?

clarify 스킬은 UI 및 UX 팀이 혼란스럽거나 불명확한 인터페이스 텍스트를 식별하고 개선하도록 돕기 위해 설계되었습니다. 여기에는 사용자 이해를 방해할 수 있는 오류 메시지, 마이크로카피, 라벨, 지침 등이 포함됩니다. 이러한 요소들을 체계적으로 검토하고 재작성함으로써, clarify는 제품이 사용자와 명확하고 효과적으로 소통할 수 있도록 보장합니다.

누가 clarify를 사용해야 하나요?

clarify는 제품 디자이너, UX 라이터, UI 개발자 및 인터페이스 텍스트를 담당하는 모든 분들에게 적합합니다. 사용자가 혼란스러운 라벨, 모호한 지침, 불명확한 오류 메시지로 어려움을 겪는다면, 이 스킬은 명확성과 사용성을 개선하는 체계적인 접근법을 제공합니다.

clarify가 해결하는 문제

• 인터페이스 텍스트 내 불명확하거나 전문 용어 사용
• 모호하거나 오해를 불러일으키는 지침
• 마이크로카피의 일관성 없는 톤이나 스타일
• 도움이 되지 않고 혼란을 주는 오류 메시지
• 사용자가 추측하게 만드는 라벨과 프롬프트

사용 방법

설치 단계

1. 다음 명령어로 clarify 스킬을 설치하세요:

   npx skills add https://github.com/pbakaus/impeccable --skill clarify

2. clarify 워크플로우와 요구사항에 대한 개요는 SKILL.md 파일에서 확인하세요.

3. 추가적인 맥락과 통합 세부사항은 README.md, AGENTS.md, metadata.json 파일을 검토하세요.

워크플로우 안내

• 필수 준비 사항:
  • 변경 작업 전에 /frontend-design 명령어를 실행해 디자인 원칙과 맥락을 수집하세요. 디자인 맥락이 없으면 먼저 /teach-impeccable을 실행하세요.
  • 사용자 기술 수준과 인터페이스 사용 시 정신 상태에 관한 정보를 수집하세요.
• 현재 카피 평가:
  • 전문 용어, 모호성, 수동태, 과도한 길이, 가정, 맥락 누락, 톤 불일치 등의 문제를 식별하세요.
  • 각 인터페이스 요소에 대한 사용자의 목표, 행동, 제약 조건을 이해하세요.
• 계획 및 개선:
  • 사용자 영향도를 기준으로 수정이 필요한 카피 요소를 우선순위로 정하세요.
  • 명확하고 간결하며 대상과 상황에 적합하도록 텍스트를 재작성하세요.
  • 가능하면 실제 사용자와 함께 수정된 카피를 테스트하세요.

검토 권장 파일

• clarify 프로세스 개요는 SKILL.md에서 시작하세요.
• 더 깊은 통합과 모범 사례는 지원 파일을 탐색하세요.

자주 묻는 질문

언제 clarify 스킬을 사용해야 하나요?

사용자가 인터페이스 텍스트, 오류 메시지, 지침에 혼란을 느낄 때 또는 UX 라이팅 품질을 선제적으로 개선하고 싶을 때 clarify를 사용하세요.

clarify는 코드도 변경하나요, 아니면 텍스트만 변경하나요?

clarify는 인터페이스 텍스트와 마이크로카피 개선에 집중하며, 백엔드 로직이나 애플리케이션 코드는 변경하지 않습니다.

clarify 사용 전 어떤 준비가 필요한가요?

디자인 맥락을 수집하고 대상 사용자를 이해해야 합니다. /frontend-design 명령어를 사용하고 필요 시 /teach-impeccable을 실행해 편집 전 필요한 배경 정보를 확보하세요.

clarify 워크플로우에 대한 자세한 내용은 어디서 확인할 수 있나요?

clarify 스킬 디렉터리 내 SKILL.md 파일에서 단계별 가이드를 확인할 수 있습니다. 추가 자료는 저장소 내 관련 문서와 스크립트를 참고하세요.