therealXiaomanChu / ex-skill

therealXiaomanChu/ex-skill

open_in_new前往仓库

将前任蒸馏成 AI 技能，以 TA 的方式与你对话。

项目概览

项目概述

ex-skill（前任.skill）是一个运行在 Claude Code 上的 meta-skill，它允许用户通过提供前任的聊天记录、照片和主观描述，生成一个模拟前任说话方式和性格的 AI Skill。该项目旨在帮助用户进行个人回忆与情感疗愈，通过数字化的方式保存和重现与前任相关的记忆。项目遵循 AgentSkills 开放标准，使用 Python 编写，并采用 MIT 许可证。

核心功能

  • 对话式信息录入：通过 /create-ex 命令启动，引导用户输入前任的代号、基本信息、性格画像等，所有字段均可跳过。
  • 多数据源支持：支持微信聊天记录（WeChatMsg/留痕/PyWxDump 导出）、QQ 聊天记录（txt/mht）、朋友圈/微博截图、照片（含 EXIF）以及纯文本口述。
  • 两层架构生成：生成包含 Part A（Relationship Memory）和 Part B（Persona）的 Skill，分别存储事实性记忆和性格行为模式。
  • 进化机制：支持追加记忆（增量 merge）、对话纠正（写入 Correction 层）、版本管理（自动存档与回滚）。
  • 管理命令：提供 /list-exes、/{slug}、/{slug}-memory、/{slug}-persona、/ex-rollback、/delete-ex、/let-go 等命令。
  • 本地数据处理：所有数据处理均在用户本地完成，不涉及远程数据抓取或上传。

适用与不适用场景

适用场景：

  • 个人情感疗愈：帮助用户整理和回顾与前任的共同记忆。
  • 回忆存档：将聊天记录、照片等数字化，形成可交互的回忆档案。
  • 性格模拟：基于真实数据生成前任的 AI 人格，用于个人对话练习。

不适用场景：

  • 骚扰、跟踪、冒充或欺诈他人。
  • 生成涉及未成年人的任何内容。
  • 商业用途或公开传播生成的 AI 人格。
  • 替代真实人际关系或专业心理咨询。

技术架构与依赖

  • 运行环境：需要 Claude Code（免费安装，需 Node.js 18+），也可使用 OpenClaw 作为替代前端。
  • 语言：Python 3.9+，用于解析聊天记录和生成 Skill 文件。
  • 依赖：requirements.txt 中的 Python 包（可选安装）。
  • API 消耗：创建一个 Skill 大约消耗 5k-15k tokens，取决于聊天记录量。
  • 付费方式：Claude Pro/Max 订阅或 Anthropic API Key。
  • 无需 GPU、本地模型或 Docker。

安装与快速开始

安装

在 git 仓库根目录执行以下命令，将 skill 安装到当前项目：

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

可选安装 Python 依赖：

pip3 install -r requirements.txt

快速开始

  1. 在 Claude Code 中输入 /create-ex。
  2. 按提示输入前任的代号、基本信息、性格画像，选择数据来源（可跳过）。
  3. 完成后用 /{slug} 调用该前任 Skill，开始对话。

典型使用方法

  • 日常聊天：调用 /{slug}，像与前任聊天一样互动。
  • 回忆模式：调用 /{slug}-memory，帮助回忆共同经历。
  • 仅人物性格：调用 /{slug}-persona，只使用性格模式。
  • 追加记忆：找到更多聊天记录或照片，通过追加功能增量更新。
  • 对话纠正：说「ta不会这样说」，写入 Correction 层，立即生效。
  • 版本管理：使用 /ex-rollback {slug} {version} 回滚到历史版本。

配置与部署要点

  • 数据隐私：所有数据在本地处理，生成的 Skill 文件保存在 exes/ 目录，已被 .gitignore 排除，不会提交到 Git。
  • 合规性：仅允许提取自己参与的聊天记录，禁止未经同意公开分享或用于骚扰等非法用途。
  • 心理健康：项目初衷是情感记忆存档，若用户过度沉浸，建议暂停并寻求专业帮助。
  • 聊天记录质量：微信导出 + 口述 > 仅口述，优先提供深夜对话、争吵记录等高质量内容。

限制、风险与许可证

  • 限制：不推荐、不捆绑任何第三方聊天记录解密/导出工具；这些工具可能违反平台服务条款且随时失效。
  • 风险：聊天记录包含对方发言，对方对其内容享有权利；不同司法管辖区法律不同，请遵守当地法律。
  • 许可证：MIT License，版权所有 © therealXiaomanChu。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 README、docs/COMPLIANCE.md、docs/EXPORT_GUIDE.md、docs/PRD.md。
  • 分析时间：2026 年 4 月（文档最后更新日期）。