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 会把你提供的关于前任的原始资料(微信/QQ聊天记录、朋友圈截图、照片)加上你自己的描述,生成一个定制的 Claude Code AI 技能,让它按照前任的说话方式和回应习惯来聊天,使用他们的口头禅和共同回忆。
这是一个独立的聊天应用,还是运行在 Claude Code 里面?它是一个 Claude Code 技能包,放在 git 仓库根目录的 .claude/skills/ 文件夹中,不是单独的应用;也可以通过 OpenClaw 作为另一种前端来运行。
我该怎么安装,并开始和生成的“前任”聊天?把技能安装到仓库根目录下的 .claude/skills/ 中,然后在 Claude Code 里运行创建流程,填写前任的代号、基本信息和性格特点(上传数据可选)。之后调用 /{slug} 开始聊天,或使用 /{slug}-memory 和 /{slug}-persona 进行部分模式的聊天。
运行它需要 Anthropic API 密钥或 GPU 吗?你需要 Claude Code 和 Node.js 18+,还需要 Claude Pro/Max 订阅或按量付费的 Anthropic API 密钥;生成一个 ex-skill 大约消耗 5k-15k 个 token。不需要 GPU、本地模型或 Docker。
如果我只给描述,不给聊天记录,结果还准确吗?所有字段都是可选的,只靠描述也能生成技能,但没有真实聊天记录时还原度会下降——微信导出的记录加上口头描述,效果比只有描述好得多;深夜聊天和争吵最能体现性格。
我可以提供哪些个人数据?它支持微信聊天导出(通过 WeChatMsg / 留痕 / PyWxDump)、QQ 聊天文本或 mht 导出文件、朋友圈/微博截图、带 EXIF 信息的 JPEG/PNG 照片(用于时间线和地点),以及直接口述的纯文字。
生成的人设能捕捉哪些性格特征?支持全部 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