titanwings / distilly

titanwings/distilly

open_in_new前往仓库

将冰冷的离别化为温暖的技能，开启数字生命1.0时代，欢迎加入重生纪元。

项目概览

项目概述

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 目录、克隆仓库并注册入口。

手动安装：

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 仓库 README、docs/PRD.md、docs/SKILL_TYPE_ABSTRACTION_DESIGN.md、docs/lang/ 下的多语言文档、CONTRIBUTING.md。
  • 分析时间：2026-06-01（基于仓库内最新更新日期）。