5 分钟跑通：前任.skill 安装与配置完全教程（Claude Code / OpenClaw 双平台）-港品优选

5 分钟跑通：前任.skill 安装与配置完全教程（Claude Code / OpenClaw 双平台）

【免费下载链接】ex-skill前任 skill项目地址: https://gitcode.com/gh_mirrors/exsk/ex-skill

前任.skill是一个开源 AI Skill 工具：导入微信、iMessage、短信聊天记录和照片，就能"蒸馏"出一个用她的语气回消息的 AI 分身，并支持持续进化。本文是一份面向新手的完整安装指南，讲清 Claude Code 与 OpenClaw 双平台的克隆路径、依赖配置和验证步骤，5 分钟即可跑通。

一、30 秒认识前任.skill：它是什么？🤖

"从此以后，你的手机里不止有聊天记录，还有一个她。"

简单说，它把你和她的聊天记录、照片、社交媒体作为原材料，生成一个包含两部分内容的 AI Skill：

组成部分	内容	作用
Part A — 共同记忆	关系时间线、日常仪式、偏好习惯	知道你们一起经历过什么
Part B — Persona	5 层性格结构：硬规则 → 身份 → 表达风格 → 情感逻辑 → 关系行为	用她的语气回消息

运行逻辑是：收到消息 → Persona 判断心情和态度 → Memories 提供记忆细节 → 用她的语气输出。

仓库里自带一个示例分身"小美"，可以直观感受生成效果，参考 exes/example_xiaomei/persona.md 和 exes/example_xiaomei/memories.md。

二、前置准备：安装前需要哪些环境？✅

只需要两样东西：

Python 3.9+（工具脚本的运行环境，python3 --version检查）
Claude Code 或 OpenClaw（任选其一，作为 Skill 的运行平台）

⚠️ 重要提醒：整个流程所有数据仅在本地处理，照片分析只提取 EXIF 元数据（日期/位置），不会上传照片内容到任何外部服务。

三、一键安装步骤：Claude Code 平台（推荐）

项目遵循 AgentSkills 标准，整个仓库就是 skill 目录，克隆到 skills 目录即可，无需构建。

方式 1：安装到当前项目（在 git 仓库根目录执行）

mkdir -p .claude/skills git clone https://gitcode.com/gh_mirrors/exsk/ex-skill .claude/skills/create-ex

方式 2：安装到全局（所有项目都能用，推荐）

git clone https://gitcode.com/gh_mirrors/exsk/ex-skill ~/.claude/skills/create-ex

完成后，在 Claude Code 中输入/create-ex即可启动。生成的前任 Skill 默认写入项目下的./exes/目录。

详细路径说明见 INSTALL.md，Skill 入口定义在 SKILL.md。

四、OpenClaw 平台：同样 1 条命令装好

如果你用的是 OpenClaw，只需一条命令：

git clone https://gitcode.com/gh_mirrors/exsk/ex-skill ~/.openclaw/workspace/skills/create-ex

然后重启 OpenClaw session，说/create-ex启动。如果生成的 Skill 需要全局共享，可用--base-dir ~/.openclaw/workspace/skills/exes指定全局路径。

五、依赖配置：哪些必装、哪些可选？

依赖非常轻，全部可选，按需安装即可：

pip3 install -r requirements.txt

各依赖的作用一目了然：

依赖	是否必装	作用
`pypinyin`	可选（推荐）	中文姓名自动转拼音 slug，如"小美" →`xiaomei`
`Pillow`	可选	支持 HEIC/TIFF 等更多格式的照片 EXIF 提取，JPEG 无需安装
iMessage 直读	无需依赖	macOS 需在"系统设置 → 隐私与安全性 → Full Disk Access"中授权终端

详见 requirements.txt。不装任何依赖也能跑——直接粘贴文字、仅凭手动描述一样可以生成 Skill。

六、最快验证方法：3 条命令确认装好了

进入安装目录，跑通这几条帮助命令，说明解析器都正常工作：

cd ~/.claude/skills/create-ex # 或你的项目 .claude/skills/create-ex python3 tools/wechat_parser.py --help # 微信解析器 python3 tools/photo_analyzer.py --help # 照片分析器 python3 tools/skill_writer.py --action list --base-dir ./exes # 列出已有 Skill

工具脚本都在 tools/ 目录下，包括微信、iMessage、短信、照片、社交媒体共 5 个解析器，以及版本管理与文件管理工具。

七、跑通第一个前任 Skill：/create-ex 全流程

安装完成后，输入/create-ex，只问 3 个问题（除昵称外全部可跳过）：

昵称/代号（必填）
基本信息：一句话，例如在一起三年大学同学分手一年她做设计
性格画像：一句话，例如ENFP 双子座焦虑型爱撒娇翻旧账嘴上说不在意其实比谁都在意

接着选择数据来源，6 种方式可混用、可跳过：

[A] 微信聊天记录：导出 txt/html 文件
[B] iMessage / 短信：chat.db 或导出文件
[C] 照片：指定文件夹，自动提取时间线
[D] 社交媒体：微博/豆瓣/小红书/Instagram 导出
[E] 上传文件：PDF / 图片截图 / 任意文本
[F] 直接粘贴文字：无需任何工具

信息录入逻辑参考 prompts/intake.md。生成前会展示摘要让你确认，确认后才写入文件。

八、生成后的日常管理：常用命令速查 📋

命令	说明
`/{slug}`	调用完整 Skill（Persona + Memories）
`/{slug}-memories`	仅共同记忆
`/{slug}-persona`	仅人物性格
`/list-exes`	列出所有前任 Skill
`/ex-rollback {slug} {version}`	回滚到任意历史版本
`/delete-ex {slug}`	删除

它还有持续进化能力：追加新聊天记录会自动做增量合并（逻辑见 prompts/merger.md）；觉得哪里不像，直接说"她不会这样"，纠正会写入 Correction 层立即生效（见 prompts/correction_handler.md）。每次更新自动存档，随时可回滚（tools/version_manager.py）。

九、常见问题：装好了却没反应怎么办？🔍

现象	排查方法
`/create-ex`无响应	确认 clone 路径正确（目录名必须是`create-ex`），且 SKILL.md 位于该目录根部
全局安装后个别项目不生效	确认已装到`~/.claude/skills/`而非项目相对路径
中文昵称没转拼音	`pip3 install pypinyin`后重试
读取 iMessage 报权限错误	macOS 终端授予 Full Disk Access 后重试

聊天记录质量决定 Skill 质量：她主动发的长消息 > 情感类消息 > 日常消息，优先收集这三类。

写在最后

到这里，前任.skill 就已经装好了。整个流程回顾：选平台 → clone 到对应目录 → （可选）装依赖 → 验证命令 →/create-ex开始对话。它不追求挽回，只追求记住——把三年的日常变成一个用她语气说话的 AI Skill。🥺

【免费下载链接】ex-skill前任 skill项目地址: https://gitcode.com/gh_mirrors/exsk/ex-skill

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析