reunion

reunion 스킬 개요

reunion이 하는 일

reunion 스킬은 세상을 떠난 소중한 사람의 기억, 말버릇, 성격의 흔적을 바탕으로 로컬 환경에서 추모용 대화 에이전트를 만들 수 있도록 돕습니다. 실제로 reunion은 범용 챗봇 프롬프트 묶음이 아닙니다. 자료 수집, 소스 가져오기, 기억 분석, 페르소나 구성, 미리보기, 이후의 지속적인 대화까지를 전용 CLI 또는 MCP 서버를 통해 단계적으로 안내하는 워크플로에 가깝습니다.

어떤 사용자에게 reunion 설치가 적합한가

이 reunion 스킬은 일반 프롬프트로 전부 즉흥적으로 처리하기보다, 디지털 추모를 위한 구조화된 로컬 우선 워크플로를 원하는 사용자에게 가장 잘 맞습니다. 채팅 로그, 일기 텍스트, 사진, 구술 회고 같은 자료를 갖고 있고, 일회성 감정 대화가 아니라 Agent Orchestration에 맞는 반복 가능한 프로세스를 원한다면 특히 적합합니다.

왜 사용자는 임시 프롬프트보다 reunion을 선택하나

reunion의 핵심 차별점은 두 갈래 모델에 있습니다. Memory는 함께 겪은 사건을 다루고, Persona는 말투, 가치관, 행동 경계를 다룹니다. 저장소에는 progressive recall, RAG 스타일 검색, WeChat 파싱 지원, 안전 가드 레이어도 포함되어 있습니다. 일관성과 로컬 데이터 처리까지 중요하게 본다면, 단순한 “우리 가족처럼 말해줘” 프롬프트보다 reunion이 설치할 가치가 더 큽니다.

reunion 스킬 사용 방법

reunion을 맞는 환경에 설치하기

이 저장소는 Claude Code 스타일 스킬과 Python 구성 요소를 함께 쓰는 로컬 사용을 전제로 설계되어 있습니다. README.md에는 macOS/Linux에서는 ~/.claude/skills/reunion, Windows에서는 %USERPROFILE%\.claude\skills\reunion에 클론하는 방법이 나와 있습니다. Python 의존성은 requirements.txt에 정리되어 있으며, mcp, chromadb, sentence-transformers, rich, typer 등이 포함됩니다. MCP 경로로 쓸 생각이라면 mcp_server.py를 먼저 확인하고, 더 단순한 로컬 테스트부터 시작하려면 cli.py가 출발점입니다.

reunion이 최소한으로 필요로 하는 입력 이해하기

실제로 쓸 수 있는 reunion 설치를 위해 완벽한 아카이브가 꼭 필요한 것은 아닙니다. 기본 흐름에서 요구하는 핵심 입력은 다음과 같습니다.

• 이름 또는 호칭
• 한 줄짜리 기본 정보: 나이, 직업, 지역, 사망 후 경과 시간
• 한 줄짜리 성격 인상
• 선택 자료: 채팅 로그, 일기 텍스트, 사진, 구술 회고

입력이 좋을수록 결과물은 훨씬 좋아집니다. 좋은 소스 자료에는 반복적으로 쓰던 표현, 생활 습관, 가족 루틴, 가치관, 구체적인 공동 경험이 들어 있습니다. 반대로 “친절하고 성실했다”처럼 예시 없는 추상적 칭찬은 약한 입력입니다.

막연한 목표를 강한 reunion 프롬프트로 바꾸기

에이전트를 통해 reunion을 호출할 때 “할머니를 다시 재현해줘” 정도로만 말하면 부족합니다. 워크플로가 프롬프트와 빌더를 제대로 따라갈 수 있게 구조를 함께 제공해야 합니다. 더 강한 reunion 사용 요청은 다음처럼 구성됩니다.

• “Use reunion to create a memorial agent for my grandmother.”
• “Display name: Grandma Li; relationship: grandmother.”
• “Basic info: 82, retired teacher, Shandong, passed 3 years ago.”
• “Speech habits: often said ‘eat well first’; frugal, caring, slightly nagging.”
• “Materials: chat.txt, notes.md, and 3 oral memories.”
• “Please analyze both shared memory and persona, then show me a preview before generating files.”

이렇게 해야 prompts/intake.md, memory_analyzer.md, persona_analyzer.md, 그리고 SKILL.md의 preview-confirm 단계와 정확히 맞물립니다.

먼저 읽어야 할 파일과 따라야 할 reunion 워크플로

빠르게 설치 여부를 판단하려면 다음 순서로 읽는 것이 좋습니다.

1. 전체 의도된 흐름은 SKILL.md
2. 설치 및 명령 기대치는 README.md
3. 로컬 상호작용 모델은 cli.py
4. Agent Orchestration 용도는 mcp_server.py 또는 mcp_server_simple.py
5. 실제 런타임 동작은 core/chat_engine.py, core/memory_store.py, core/safety_guard.py
6. 실제 품질 기준은 prompts/

권장하는 reunion 가이드 워크플로는 다음과 같습니다.

