## 项目概述

**dot-skill（同事.skill）** 是一个基于 Python 的开源项目，旨在将任何人的知识、性格和沟通风格蒸馏成可运行的 AI Skill。项目最初专注于同事场景，现已扩展为支持同事、亲密关系、名人/公众人物三大类人物。用户通过提供原材料（聊天记录、文档、邮件等）和描述，即可生成一个能够以目标人物方式思考和回答的 AI 助手。项目遵循 AgentSkills 开放标准，整个仓库即一个 skill 目录，支持在 Claude Code、Hermes Agent、OpenClaw、Codex 等多个 Agent 宿主中运行。

## 核心功能

- **人物蒸馏**：支持同事、亲密关系、名人三大类人物，通过原材料和描述生成个性化 AI Skill。
- **双层架构**：生成的 Skill 包含 Work Skill（工作能力）和 Persona（人物性格）两部分，可独立或组合使用。
- **多数据源采集**：支持飞书、钉钉、Slack 自动采集，以及微信聊天记录、PDF、图片、邮件、Markdown 等手动导入。
- **进化机制**：支持追加文件增量合并、对话纠正即时生效、版本管理与回滚。
- **名人研究工具链**：内置字幕下载、文稿清洗、六维度研究合并、质量检查等工具。
- **多宿主兼容**：支持 Claude Code、Hermes Agent、OpenClaw、Codex 四种 Agent 宿主。

## 适用与不适用场景

**适用场景：**
- 同事离职、导师毕业、搭档转岗后，希望保留其工作方法和上下文。
- 希望与家人、老友、伴侣的相处方式得以延续。
- 对偶像、名人、历史人物感兴趣，希望模拟其思考方式。
- 需要创建个性化 AI 助手，用于工作辅助或情感陪伴。

**不适用场景：**
- 需要实时、准确的事实性信息查询（生成的 Skill 基于历史数据，可能过时）。
- 需要处理敏感或隐私数据，且未获得相关授权。
- 需要完全替代真实人际交往或专业咨询。
- 需要高精度、低延迟的自动化任务执行（当前为 demo 版本）。

## 技术架构与依赖

- **语言**：Python 3.9+。
- **标准**：遵循 AgentSkills 开放标准。
- **架构**：以 Persona 为通用底座，按家族挂载 Work Skill、研究档案等模块。
- **依赖**：仓库资料未提供具体依赖列表，但根据文档，可能涉及飞书、钉钉、Slack API 客户端，以及 PDF、邮件解析等库。
- **工具**：包含多个 Python 脚本，如 `skill_writer.py`、`version_manager.py`、`feishu_auto_collector.py` 等。

## 安装与快速开始

**自动安装（推荐）：**
在支持的 Agent 宿主（如 Claude Code）中，输入以下指令：

> 帮我安装 dot-skill 这个 skill：`https://github.com/titanwings/colleague-skill`

Agent 会自动识别宿主 skills 目录、克隆仓库并注册入口。

**手动安装：**

```bash
git clone https://github.com/titanwings/colleague-skill <TARGET>
```

其中 `<TARGET>` 根据宿主不同而异：
- Claude Code: `~/.claude/skills/dot-skill`
- OpenClaw: `~/.openclaw/workspace/skills/dot-skill`
- Codex: `~/.codex/skills/dot-skill`
- Hermes: 克隆后运行 `python3 tools/install_hermes_skill.py --force`

安装完成后，在宿主中输入 `/dot-skill` 启动。

## 典型使用方法

1. 启动 `/dot-skill`，选择蒸馏类型（colleague / relationship / celebrity）。
2. 输入花名、基础信息、性格标签，选择数据来源（可跳过部分字段）。
3. 系统自动分析原材料，生成 Work Skill 和 Persona。
4. 使用 `/{character}-{slug}` 调用完整 Skill，或使用 `/{character}-{slug}-work`、`/{character}-{slug}-persona` 分别调用。
5. 通过追加文件或对话纠正持续进化 Skill。

**示例：**
- 蒸馏一个字节 2-1 后端：输入 `字节 2-1 后端工程师，INTJ，甩锅高手，字节范`，即可生成模拟该同事风格的 Skill。
- 蒸馏名人：使用内置研究工具链，从字幕、访谈等材料生成名人 Skill。

## 配置与部署要点

- **飞书/钉钉自动采集**：需要配置 API 凭证，并将 App bot 加入相关群聊。
- **Slack 自动采集**：需要管理员安装 Bot，免费版限制 90 天。
- **微信聊天记录**：需先用 WeChatMsg / PyWxDump / 留痕等工具导出 SQLite 文件。
- **Windows 兼容性**：部分功能可能需要特殊处理，详见 INSTALL.md。
- **版本管理**：每次更新自动存档，支持回滚到任意历史版本（保留最近 10 个版本）。
- **Correction 层**：最多保留 50 条，超出后合并归纳。

## 限制、风险与许可证

- **限制**：当前为 demo 版本，可能存在 bug；原材料质量直接影响 Skill 质量；部分数据源（如钉钉）不支持历史消息自动采集。
- **风险**：涉及个人隐私数据，需确保授权；生成的 Skill 可能产生不准确或不当的回复；多模态功能（照片、语音、视频）仍在规划中。
- **许可证**：MIT License。

## 官方链接

- GitHub 仓库：https://github.com/titanwings/colleague-skill
- 社区 Gallery：https://titanwings.github.io/colleague-skill-site/
- Discord 社区：https://discord.gg/NVX66RxWZv
- 技术报告：https://arxiv.org/abs/2605.31264

## 信息来源和分析时间

- 信息来源：GitHub 仓库 README、docs/PRD.md、docs/SKILL_TYPE_ABSTRACTION_DESIGN.md、docs/lang/ 下的多语言文档、CONTRIBUTING.md。
- 分析时间：2026-06-01（基于仓库内最新更新日期）。