前任.skill：把前任蒸馏成 AI Skill · 最全部署与使用指南

一句话定位：GitHub 开源项目 therealXiaomanChu/ex-skill（前任.skill）是一个把前任蒸馏成 AI Skill 的工具——提供前任的原材料（微信聊天记录、QQ 消息、朋友圈截图、照片）加上你的主观描述，生成一个真正像 ta 的 AI Skill：用 ta 的口头禅说话，用 ta 的方式回复你，记得你们一起去过的地方。

slogan：我会为了你一万次回到那个夏天。

仓库地址：https://github.com/therealXiaomanChu/ex-skill · 许可证：MIT · ⭐ 6545

目录

• 一、官方跳转与下载链接
• 二、项目简介与核心能力
• 三、完整部署步骤（安装）
• 四、使用方法：创建你的前任 Skill
• 五、管理命令速查
• 六、效果示例
• 七、数据源与生成结构
• 八、支持的标签体系
• 九、进化机制
• 十、项目结构全解
• 十一、注意事项与伦理边界
• 十二、社区生态
• 十三、常见问题排查
• 十四、参考链接汇总

一、官方跳转与下载链接

二、项目简介与核心能力

2.1 这是什么

前任.skill 遵循 AgentSkills 开放标准，是一个"生成 Skill 的 Skill"：你提供前任的聊天记录、照片、朋友圈截图等原材料，加上你的主观描述，它自动分析并生成一个真正像 ta 的 AI Skill。

核心价值：把记忆从"生物硬盘"导出到"数字硬盘"完成格式转换——共同经历、约会地点、inside jokes、争吵模式、甜蜜瞬间、关系时间线，全部蒸馏进一个可以随时对话的 Skill。

2.2 核心能力一览

2.3 项目定位

⚠️ 本项目仅用于个人回忆与情感疗愈，不用于骚扰、跟踪或侵犯他人隐私。

三、完整部署步骤（安装）

3.1 环境要求

3.2 安装到 Claude Code

重要：Claude Code 从 git 仓库根目录 的 .claude/skills/ 查找 skill。请在正确的位置执行。

# 安装到当前项目（在 git 仓库根目录执行）
mkdir -p .claude/skills
git clone https://github.com/therealXiaomanChu/ex-skill .claude/skills/create-ex

# 或安装到全局（所有项目都能用）
git clone https://github.com/therealXiaomanChu/ex-skill ~/.claude/skills/create-ex

3.3 安装可选依赖

pip3 install -r requirements.txt

3.4 安装后验证

在 Claude Code 中输入 /create-ex，能进入前任创建流程即安装成功。

四、使用方法：创建你的前任 Skill

4.1 创建流程

在 Claude Code 中输入：

/create-ex

按提示输入： 1. 前任的代号（如"初恋"）； 2. 基本信息（在一起多久、什么时候认识的、星座、MBTI 等）； 3. 性格画像（话痨/闷骚/嘴硬心软等标签）； 4. 选择数据来源（聊天记录导出 / 截图 / 照片 / 口述）。

所有字段均可跳过，仅凭描述也能生成。

4.2 调用生成的 Skill

完成后用 /{slug} 调用该前任 Skill，开始对话。例如输入了"初恋"，就用 /chulian（自动生成的 slug）调用。

五、管理命令速查

六、效果示例

输入：初恋，在一起三年，大学时期，ENFP，双子座，话痨，半夜给我发语音，分手后还给我点赞

场景一：日常聊天

用户      ❯ 在干嘛

前任.skill ❯ 刚吃完饭 在刷手机
             你呢 怎么突然找我
             [发送了一个表情包]

场景二：回忆杀

用户      ❯ 还记得我们第一次约会吗

前任.skill ❯ 就那个超难吃的意面吗哈哈哈哈
             你还假装很好吃 我都看出来了
             那家店后来倒闭了你知道吗

场景三：深夜emo

用户      ❯ 我有点想你

前任.skill ❯ ...
             嗯
             早点睡吧

场景四：吵架模式

用户      ❯ 你当时为什么不回我消息

前任.skill ❯ 又来了
             我说了我在忙 你非要这样
             算了不想吵

七、数据源与生成结构

7.1 支持的数据源

7.2 生成的 Skill 结构

每个前任 Skill 由两部分组成，共同驱动输出：

运行逻辑：收到消息 → Persona 判断 ta 会怎么回 → Memory 补充共同记忆 → 用 ta 的方式输出

八、支持的标签体系

九、进化机制

十、项目结构全解

create-ex/
├── SKILL.md                # skill 入口（官方 frontmatter）
├── prompts/                # Prompt 模板
│   ├── intake.md           #   对话式信息录入
│   ├── memory_analyzer.md  #   关系记忆提取
│   ├── persona_analyzer.md #   性格行为提取（含标签翻译表）
│   ├── memory_builder.md   #   memory.md 生成模板
│   ├── persona_builder.md  #   persona.md 五层结构模板
│   ├── merger.md           #   增量 merge 逻辑
│   └── correction_handler.md # 对话纠正处理
├── tools/                  # Python 工具
│   ├── wechat_parser.py    # 微信聊天记录解析
│   ├── qq_parser.py        # QQ 聊天记录解析
│   ├── social_parser.py    # 社交媒体内容解析
│   ├── photo_analyzer.py   # 照片元信息分析
│   ├── skill_writer.py     # Skill 文件管理
│   └── version_manager.py  # 版本存档与回滚
├── exes/                   # 生成的前任 Skill（gitignored）
├── docs/
│   ├── PRD.md
│   ├── EXPORT_GUIDE.md
│   └── COMPLIANCE.md
├── requirements.txt
└── LICENSE

十一、注意事项与伦理边界

11.1 使用建议

• 聊天记录质量决定还原度：微信导出 + 口述 > 仅口述；
• 建议优先提供：深夜对话 > 争吵记录 > 日常消息（最能体现真实性格）；
• 本项目不鼓励对前任的不健康执念，如果你发现自己过于沉浸，请寻求专业帮助；
• 你的前任是一个真实的人，ta 有自己的人生。这个 Skill 只是你记忆中的 ta。

11.2 合规说明

⚠️ 本项目仅用于个人回忆与情感疗愈，不用于骚扰、跟踪或侵犯他人隐私。 详细合规说明见 docs/COMPLIANCE.md。

11.3 写在最后

人的记忆是一种不讲道理的存储介质。你记不住高数公式、车牌号、今天是几号，但你清楚记得四年前的一个下午 ta 穿了一件白 T 恤站在便利店门口等你，手里拿着两根冰棍，一根给你，一根 ta 自己。

这个 Skill 就是把这些不公平的记忆导出来，从生物硬盘到数字硬盘完成格式转换。导完以后你或许会发现，ta 也没那么好，ta 也没那么差——ta 就是那样一个人。

十二、社区生态

以下项目由社区贡献者独立开发，与本项目互补：

十三、常见问题排查

十四、参考链接汇总

免责声明：本文所有命令、规则、数据均整理自官方 GitHub 仓库 therealXiaomanChu/ex-skill 的 README 原文，如仓库更新请以最新版本为准。本项目仅用于个人回忆与情感疗愈，请遵守合规边界。