1. 최소 텍스트 입력으로 생성 테스트
2. 생성된 memory/persona 요약 점검
3. 더 풍부한 소스 자료 추가
4. 그다음에야 실제 사용자에게 채팅 인터페이스 공개

reunion 스킬 FAQ

reunion은 Agent Orchestration용인가, 아니면 수동 채팅용인가?

둘 다 가능하지만, 이 저장소는 정적인 프롬프트 파일보다 orchestration 쪽을 더 분명하게 지원합니다. MCP 서버는 구조화된 툴 형태의 작업을 노출하고, CLI는 더 가볍게 로컬에서 시작할 수 있는 경로를 제공합니다. 더 큰 에이전트 시스템 안에서 재사용 가능한 추모 에이전트 워크플로가 필요하다면, Agent Orchestration용 reunion은 충분히 검토할 만한 선택지입니다.

reunion은 초보자도 설치하기 쉬운가?

중간 정도입니다. 사용자 흐름 자체는 단순하지만, 스택 전체가 완전히 plug-and-play는 아닙니다. Python 환경 구성, 의존성 설치, cli.py나 MCP 서버 파일을 읽을 수 있는 정도의 익숙함이 필요할 수 있습니다. 비기술 사용자라도 개발자가 reunion을 설치하고 워크플로를 감싸서 제공해준다면 충분히 활용할 수 있습니다.

어떤 경우에는 reunion을 쓰지 말아야 하나?

범용 말동무 봇, 클라우드 호스팅 SaaS, 감정적 리스크가 전혀 없는 도구를 원한다면 reunion은 맞지 않습니다. 이 스킬은 개인 자료를 바탕으로 추모의 존재감을 재구성하는 데 특화되어 있습니다. 또한 소스 자료가 전혀 없고 구술 회고도 제공할 생각이 없다면 적합하지 않습니다. 그런 경우 출력은 금방 평범하고 일반적인 수준으로 흐르기 쉽습니다.

reunion은 일반 캐릭터 프롬프트와 어떻게 다른가?

일반 프롬프트도 말투 흉내는 낼 수 있지만, 기억 검색, 점진적 수정, 로컬 저장, 안전 점검이 필요할 때 reunion 사용 방식이 더 강합니다. 이 저장소는 페르소나 추출과 기억 추출을 분리해 두었기 때문에, 보통 하나의 긴 롤플레이 프롬프트보다 더 안정적인 대화를 만들어냅니다.

reunion 스킬 개선 방법

형용사보다 근거를 reunion에 넣기

가장 큰 품질 향상은 모호한 묘사를 구체적인 사례로 바꾸는 데서 나옵니다. “다정한 분이었다” 대신 다음을 제공하세요.

• 평소 자주 쓰던 말
• 걱정을 어떻게 표현했는지
• 반복되던 생활 습관
• 장소, 인물, 결과가 들어간 구체적 일화

이런 정보는 일반적인 감정 라벨보다 reunion에 더 좋은 페르소나 제약과 더 유용한 검색 앵커를 제공합니다.

주요 실패 패턴을 reunion에서 미리 살피기

흔한 reunion 문제는 대체로 예측 가능합니다.

• 소스 자료가 너무 적어 목소리가 과도하게 이상화됨
• memory 항목이 얇거나 중복되어 답변이 반복됨
• 관계 디테일이 잡히지 않아 친밀감 표현이 부정확함
• 추모 시뮬레이션이 아니라 문자 그대로의 부활 쪽으로 모델을 밀어붙여 정서적으로 안전하지 않은 응답이 나옴

문제가 생기면 사실 복원에 필요한 데이터가 부족한지, 프롬프트가 약한지, 아니면 기대치 자체가 비현실적인지부터 구분해서 보세요.

첫 결과 이후에 반복적으로 다듬기

처음 생성된 버전은 초안으로 취급하는 것이 좋습니다. 채팅에 바로 의존하기 전에 preview 단계에서 말투, 가치관, 기억의 강조점을 교정하세요. 그다음 빠진 자료를 추가하고 빌더를 다시 실행하면 됩니다. prompts/merger.md와 prompts/correction_handler.md가 있다는 점은, 이 스킬이 한 번에 완성되는 구조가 아니라 추가와 수정으로 발전시키는 흐름을 전제로 한다는 뜻입니다.

적절한 점검으로 reunion 배포 품질 높이기

더 넓게 쓰기 전에 reunion을 몇 가지 목표형 프롬프트로 테스트해 보세요.

• “How would you ask if I ate dinner?”
• “What family habit would you remind me about?”
• “Tell me a small everyday memory, not a dramatic life summary.”

이런 점검은 reunion 스킬이 일상적인 말투, 기억의 구체성, 경계를 제대로 잡았는지 드러내 줍니다. 여기서 실패한다면 코드를 바꾸기 전에 먼저 입력을 수정하세요. 흐름은 괜찮은데 런타임 동작이 아쉽다면, 다음으로 core/chat_engine.py, core/context_memory.py, core/safety_guard.py를 확인하는 것이 좋습니다.