## 项目概述

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 安装到当前项目：

```bash
mkdir -p .claude/skills
git clone https://github.com/therealXiaomanChu/ex-skill .claude/skills/create-ex
```

或安装到全局（所有项目可用）：

```bash
git clone https://github.com/therealXiaomanChu/ex-skill ~/.claude/skills/create-ex
```

可选安装 Python 依赖：

```bash
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 仓库：[https://github.com/therealxiaomanchu/ex-skill](https://github.com/therealxiaomanchu/ex-skill)
- AgentSkills 标准：[https://agentskills.io](https://agentskills.io)
- Claude Code 安装指南：[https://docs.anthropic.com/en/docs/claude-code](https://docs.anthropic.com/en/docs/claude-code)
- Anthropic 使用政策：[https://www.anthropic.com/policies](https://www.anthropic.com/policies)

## 信息来源和分析时间

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