titanwings/distilly

Distilly — Distill how they think into reusable Skills for any Agent or Bot. Formerly Colleague Skill（原同事 Skill）.

🧬 Distilly - AI 에이전트용 인물 프로필 빌더

정의 - 메시지, 문서, 인터뷰, 공개 콘텐츠 모음을 **출처 기반 '인물 프로필'**로 변환하는 오픈소스 Python 라이브러리(및 Agent Skills 세트). 프로필은 Agent Skill로 패키징되어 다양한 AI 에이전트 플랫폼(Claude Code, Hermes, OpenClaw, Codex, DeepSeek Harness, Pi, Grok Build, OpenCode 등)에 설치할 수 있습니다.

중요성 - 현대의 대화형 에이전트는 세션을 초월해 지속되는 개성 또는 지식 베이스를 지원하기 시작했습니다. Distilly는 실제 또는 가상 인물의 경험, 판단, 목소리, 업무 습관을 체계적으로 포착하고, 개인을 복제한다고 주장하지 않으면서 해당 모델을 에이전트 간에 재사용할 수 있는 방법을 제공합니다.

🎯 핵심 기능

기능	작동 방식
세 가지 '인물 패밀리'	동료(업무 중심), 관계(개인적 톤), 유명인(공인). 각 패밀리는 고유한 데이터 수집 전략, 분석 차원, 프로필 스키마를 갖습니다.
출처 기반 프로파일링	메시지(Slack, Lark, DingTalk, X, WeChat, 이메일, Markdown, PDF 등)를 수집하고, 관찰 가능한 의사 결정, 표현 패턴, 업무 흐름 습관을 추출하여 구조화된 프로필로 통합합니다.
스킬 패키징	생성된 프로필은 Agent Skill(예: `colleague-byte-dance-backend.skill`)로 출력됩니다. 스킬은 지원되는 모든 호스트에 로컬로 설치할 수 있습니다.
멀티 호스트 지원	8개 에이전트(Claude Code, Hermes-Agent, OpenClaw, OpenAI Codex, DeepSeek Harness, Pi, Grok Build, OpenCode)에 대한 기본 검색.
버전 관리 및 수정	업데이트는 추가되며 덮어쓰지 않습니다. 모든 변경 사항은 보관되며 롤백할 수 있습니다. 사용자는 프로필을 즉시 편집하는 수정 명령(예: "그들은 그렇게 말하지 않을 거야")을 발행할 수 있습니다.
유명인 연구 파이프라인	공인을 위해 6차원 파이프라인(자막 → 대본 정리 → 병합 → 품질 검사)이 작품, 인터뷰, 의사 결정, 표현 DNA, 외부 평가, 타임라인을 다루는 연구 자료를 구축합니다.
개인 에이전트 인계	프로필을 개인 에이전트의 '메모리 파일'(예: `~/.claude/CLAUDE.md`)에 기록하여 새 에이전트가 해당 인물의 모델을 이미 로드한 상태로 시작할 수 있습니다.

📦 지원 데이터 소스

소스	메시지 액세스	문서 액세스	참고
Lark	✅ API(자동)	✅ API	이름만 지정하면 봇이 자동으로 채팅에 참여합니다
DingTalk	⚠️ 브라우저 전용	✅ API	기록이 API를 통해 완전히 제공되지 않을 수 있음
Slack	✅ API	—	관리자가 설치한 봇 필요, 무료 플랜은 90일 기록으로 제한
X(Twitter)	✅ API	—	선택 사항, 타사 Xquik 서비스 이용
WeChat	✅ SQLite 내보내기	—	먼저 WeChatMsg 또는 PyWxDump으로 내보내기
이메일(`.eml`, `.mbox`)	✅	—	수동 업로드
PDF / 이미지 / 스크린샷	—	✅	드래그 앤 드롭 업로드
Markdown / 직접 붙여넣기	✅	✅	인라인 입력

⚡ 설치

에이전트용 - 대상 에이전트의 UI에서 실행:
```
Install Distilly from https://github.com/titanwings/distilly
```
호스트가 distilly 스킬을 검색하여 스킬 디렉토리에 배치합니다.
개발자/사람용 - 호스트가 사용하는 스킬 디렉토리에 리포지토리 클론:
```
git clone https://github.com/titanwings/distilly <DISTILLY_SKILL_DIR>
```
OS별 세부 단계, 자격 증명 설정, 마이그레이션 노트는 INSTALL_EN.md에 있습니다.

🚀 일반적인 워크플로우

크리에이터 시작 - 에이전트에게 "Distilly를 사용하여 내 프로필을 설정해 줘"라고 말합니다. 크리에이터가 인터뷰(약 5분)를 진행하고 결과를 ~/.distilly/owner/profile.md에 저장합니다.
다른 사람의 프로필 만들기 - 에이전트에서 다음과 같이 말합니다:
```
Use Distilly to create a Person Profile for <person>
```
- 패밀리 선택(colleague / relationship / celebrity).
- 간단한 설명 제공 및/또는 소스 자료 업로드.
- 생성된 프로필 검토 후 승인 또는 수정 요청.
스킬 생성 - Distilly는 {family}-{slug} 형식의 스킬 폴더(예: celebrity-andrej-karpathy.skill)를 출력합니다. 이 폴더를 지원되는 호스트에 설치합니다.
에이전트 사용 - 에이전트는 프로필의 규칙, 톤, 의사 결정 휴리스틱을 사용하여 해당 인물처럼 질문에 답하거나 행동할 수 있습니다.

📚 데모 스니펫(README에서)

유명인 - Andrej Karpathy:

celebrity.skill ❯ Everyone's doing demos, nobody's doing eval.
                  The Agent bottleneck was never model intelligence — it's scaffolding…

동료 - ByteDance 백엔드 엔지니어:

colleague.skill ❯ Hold on — what's the impact? … N+1 query, fix it.

관계 - 짝사랑 상대:

relationship.skill ❯ ...I did, a little bit. Why are you asking?

📄 기술 배경

원본 연구 논문 COLLEAGUE.SKILL(arXiv 2605.31264)은 2계층 아키텍처(Persona + Work Skill)와 자동 스킬 생성 파이프라인을 설명합니다. Distilly는 이 작업을 relationship 및 celebrity 패밀리로 확장하고 멀티 호스트 스킬 패키징을 추가합니다.
프로필은 버전 관리되며 각 업데이트는 보관 항목을 생성하여 롤백을 가능하게 합니다.
모든 코드는 MIT 라이선스로 배포됩니다.

🤝 커뮤니티 및 생태계

Discord - 지원, 스킬 카드 공유, 로드맵 논의를 위한 활발한 커뮤니티: https://discord.gg/NVX66RxWZv
갤러리 - 200개 이상의 커뮤니티 기여 스킬 공개 전시: https://titanwings.github.io/colleague-skill-site/
로드맵 - 향후 계획(호스트 지원 확대, 심층 연구 파이프라인, UI 도구)은 ROADMAP.md에 있습니다.

📦 빠른 시작(로컬 Claude Code 호스트용 원라이너)

# From a terminal inside the Claude Code skill directory
git clone https://github.com/titanwings/distilly ~/.claude/skills/distilly && \
    echo "Distilly installed – ask your Claude agent to create a profile!"

📜 인용

연구 또는 제품에서 Distilly를 사용하는 경우 첨부된 arXiv 논문을 인용하세요:

@misc{zhou2026colleagueskill,
  title        = {COLLEAGUE.SKILL: Automated AI Skill Generation via Expert Knowledge Distillation},
  author       = {Tianyi Zhou and Dongrui Liu and Leitao Yuan and Jing Shao and Xia Hu},
  year         = {2026},
  eprint       = {2605.31264},
  archivePrefix = {arXiv},
  primaryClass = {cs.AI},
  url          = {https://arxiv.org/abs/2605.31264}
}

🛡️ 라이선스

MIT - 상업 및 비상업적 사용 무료.