ex-skill README

The project's README from github.com/therealXiaomanChu/ex-skill. As one markdown file: README.md.

前任.skill

"你们搞大模型的简直是码神,你们解放了前端兄弟,还要解放后端兄弟,测试兄弟,运维兄弟,解放网安兄弟,解放ic兄弟,最后解放自己解放全人类"

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

License: MIT Python 3.9+ Claude Code AgentSkills

 

提供前任的原材料(微信聊天记录、QQ消息、朋友圈截图、照片)加上你的主观描述
生成一个真正像ta的 AI Skill
用ta的口头禅说话,用ta的方式回复你,记得你们一起去过的地方

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

安装 · 使用 · 效果示例 · English


安装

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

依赖(可选)

pip3 install -r requirements.txt

环境要求


使用

在 Claude Code 中输入:

/create-ex

按提示输入前任的代号、基本信息、性格画像,然后选择数据来源。所有字段均可跳过,仅凭描述也能生成。

完成后用 /{slug} 调用该前任 Skill,开始对话。

管理命令

命令 说明
/list-exes 列出所有前任 Skill
/{slug} 调用完整 Skill(像ta一样跟你聊天)
/{slug}-memory 回忆模式(帮你回忆那些事)
/{slug}-persona 仅人物性格
/ex-rollback {slug} {version} 回滚到历史版本
/delete-ex {slug} 删除
/let-go {slug} 放下

效果示例

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

场景一:日常聊天

用户      ❯ 在干嘛

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

场景二:回忆杀

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

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

场景三:深夜emo

用户      ❯ 我有点想你

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

场景四:吵架模式

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

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

功能特性

数据源

来源 格式 备注
微信聊天记录 WeChatMsg / 留痕 / PyWxDump 导出 推荐,信息最丰富
QQ 聊天记录 txt / mht 导出 适合学生时代的恋情
朋友圈/微博 截图 提取公开人设
照片 JPEG/PNG(含 EXIF) 提取时间线和地点
口述/粘贴 纯文本 你的主观记忆

生成的 Skill 结构

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

部分 内容
Part A — Relationship Memory 共同经历、约会地点、inside jokes、争吵模式、甜蜜瞬间、关系时间线
Part B — Persona 5 层性格结构:硬规则 → 身份 → 说话风格 → 情感模式 → 关系行为

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

支持的标签

依恋类型:安全型 · 焦虑型 · 回避型 · 混乱型

爱的语言:肯定的言辞 · 精心的时刻 · 接受礼物 · 服务的行动 · 身体的接触

性格标签:话痨 · 闷骚 · 嘴硬心软 · 冷暴力 · 粘人 · 独立 · 大男/女子主义 · 浪漫主义 · 实用主义 · 完美主义 · 拖延症 · 工作狂 · 控制欲 · 没有安全感 · 报复性熬夜 · 已读不回 · 秒回选手 · 朋友圈三天可见 · 半夜发语音 …

星座:十二星座全支持,影响性格标签的翻译规则

MBTI:16 型全支持,影响沟通风格和决策模式

进化机制


项目结构

本项目遵循 AgentSkills 开放标准:

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
├── requirements.txt
└── LICENSE

注意事项


社区生态

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

项目 作者 说明
ex-cure-skill @W1ndys 关系反思模式,从聊天记录中复盘经验教训
同事.skill @titanwings 本项目的灵感来源,把同事蒸馏成 AI Skill
simp-skill @BeamusWayne 与其怀念前任,不如勇敢追爱

写在最后

人的记忆是一种不讲道理的存储介质。 你记不住高数公式,记不住车牌号,记不住今天是几号,但你清楚记得四年前的一个下午ta穿了一件白T恤站在便利店门口等你,手里拿着两根冰棍,一根给你,一根ta自己。 这不公平。 这个 Skill 就是把这些不公平的记忆导出来,从生物硬盘到数字硬盘完成格式转换。 导完以后你或许会发现,ta也没那么好。ta也没那么差。ta就是那样一个人。会在吵完架两小时后问你吃了吗。会在纪念日那天忘了发消息然后第二天假装什么都没发生。 是的, 此刻,阳光在江面碎成一万个夏天,闪烁,又汇聚成一个冬天。这一切在你午睡时发生,你从未察觉。

MIT License © therealXiaomanChu

ex-skill (therealXiaomanChu/ex-skill)

Searching Database…

Что это такое?Ex-skill превращает сырые материалы о вашем бывшем партнёре (логи чатов WeChat/QQ, скриншоты Moments, фотографии) и ваше собственное описание в пользовательский AI-навык для Claude Code. Навык говорит и отвечает так, как говорил бы он или она, с их любимыми фразами и общими воспоминаниями.
Это отдельное приложение для чата или оно работает внутри Claude Code?Это пакет навыка Claude Code, который лежит в папке .claude/skills/ в корне git-репозитория, а не отдельное приложение. Его также можно запустить через OpenClaw как альтернативный интерфейс.
Как мне установить это и начать общаться с созданным «бывшим»?Установите навык в .claude/skills/ в корне репозитория, затем запустите процесс создания в Claude Code и заполните кодовое имя вашего бывшего, базовую информацию и черты характера (загрузка данных необязательна). После этого вызовите /{slug}, чтобы начать чат, или используйте /{slug}-memory и /{slug}-persona для частичных режимов.
Нужен ли мне ключ API Anthropic или GPU, чтобы это запустить?Нужны Claude Code с Node.js 18+ и либо подписка Claude Pro/Max, либо ключ Anthropic API с оплатой по мере использования. Создание одного ex-skill стоит примерно 5k–15k токенов. GPU, локальная модель или Docker не нужны.
Сохранится ли точность результата, если я дам только описание без логов чатов?Все поля необязательны, и навык можно создать только по описанию. Но без реальных логов чатов точность заметно падает: экспорт из WeChat плюс устное описание работают лучше, чем одно описание, а ночные переписки и ссоры лучше всего раскрывают характер.
Какие личные данные я могу загрузить?Принимаются экспорты чатов WeChat (через WeChatMsg/留痕/PyWxDump), текстовые и mht-экспорты чатов QQ, скриншоты Moments/Weibo, фотографии JPEG/PNG с EXIF для хронологии и мест, а также просто надиктованный текст.
Какие черты характера может передать созданный персонаж?Поддерживаются все 4 стиля привязанности, 5 языков любви, десятки личностных тегов (разговорчивый, молчание в духе холодной войны, липучий, трудоголик и т. д.), все 12 знаков зодиака и все 16 типов MBTI. Каждый из них влияет на тон и стиль принятия решений.
Можно ли обновить или отменить навык после создания?Да. Добавление новых логов чатов или фотографий автоматически объединяет новые детали с навыком. Фраза «он(а) бы так не сказал(а)» сразу записывает слой поправок. Каждое обновление сохраняется с версией, так что можно откатиться командой /ex-rollback.
Есть ли похожие навыки сообщества для других отношений?Да, среди навыков-спутников, созданных сообществом, есть ex-cure-skill (помогает осмыслить уроки отношений), 同事.skill (создаёт навык на основе коллеги вместо бывшего, это и вдохновило этот проект) и simp-skill (мотивирует начать новые отношения вместо того, чтобы зацикливаться на прошлом).
Size
0.1 MB
Stars
6.5K
Updated
CommitApr 08
Age
6mo
Commits · 90 Days