Skip to content

Repository files navigation

persona-ut

스크린샷 하나와 질문만 던지면, 정해둔 페르소나가 실제로 그 화면을 봤을 때 할 법한 반응을 대신 답해주는 경량 UX 인터뷰 시뮬레이터입니다. 실제 사용자 테스트(UT)를 매번 준비하기 어려울 때, 디자인 초안을 빠르게 점검할 수 있습니다.

토스 기술 블로그의 두 아티클에서 소개한 사내 도구 "휴리봇"의 취지 — 사용자처럼 학습된 AI로 가볍고 빠르게 사용성을 점검한다 — 에 공감해서 만들었습니다.

이 도구가 하는 일

  • 화면 이미지 한 개와 함께 질문 한 개를 던져주면, 페르소나에 따라서 답변합니다.
  • 화면 이미지 + "전체 인터뷰해줘" → 표준 질문 세트를 순서대로 묻고 답하는 미니 인터뷰
  • 결과는 분석 리포트가 아니라 페르소나가 실제로 말한 것 같은 대화체 답변 그 자체입니다.

핵심은 프롬프트 설계입니다. 답변 생성 3원칙(역할·상황 우선, 의도적으로 대충 보기, 구어체로 답하기)을 따르고, 프롬프트 문서 자체도 아티클의 "긍정 지시문" 원칙(부정형 대신 긍정형으로 지시문 작성)에 맞춰 씁니다. 자세한 내용은 PRINCIPLES.md 참고.

어떻게 쓰나요

skill/persona-ut/Agent Skills 오픈 표준(2025년 12월 Anthropic이 공개, SKILL.md + frontmatter 구조)을 따릅니다. 이 표준을 지원하는 도구라면 변환 없이 그대로 설치해서 씁니다.

1) Claude Code

# 심링크로 설치 (레포를 수정하면 스킬에도 바로 반영됨)
ln -s "$(pwd)/skill/persona-ut" ~/.claude/skills/persona-ut

# 또는 그냥 복사
cp -r skill/persona-ut ~/.claude/skills/persona-ut

설치 후 "이 Figma 화면 페르소나로 봐줘" 같은 요청을 하면 스킬이 자동으로 트리거됩니다. Figma MCP가 연결되어 있으면 링크만 줘도 화면을 자동 캡처합니다.

2) Claude 앱 (claude.ai / 데스크톱)

Claude Code와 별개로 Claude 앱도 Skills 업로드를 지원합니다(설정 → Capabilities → Skills). skill/persona-ut/ 폴더를 zip으로 압축해서 업로드하면 동일하게 동작합니다. Figma 연동이 없는 환경이면 스크린샷을 직접 첨부하면 됩니다.

3) ChatGPT

ChatGPT도 같은 Agent Skills 표준의 "Skills" 기능을 지원합니다(현재 Business/Enterprise/Healthcare/Edu 워크스페이스). 이 경우도 skill/persona-ut/를 그대로 업로드하면 됩니다. Skills 기능이 없는 일반 ChatGPT(Free/Plus 등)라면 PROMPT.md 기반 Custom GPT를 쓰면 됩니다. 자세한 설치 방법은 chatgpt/README.md 참고.

4) 그 외 모든 LLM

Skills를 지원하지 않는 도구이거나 그냥 빠르게 한 번 써보고 싶다면, PROMPT.md의 "프롬프트 시작"~"프롬프트 끝" 사이 내용을 복사해서 대화에 붙여넣고 화면 스크린샷을 첨부하면 됩니다. 이미지 입력을 지원하는 LLM이면(Claude, Gemini 등) 동일하게 동작합니다.

나만의 페르소나로 커스터마이징하기

기본 예시는 학술 소모임 홈페이지("게임웍스") 기준으로 되어 있습니다. 자신의 제품에 맞게 쓰려면:

  1. personas.md의 "나만의 페르소나 만들기" 가이드를 따라 페르소나를 새로 정의
  2. Skill로 쓴다면 skill/persona-ut/references/personas.md도 같은 내용으로 갱신 (SKILL.md는 이 파일을 참조만 할 뿐 내용을 따로 갖고 있지 않다)
  3. 프롬프트 붙여넣기 방식이라면 PROMPT.md의 "페르소나 프리셋" 섹션을 새 내용으로 교체

질문 세트는 interview-questions.md에서 화면 유형에 맞게 추가/수정하면 됩니다.

콘텐츠 원본과 사본

PRINCIPLES.md, personas.md, interview-questions.md 3개가 유일한 원본(source of truth)입니다. SKILL.md는 이 내용을 다시 타이핑하지 않고 skill/persona-ut/references/에 있는 사본을 참조만 합니다(스킬 폴더가 zip으로 독립 설치될 수 있어서 저장소 루트를 참조할 수 없기 때문에, 파일 자체는 복사해둬야 함).

PROMPT.md만 예외입니다 — ChatGPT 등에 통째로 붙여넣는 텍스트라 다른 파일을 참조할 수 없고, 3개 원본 내용을 그 안에 풀어서(inline) 담고 있습니다. 즉 원본 3개를 고치면 skill/persona-ut/references/의 사본과 PROMPT.md를 수동으로 다시 맞춰야 합니다.

저장소 구조

persona-ut/
├── PRINCIPLES.md              # 답변 생성 3원칙 (원본)
├── personas.md                # 페르소나 프리셋 + 커스터마이징 가이드 (원본)
├── interview-questions.md     # 풀 인터뷰용 표준 질문 세트 (원본)
├── PROMPT.md                  # 범용 LLM용 복사-붙여넣기 프롬프트 (위 3개의 자기완결형 스냅샷)
├── skill/persona-ut/          # Agent Skills 표준 스킬 (Claude Code·Claude 앱·ChatGPT Skills 공용)
│   ├── SKILL.md                    # 원본을 참조만 함, 내용을 다시 담지 않음
│   └── references/            # PRINCIPLES.md·personas.md·interview-questions.md 사본
└── chatgpt/README.md          # ChatGPT 전용 설치 가이드 (Skills / Custom GPT)

라이선스

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors