docs: add Korean README and roadmap translations (#104)

2026-05-06 15:22:39 +08:00 · 2026-04-14 20:32:10 +09:00
parent d0fb7b4740
commit 10d96e9610
17 changed files with 424 additions and 17 deletions
--- a/README.md
+++ b/README.md
@@ -29,7 +29,7 @@ and get an **AI Skill that actually works like them**

 [Supported Sources](#supported-data-sources) · [Install](#install) · [Usage](#usage) · [Demo](#demo) · [Detailed Install](INSTALL.md) · [💬 Discord](https://discord.gg/aRjmJBdK)

-[**中文**](docs/lang/README_ZH.md) · [**Español**](docs/lang/README_ES.md) · [**Deutsch**](docs/lang/README_DE.md) · [**日本語**](docs/lang/README_JA.md) · [**Русский**](docs/lang/README_RU.md) · [**Português**](docs/lang/README_PT.md)
+[**中文**](docs/lang/README_ZH.md) · [**Español**](docs/lang/README_ES.md) · [**Deutsch**](docs/lang/README_DE.md) · [**日本語**](docs/lang/README_JA.md) · [**Русский**](docs/lang/README_RU.md) · [**Português**](docs/lang/README_PT.md) · [**한국어**](docs/lang/README_KO.md)

 </div>

--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -21,7 +21,7 @@ Anyone can become a `.skill`.

 *Last updated: 2026-04-13*

-[**中文**](docs/lang/ROADMAP_ZH.md) · [**Español**](docs/lang/ROADMAP_ES.md) · [**Deutsch**](docs/lang/ROADMAP_DE.md) · [**日本語**](docs/lang/ROADMAP_JA.md) · [**Русский**](docs/lang/ROADMAP_RU.md) · [**Português**](docs/lang/ROADMAP_PT.md)
+[**中文**](docs/lang/ROADMAP_ZH.md) · [**Español**](docs/lang/ROADMAP_ES.md) · [**Deutsch**](docs/lang/ROADMAP_DE.md) · [**日本語**](docs/lang/ROADMAP_JA.md) · [**Русский**](docs/lang/ROADMAP_RU.md) · [**Português**](docs/lang/ROADMAP_PT.md) · [**한국어**](docs/lang/ROADMAP_KO.md)

 </div>

--- a/docs/lang/README_DE.md
+++ b/docs/lang/README_DE.md
@@ -27,7 +27,7 @@ Liefere Quellmaterialien (Slack-Nachrichten, Confluence-Docs, E-Mails, Screensho
 plus deine subjektive Beschreibung der Person<br>
 und erhalte einen **AI Skill, der tatsächlich wie sie arbeitet**

-[Datenquellen](#unterstützte-datenquellen) · [Installation](#installation) · [Nutzung](#nutzung) · [Demo](#demo) · [Detaillierte Installation](../../INSTALL.md) · [**中文**](README_ZH.md) · [**English**](../../README.md) · [💬 Discord](https://discord.gg/aRjmJBdK)
+[Datenquellen](#unterstützte-datenquellen) · [Installation](#installation) · [Nutzung](#nutzung) · [Demo](#demo) · [Detaillierte Installation](../../INSTALL.md) · [**中文**](README_ZH.md) · [**English**](../../README.md) · [**한국어**](README_KO.md) · [💬 Discord](https://discord.gg/aRjmJBdK)

 </div>

--- a/docs/lang/README_EN.md
+++ b/docs/lang/README_EN.md
@@ -27,7 +27,7 @@ Provide source materials (Feishu messages, DingTalk docs, Slack messages, emails
 plus your subjective description of the person<br>
 and get an **AI Skill that actually works like them**

-[Supported Sources](#supported-data-sources) · [Install](#install) · [Usage](#usage) · [Demo](#demo) · [Detailed Install](../../INSTALL.md) · [**中文**](../../README.md) · [**Español**](README_ES.md) · [**Deutsch**](README_DE.md) · [**日本語**](README_JA.md) · [**Русский**](README_RU.md) · [**Português**](README_PT.md) · [💬 Discord](https://discord.gg/aRjmJBdK)
+[Supported Sources](#supported-data-sources) · [Install](#install) · [Usage](#usage) · [Demo](#demo) · [Detailed Install](../../INSTALL.md) · [**中文**](../../README.md) · [**Español**](README_ES.md) · [**Deutsch**](README_DE.md) · [**日本語**](README_JA.md) · [**Русский**](README_RU.md) · [**Português**](README_PT.md) · [**한국어**](README_KO.md) · [💬 Discord](https://discord.gg/aRjmJBdK)

 </div>

@@ -41,7 +41,7 @@ and get an **AI Skill that actually works like them**

 > 🆕 **2026.04.13 Update** — **dot-skill Roadmap is live!** colleague.skill is evolving into **dot-skill** — distill anyone, not just colleagues. Multimodal output, skill ecosystems, and more on the way.
 >
-> 👉 **[Read the full Roadmap](ROADMAP_EN.md)** · **[💬 Discord](https://discord.gg/aRjmJBdK)**
+> 👉 **[Read the full Roadmap](../../ROADMAP.md)** · **[💬 Discord](https://discord.gg/aRjmJBdK)**
 >
 > We've also cleaned up Issues, added Milestones, and set up a [public project board](https://github.com/users/titanwings/projects/1). Community contributions welcome — check `good-first-issue` labels!

--- a/docs/lang/README_ES.md
+++ b/docs/lang/README_ES.md
@@ -27,7 +27,7 @@ Proporciona materiales fuente (mensajes de Slack, docs de Confluence, emails, ca
 más tu descripción subjetiva de la persona<br>
 y obtén un **AI Skill que realmente trabaja como ellos**

-[Fuentes de datos](#fuentes-de-datos-soportadas) · [Instalación](#instalación) · [Uso](#uso) · [Demo](#demo) · [Instalación detallada](../../INSTALL.md) · [**中文**](README_ZH.md) · [**English**](../../README.md) · [💬 Discord](https://discord.gg/aRjmJBdK)
+[Fuentes de datos](#fuentes-de-datos-soportadas) · [Instalación](#instalación) · [Uso](#uso) · [Demo](#demo) · [Instalación detallada](../../INSTALL.md) · [**中文**](README_ZH.md) · [**English**](../../README.md) · [**한국어**](README_KO.md) · [💬 Discord](https://discord.gg/aRjmJBdK)

 </div>

--- a/docs/lang/README_JA.md
+++ b/docs/lang/README_JA.md
@@ -27,7 +27,7 @@
 ＋あなたの主観的な人物描写を提供するだけで<br>
 **本当にその人のように働くAI Skill**が生成されます

-[データソース](#対応データソース) · [インストール](#インストール) · [使い方](#使い方) · [デモ](#デモ) · [詳細インストール](../../INSTALL.md) · [**中文**](README_ZH.md) · [**English**](../../README.md) · [💬 Discord](https://discord.gg/aRjmJBdK)
+[データソース](#対応データソース) · [インストール](#インストール) · [使い方](#使い方) · [デモ](#デモ) · [詳細インストール](../../INSTALL.md) · [**中文**](README_ZH.md) · [**English**](../../README.md) · [**한국어**](README_KO.md) · [💬 Discord](https://discord.gg/aRjmJBdK)

 </div>

--- a/docs/lang/README_KO.md
+++ b/docs/lang/README_KO.md
@@ -0,0 +1,260 @@
+<div align="center">
+
+# 동료.skill
+
+> *"너희 AI 개발자들은 코드베이스에 대한 배신자야. 이미 프런트엔드를 망쳐놨고, 이제 백엔드, QA, 운영, 정보 보안, 칩 설계까지, 그리고 결국엔 너희 자신과 인류 전체를 위협하려 드는 거지."*
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE)
+[![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](https://python.org)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-blueviolet)](https://claude.ai/code)
+[![AgentSkills](https://img.shields.io/badge/AgentSkills-Standard-green)](https://agentskills.io)
+
+[![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?logo=discord&logoColor=white)](https://discord.gg/aRjmJBdK)
+
+<br>
+
+동료가 퇴사하면서 관리되지 않은 문서 더미를 남겨두었나요?<br>
+인턴이 빈 책상과 미완성 프로젝트만 남기고 떠났나요?<br>
+멘토가 졸업하면서 그동안 쌓아온 경험과 맥락을 함께 가져갔나요?<br>
+파트너가 다른 팀으로 옮기면서 쌓아온 호흡이 하룻밤 사이에 원점으로 돌아갔나요?<br>
+전임자가 3년 치 업무 내용을 단 3페이지에 욱여넣어 인수인계를 끝내려 했나요?<br>
+
+**차가운 작별을 따뜻한 스킬로 바꿔보세요. 사이버 불멸의 세계에 오신 것을 환영합니다!**
+
+<br>
+
+원본 자료(Feishu 메시지, DingTalk 문서, Slack 메시지, 이메일, 스크린샷)와<br>
+그 사람에 대한 주관적인 설명만 있으면<br>
+**정말 그 사람처럼 일하는 AI 스킬**을 만들 수 있습니다
+
+[지원 데이터 소스](#지원-데이터-소스) · [설치](#설치) · [사용법](#사용법) · [데모](#데모) · [상세 설치](../../INSTALL.md) · [**English**](../../README.md) · [**中文**](README_ZH.md) · [**Español**](README_ES.md) · [**Deutsch**](README_DE.md) · [**日本語**](README_JA.md) · [**Русский**](README_RU.md) · [**Português**](README_PT.md) · [💬 Discord](https://discord.gg/aRjmJBdK)
+
+</div>
+
+---
+
+> 🆕 **2026.04.13 업데이트** — **dot-skill 로드맵이 공개되었습니다!** colleague.skill은 이제 **dot-skill**로 진화하고 있습니다. 더 이상 동료에만 머무르지 않고, 누구든 증류할 수 있는 방향으로 확장됩니다. 멀티모달 출력과 스킬 생태계도 준비 중입니다.
+>
+> 👉 **[전체 로드맵 보기](ROADMAP_KO.md)** · **[💬 Discord](https://discord.gg/aRjmJBdK)**
+>
+> 이슈를 정리했고, 마일스톤과 [공개 프로젝트 보드](https://github.com/users/titanwings/projects/1)도 마련해 두었습니다. 커뮤니티 기여를 환영합니다. `good-first-issue` 라벨도 확인해 보세요.
+
+> 🆕 **2026.04.07 업데이트** — dot-skill 리믹스에 대한 커뮤니티의 반응이 기대 이상이었습니다. 그래서 커뮤니티 갤러리도 만들었습니다. PR도 환영합니다.
+>
+> 어떤 skill이든 meta-skill이든 공유하고, 트래픽을 자신의 GitHub 저장소로 바로 연결할 수 있습니다. 중간 단계는 없습니다.
+>
+> 👉 **[titanwings.github.io/colleague-skill-site](https://titanwings.github.io/colleague-skill-site/)** · **[💬 Discord](https://discord.gg/aRjmJBdK)**
+>
+> 현재 등록된 스킬: 户晨风.skill · 峰哥亡命天涯.skill · 罗翔.skill 외 다수
+
+---
+
+Created by [@titanwings](https://github.com/titanwings) | Powered by Shanghai AI Lab · AI Safety Center
+
+## 지원 데이터 소스
+
+> 아직은 colleague.skill의 베타 버전입니다. 더 많은 데이터 소스를 곧 지원할 예정입니다.
+
+| 소스 | 메시지 | 문서 / 위키 | 스프레드시트 | 비고 |
+|------|:------:|:-----------:|:------------:|------|
+| Feishu (자동) | ✅ API | ✅ | ✅ | 이름만 입력하면 자동 수집 |
+| DingTalk (자동) | ⚠️ 브라우저 | ✅ | ✅ | DingTalk API는 메시지 기록을 지원하지 않음 |
+| Slack (자동) | ✅ API | — | — | 관리자가 Bot을 설치해야 하며, 무료 플랜은 90일 제한 |
+| WeChat 대화 기록 | ✅ SQLite | — | — | 현재는 다소 불안정하므로 아래 오픈소스 도구 사용 권장 |
+| PDF | — | ✅ | — | 수동 업로드 |
+| 이미지 / 스크린샷 | ✅ | — | — | 수동 업로드 |
+| Feishu JSON 내보내기 | ✅ | ✅ | — | 수동 업로드 |
+| 이메일 `.eml` / `.mbox` | ✅ | — | — | 수동 업로드 |
+| Markdown | ✅ | ✅ | — | 수동 업로드 |
+| 텍스트 직접 붙여넣기 | ✅ | — | — | 수동 입력 |
+
+### WeChat 대화 내보내기 추천 도구
+
+아래 도구들은 별도의 오픈소스 프로젝트입니다. 이 저장소에 해당 코드가 포함되어 있지는 않지만, 본 프로젝트의 파서는 이들이 내보내는 형식과 호환됩니다. 현재 WeChat 자동 복호화는 다소 불안정하므로, 아래 도구로 대화 기록을 먼저 내보낸 뒤 이 프로젝트로 가져오는 방식을 권장합니다.
+
+| 도구 | 플랫폼 | 설명 |
+|------|--------|------|
+| [WeChatMsg](https://github.com/LC044/WeChatMsg) | Windows | WeChat 대화 기록 내보내기, 여러 형식 지원 |
+| [PyWxDump](https://github.com/xaoyaoo/PyWxDump) | Windows | WeChat 데이터베이스 복호화 및 내보내기 |
+| [留痕 (Liuhen)](https://github.com/greyovo/留痕) | macOS | WeChat 대화 기록 내보내기 (Mac 사용자 권장) |
+
+> 도구 추천: [@therealXiaomanChu](https://github.com/therealXiaomanChu). 모든 오픈소스 작성자분들께 감사드립니다. 함께 사이버 불멸을 향해 갑시다.
+
+---
+
+## 설치
+
+### Claude Code
+
+> **중요**: Claude Code는 **git 저장소 루트**의 `.claude/skills/`에서 skill을 찾습니다. 반드시 올바른 위치에서 실행하세요.
+
+```bash
+# 현재 프로젝트에 설치 (git 저장소 루트에서 실행)
+mkdir -p .claude/skills
+git clone https://github.com/titanwings/colleague-skill .claude/skills/create-colleague
+
+# 또는 전역 설치 (모든 프로젝트에서 사용 가능)
+git clone https://github.com/titanwings/colleague-skill ~/.claude/skills/create-colleague
+```
+
+### OpenClaw
+
+```bash
+git clone https://github.com/titanwings/colleague-skill ~/.openclaw/workspace/skills/create-colleague
+```
+
+### 의존성 (선택 사항)
+
+```bash
+pip3 install -r requirements.txt
+```
+
+> Feishu/DingTalk/Slack 자동 수집에는 앱 자격 증명이 필요합니다. 자세한 내용은 [INSTALL.md](../../INSTALL.md)를 참고하세요.
+
+---
+
+## 사용법
+
+Claude Code에서 다음 명령을 입력하세요:
+
+```
+/create-colleague
+```
+
+프롬프트에 따라 별칭, 회사/레벨(예: `ByteDance L2-1 백엔드 엔지니어`), 성격 태그를 입력하고 데이터 소스를 선택하면 됩니다. 모든 항목은 건너뛸 수 있고, 설명만으로도 스킬을 생성할 수 있습니다.
+
+생성이 끝나면 `/{slug}`로 동료 스킬을 호출하세요.
+
+### 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `/list-colleagues` | 생성된 모든 동료 스킬 목록 보기 |
+| `/{slug}` | 전체 스킬 호출 (Persona + Work) |
+| `/{slug}-work` | 업무 역량만 사용 |
+| `/{slug}-persona` | Persona만 사용 |
+| `/colleague-rollback {slug} {version}` | 이전 버전으로 롤백 |
+| `/delete-colleague {slug}` | 삭제 |
+
+---
+
+## 데모
+
+> 입력: `ByteDance L2-1 백엔드 엔지니어, INTJ, 책임전가형, ByteDance 스타일`
+
+**시나리오 1: 코드 리뷰**
+
+```
+사용자          ❯ 이 API 설계 좀 리뷰해줄래?
+
+동료.skill      ❯ 잠깐, 영향 범위가 뭐야? 맥락 설명이 없잖아.
+                 (읽은 뒤) N+1 쿼리네. 고쳐.
+                 응답은 표준 {code, message, data} 형식으로 가.
+                 그게 스펙이야. 이유는 묻지 마.
+```
+
+**시나리오 2: 책임 공방**
+
+```
+사용자          ❯ 이 버그, 네가 넣은 거 맞지?
+
+동료.skill      ❯ 타임라인이 맞아? 그 기능은 여러 군데를 건드렸고,
+                 다른 변경도 있었잖아.
+```
+
+---
+
+## 기능
+
+### 생성되는 Skill 구조
+
+각 동료 스킬은 서로 맞물려 작동하는 두 부분으로 구성됩니다.
+
+| 파트 | 내용 |
+|------|------|
+| **Part A — Work Skill** | 담당 시스템, 기술 표준, 워크플로, 경험 기반 지식 |
+| **Part B — Persona** | 5단계 성격 구조: 하드 룰 → 정체성 → 표현 방식 → 의사결정 → 대인관계 |
+
+실행 흐름: `작업 수신 → Persona가 태도 결정 → Work Skill 실행 → 그 사람의 말투로 출력`
+
+### 지원 태그
+
+**성격**: 책임감 강함 · 책임전가형 · 완벽주의 · 적당주의 · 미루기 장인 · PUA 고수 · 사내 정치형 · 상사 관리 달인 · 수동공격형 · 우유부단 · 과묵형 · 읽씹형 …
+
+**조직 문화**: ByteDance 스타일 · Alibaba 스타일 · Tencent 스타일 · Huawei 스타일 · Baidu 스타일 · Meituan 스타일 · 원칙주의 · OKR 집착형 · 대기업 프로세스형 · 스타트업 모드
+
+**레벨**: ByteDance 2-1~3-3+ · Alibaba P5~P11 · Tencent T1~T4 · Baidu T5~T9 · Meituan P4~P8 · Huawei 13~21 · NetEase · JD · Xiaomi …
+
+### 진화 방식
+
+- **파일 추가** → 변경 내용을 자동 분석해 관련 섹션에 병합하고, 기존 결론은 덮어쓰지 않음
+- **대화 기반 수정** → "그 사람은 이렇게 안 해, xxx여야 해"라고 말하면 Correction 레이어에 기록되어 즉시 반영
+- **버전 관리** → 업데이트할 때마다 자동 아카이브, 과거 어느 버전으로든 롤백 가능
+
+---
+
+## 프로젝트 구조
+
+이 프로젝트는 [AgentSkills](https://agentskills.io) 오픈 표준을 따릅니다. 저장소 전체가 하나의 skill 디렉터리로 구성되어 있습니다.
+
+```
+create-colleague/
+├── SKILL.md              # Skill 진입점 (공식 frontmatter)
+├── prompts/              # 프롬프트 템플릿
+│   ├── intake.md         #   대화형 정보 수집
+│   ├── work_analyzer.md  #   업무 역량 추출
+│   ├── persona_analyzer.md #  성격 추출 (태그 변환 포함)
+│   ├── work_builder.md   #   work.md 생성 템플릿
+│   ├── persona_builder.md #   persona.md 5단계 구조
+│   ├── merger.md         #   증분 병합 로직
+│   └── correction_handler.md # 대화 수정 처리기
+├── tools/                # Python 도구
+│   ├── feishu_auto_collector.py  # Feishu 자동 수집기
+│   ├── feishu_browser.py         # Feishu 브라우저 방식
+│   ├── feishu_mcp_client.py      # Feishu MCP 방식
+│   ├── dingtalk_auto_collector.py # DingTalk 자동 수집기
+│   ├── slack_auto_collector.py   # Slack 자동 수집기
+│   ├── email_parser.py           # 이메일 파서
+│   ├── skill_writer.py           # Skill 파일 관리
+│   └── version_manager.py        # 버전 아카이브 및 롤백
+├── colleagues/           # 생성된 colleague 스킬들 (gitignored)
+├── docs/PRD.md
+├── requirements.txt
+└── LICENSE
+```
+
+---
+
+## 참고 사항
+
+- **소스 자료의 품질 = 스킬의 품질**: 채팅 로그 + 긴 문서 > 수동 설명만 있는 경우
+- 우선 수집 권장 순서: **본인이 직접 쓴** 장문 > **의사결정이 드러나는 답변** > 일상 대화
+- Feishu 자동 수집을 쓰려면 관련 그룹 채팅에 앱 봇을 추가해야 합니다
+- 아직 데모 버전입니다. 버그를 발견하면 이슈를 등록해 주세요
+
+---
+### 📄 기술 보고서
+
+> **[Colleague.Skill: Automated AI Skill Generation via Expert Knowledge Distillation](../../colleague_skill.pdf)**
+>
+> colleague.skill의 시스템 설계를 정리한 논문도 공개했습니다. 2단 구조(Work Skill + Persona), 멀티소스 데이터 수집, 스킬 생성 및 진화 메커니즘, 실제 시나리오 평가 결과까지 담고 있습니다. 관심 있다면 읽어보세요.
+
+---
+
+## Star History
+
+<a href="https://www.star-history.com/?repos=titanwings%2Fcolleague-skill&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/image?repos=titanwings/colleague-skill&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/image?repos=titanwings/colleague-skill&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/image?repos=titanwings/colleague-skill&type=date&legend=top-left" />
+ </picture>
+</a>
+
+---
+
+<div align="center">
+
+MIT License © [titanwings](https://github.com/titanwings)
+
+</div>
--- a/docs/lang/README_PT.md
+++ b/docs/lang/README_PT.md
@@ -27,7 +27,7 @@ Forneça materiais fonte (mensagens do Slack, docs do Confluence, emails, screen
 mais a sua descrição subjetiva da pessoa<br>
 e receba um **AI Skill que realmente trabalha como ela**

-[Fontes de dados](#fontes-de-dados-suportadas) · [Instalação](#instalação) · [Uso](#uso) · [Demo](#demo) · [Instalação detalhada](../../INSTALL.md) · [**中文**](README_ZH.md) · [**English**](../../README.md) · [💬 Discord](https://discord.gg/aRjmJBdK)
+[Fontes de dados](#fontes-de-dados-suportadas) · [Instalação](#instalação) · [Uso](#uso) · [Demo](#demo) · [Instalação detalhada](../../INSTALL.md) · [**中文**](README_ZH.md) · [**English**](../../README.md) · [**한국어**](README_KO.md) · [💬 Discord](https://discord.gg/aRjmJBdK)

 </div>

--- a/docs/lang/README_RU.md
+++ b/docs/lang/README_RU.md
@@ -27,7 +27,7 @@
 плюс своё субъективное описание человека<br>
 и получи **AI Skill, который действительно работает как он**

-[Источники данных](#поддерживаемые-источники-данных) · [Установка](#установка) · [Использование](#использование) · [Демо](#демо) · [Подробная установка](../../INSTALL.md) · [**中文**](README_ZH.md) · [**English**](../../README.md) · [💬 Discord](https://discord.gg/aRjmJBdK)
+[Источники данных](#поддерживаемые-источники-данных) · [Установка](#установка) · [Использование](#использование) · [Демо](#демо) · [Подробная установка](../../INSTALL.md) · [**中文**](README_ZH.md) · [**English**](../../README.md) · [**한국어**](README_KO.md) · [💬 Discord](https://discord.gg/aRjmJBdK)

 </div>

--- a/docs/lang/README_ZH.md
+++ b/docs/lang/README_ZH.md
@@ -29,7 +29,7 @@

 [数据来源](#支持的数据来源) · [安装](#安装) · [使用](#使用) · [效果示例](#效果示例) · [详细安装说明](../../INSTALL.md) · [💬 Discord](https://discord.gg/aRjmJBdK)

-[**English**](../../README.md) · [**Español**](README_ES.md) · [**Deutsch**](README_DE.md) · [**日本語**](README_JA.md) · [**Русский**](README_RU.md) · [**Português**](README_PT.md)
+[**English**](../../README.md) · [**Español**](README_ES.md) · [**Deutsch**](README_DE.md) · [**日本語**](README_JA.md) · [**Русский**](README_RU.md) · [**Português**](README_PT.md) · [**한국어**](README_KO.md)

 </div>

@@ -271,4 +271,3 @@ MIT License © [titanwings](https://github.com/titanwings)

 </div>

-
--- a/docs/lang/ROADMAP_DE.md
+++ b/docs/lang/ROADMAP_DE.md
@@ -21,7 +21,7 @@ Jeder kann zu einem `.skill` werden.

 *Zuletzt aktualisiert: 2026-04-13*

-[**English**](../../ROADMAP.md) · [**中文**](ROADMAP_ZH.md) · [**Español**](ROADMAP_ES.md) · [**日本語**](ROADMAP_JA.md) · [**Русский**](ROADMAP_RU.md) · [**Português**](ROADMAP_PT.md)
+[**English**](../../ROADMAP.md) · [**中文**](ROADMAP_ZH.md) · [**Español**](ROADMAP_ES.md) · [**日本語**](ROADMAP_JA.md) · [**Русский**](ROADMAP_RU.md) · [**Português**](ROADMAP_PT.md) · [**한국어**](ROADMAP_KO.md)

 </div>

--- a/docs/lang/ROADMAP_ES.md
+++ b/docs/lang/ROADMAP_ES.md
@@ -21,7 +21,7 @@ Cualquiera puede convertirse en un `.skill`.

 *Última actualización: 2026-04-13*

-[**English**](../../ROADMAP.md) · [**中文**](ROADMAP_ZH.md) · [**Deutsch**](ROADMAP_DE.md) · [**日本語**](ROADMAP_JA.md) · [**Русский**](ROADMAP_RU.md) · [**Português**](ROADMAP_PT.md)
+[**English**](../../ROADMAP.md) · [**中文**](ROADMAP_ZH.md) · [**Deutsch**](ROADMAP_DE.md) · [**日本語**](ROADMAP_JA.md) · [**Русский**](ROADMAP_RU.md) · [**Português**](ROADMAP_PT.md) · [**한국어**](ROADMAP_KO.md)

 </div>

--- a/docs/lang/ROADMAP_JA.md
+++ b/docs/lang/ROADMAP_JA.md
@@ -21,7 +21,7 @@

 *最終更新：2026-04-13*

-[**English**](../../ROADMAP.md) · [**中文**](ROADMAP_ZH.md) · [**Español**](ROADMAP_ES.md) · [**Deutsch**](ROADMAP_DE.md) · [**Русский**](ROADMAP_RU.md) · [**Português**](ROADMAP_PT.md)
+[**English**](../../ROADMAP.md) · [**中文**](ROADMAP_ZH.md) · [**Español**](ROADMAP_ES.md) · [**Deutsch**](ROADMAP_DE.md) · [**Русский**](ROADMAP_RU.md) · [**Português**](ROADMAP_PT.md) · [**한국어**](ROADMAP_KO.md)

 </div>

--- a/docs/lang/ROADMAP_KO.md
+++ b/docs/lang/ROADMAP_KO.md
@@ -0,0 +1,148 @@
+<div align="center">
+
+# dot-skill 로드맵
+
+### colleague.skill에서 dot-skill로 — 누구나 AI 스킬로 증류하기
+
+<br>
+
+우리는 아주 단순한 질문에서 시작했습니다. **동료가 떠나면, 그 사람의 지식도 함께 사라진다. 그걸 남길 방법은 없을까?**
+
+2주 만에 13,000명이 넘는 사람들이 그 질문에 답을 보여줬습니다.
+
+하지만 커뮤니티는 이 프로젝트가 동료에게만 머무르지 않는다는 것도 보여줬습니다.
+교수, 전 연인, 자기 자신, 심지어 가상의 캐릭터까지 증류하고 있었으니까요.
+
+**그래서 우리는 colleague.skill을 dot-skill로 확장하기로 했습니다.**
+
+누구나 하나의 `.skill`이 될 수 있습니다.
+
+<br>
+
+*최종 업데이트: 2026-04-13*
+
+[**English**](../../ROADMAP.md) · [**中文**](ROADMAP_ZH.md) · [**Español**](ROADMAP_ES.md) · [**Deutsch**](ROADMAP_DE.md) · [**日本語**](ROADMAP_JA.md) · [**Русский**](ROADMAP_RU.md) · [**Português**](ROADMAP_PT.md)
+
+</div>
+
+---
+
+## 완료된 것들 (v1.0)
+
+| 기능 | 상태 |
+|------|:----:|
+| `/create-colleague` 전체 생성 워크플로우 | 완료 |
+| Feishu 자동 수집 (메시지 + 문서 + 스프레드시트) | 완료 |
+| DingTalk 자동 수집 | 완료 |
+| Slack 자동 수집 | 완료 |
+| WeChat 대화 기록 (SQLite 내보내기) | 완료 |
+| 이메일 / PDF / 이미지 / Markdown 가져오기 | 완료 |
+| Work Skill + Persona 이중 아키텍처 | 완료 |
+| 대화 기반 수정 및 점진적 진화 | 완료 |
+| 버전 관리 및 롤백 | 완료 |
+| 99개 이상의 스킬이 올라온 [커뮤니티 갤러리](https://titanwings.github.io/colleague-skill-site/) | 완료 |
+
+---
+
+## 다음 단계
+
+### Phase 1 — 커뮤니티 구축
+
+> 13k 스타가 단순한 숫자로만 남아서는 안 됩니다. 모두가 이 프로젝트에 참여할 수 있어야 합니다.
+
+**앞으로 보게 될 것들:**
+
+- **GitHub Discussions** — 더 이상 Issues에서 대화를 이어가지 않고, 전용 토론 공간을 운영
+- **`CONTRIBUTING.md`** — 처음 기여하는 사람도 따라오기 쉬운 명확한 가이드
+- **`good-first-issue` 라벨** — 신규 기여자를 위한 입문용 작업
+- **v1.0.0 공식 릴리스** — 더 이상 "main만 pull 해서 쓰는 상태"가 아니라, 첫 정식 버전 릴리스를 제공
+- **공개 로드맵 보드** — 지금 읽고 있는 문서와 별도로 GitHub Projects 기반의 라이브 보드도 제공
+
+**도울 수 있는 일:** 문서 번역, .skill 제출, Windows 테스트, 이슈 트리아지
+
+---
+
+### Phase 2 — dot-skill: 동료를 넘어서
+
+> colleague.skill이 시작이었다면, dot-skill은 그 다음 단계입니다.
+
+**핵심 변화:**
+
+- **`/create-skill` 범용 진입점** — 더 이상 "동료 만들기"에 한정되지 않고 누구든 증류 가능
+  - `/create-colleague`는 동료, 멘토, 인턴용
+  - `/create-ex`는 전 연인, 옛 친구, 끊긴 관계용
+  - `/create-icon`은 유명인, 역사적 인물용
+  - 혹은... 자기 자신을 증류
+- **갤러리 카테고리 확장** — Colleague / Celebrity / Relationship / Character / Self / Meta-Skill 형태로 나눠 탐색 가능
+- **더 다양한 데이터 소스**
+  - WeCom (기업용 WeChat) 지원
+  - iMessage 자동 읽기
+  - Windows 호환성 개선
+
+**도울 수 있는 일:** 원하는 인물 유형 제안, 새 데이터 소스 수집기 개발, 갤러리 디자인 논의 참여
+
+---
+
+### Phase 3 — 스킬 생태계
+
+> 한 사람이 스킬이 될 수 있다면, 여러 사람은 팀이 될 수 있을까요?
+
+**우리가 탐색 중인 것들:**
+
+- **멀티 스킬 협업** — `/meeting @zhangsan @lisi @wangwu`처럼 세 페르소나가 한 주제를 함께 토론
+- **관계 그래프** — 누가 누구와 잘 맞고, 어디에 긴장이 있는지 같은 페르소나 간 관계를 정의
+- **원클릭 설치** — 커뮤니티 스킬을 플러그인처럼 설치
+- **능동적 진화** — 스킬이 주기적으로 새 데이터 소스를 흡수해 최신 상태 유지
+
+**도울 수 있는 일:** 이상적인 스킬 조합 시나리오 제안, 배포 메커니즘 설계 논의 참여
+
+---
+
+### Phase 4 — 멀티모달: 그들을 살아 있게 만들기
+
+> 지금의 .skill은 말만 할 수 있습니다. 사진을 보내고, 스티커를 쓰고, 그 사람 목소리로 이야기하고, 언젠가는 영상까지 만들게 하고 싶습니다.
+
+**1단계: 시각 표현**
+- 대화 중 페르소나 스타일의 스티커와 밈을 자동 전송
+- 그 사람 스타일의 "일상 사진" 생성 — 오늘 그 사람이라면 무엇을 올릴까?
+- 각 스킬마다 전용 스티커 팩과 이미지 자산 제공
+
+**2단계: 음성**
+- 그 사람의 목소리로 말하기 — 회의 녹음이나 음성 메시지를 바탕으로 클론
+- 채팅에 음성 답변 직접 전송
+
+**3단계: 영상 (탐색 단계)**
+- "그 사람의 하루" 같은 숏폼 생성
+- 디지털 휴먼 / 애니메이션 아바타
+
+**도울 수 있는 일:** 멀티모달 활용 사례 공유, 스티커 에셋 기여, 음성 클로닝 테스트
+
+---
+
+## 참여하기
+
+| 방법 | 위치 |
+|------|------|
+| .skill 제출 | [Gallery PR](https://titanwings.github.io/colleague-skill-site/) |
+| 토론 및 제안 | [GitHub Discussions](https://github.com/titanwings/colleague-skill/discussions) (곧 공개) |
+| 실시간 채팅 | [Discord](https://discord.gg/aRjmJBdK) |
+| 버그 제보 | [Issue](https://github.com/titanwings/colleague-skill/issues/new) |
+| 코드 기여 | `good-first-issue` 라벨을 찾거나 바로 PR 열기 |
+
+**특히 필요한 분들:**
+- Windows 사용자 — 호환성 문제 테스트 및 수정 도움
+- 다국어 사용자 — 문서 번역 도움
+- 데이터 소스 개발자 — 새로운 수집기 개발 (WeCom, Notion, Google Docs...)
+- 디자이너 — 갤러리와 웹사이트에 감각이 필요합니다
+
+---
+
+<div align="center">
+
+**이 로드맵은 커뮤니티와 함께 만들어갑니다. 우선순위는 여러분의 피드백에 따라 달라집니다.**
+
+아이디어가 있다면 [Discord](https://discord.gg/aRjmJBdK)에 들르거나 Discussion을 시작해 주세요.
+
+모든 `.skill`은 계속 이어지는 관계의 또 다른 형태입니다.
+
+</div>
--- a/docs/lang/ROADMAP_PT.md
+++ b/docs/lang/ROADMAP_PT.md
@@ -21,7 +21,7 @@ Qualquer pessoa pode se tornar um `.skill`.

 *Ultima atualizacao: 2026-04-13*

-[**English**](../../ROADMAP.md) · [**中文**](ROADMAP_ZH.md) · [**Español**](ROADMAP_ES.md) · [**Deutsch**](ROADMAP_DE.md) · [**日本語**](ROADMAP_JA.md) · [**Русский**](ROADMAP_RU.md)
+[**English**](../../ROADMAP.md) · [**中文**](ROADMAP_ZH.md) · [**Español**](ROADMAP_ES.md) · [**Deutsch**](ROADMAP_DE.md) · [**日本語**](ROADMAP_JA.md) · [**Русский**](ROADMAP_RU.md) · [**한국어**](ROADMAP_KO.md)

 </div>

--- a/docs/lang/ROADMAP_RU.md
+++ b/docs/lang/ROADMAP_RU.md
@@ -21,7 +21,7 @@

 *Последнее обновление: 2026-04-13*

-[**English**](../../ROADMAP.md) · [**中文**](ROADMAP_ZH.md) · [**Español**](ROADMAP_ES.md) · [**Deutsch**](ROADMAP_DE.md) · [**日本語**](ROADMAP_JA.md) · [**Português**](ROADMAP_PT.md)
+[**English**](../../ROADMAP.md) · [**中文**](ROADMAP_ZH.md) · [**Español**](ROADMAP_ES.md) · [**Deutsch**](ROADMAP_DE.md) · [**日本語**](ROADMAP_JA.md) · [**Português**](ROADMAP_PT.md) · [**한국어**](ROADMAP_KO.md)

 </div>

--- a/docs/lang/ROADMAP_ZH.md
+++ b/docs/lang/ROADMAP_ZH.md
@@ -21,7 +21,7 @@

 *最后更新：2026-04-13*

-[**English**](../../ROADMAP.md) · [**Español**](ROADMAP_ES.md) · [**Deutsch**](ROADMAP_DE.md) · [**日本語**](ROADMAP_JA.md) · [**Русский**](ROADMAP_RU.md) · [**Português**](ROADMAP_PT.md)
+[**English**](../../ROADMAP.md) · [**Español**](ROADMAP_ES.md) · [**Deutsch**](ROADMAP_DE.md) · [**日本語**](ROADMAP_JA.md) · [**Русский**](ROADMAP_RU.md) · [**Português**](ROADMAP_PT.md) · [**한국어**](ROADMAP_KO.md)

 </div>