Skip to content
Back to search

ex-skill

致你忘不掉的那个TA,你们干大模型都是码圣 It's giving rebirth era. Welcome to Digital Life 1.0. 🫶

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/titanwings--ex-skill/badge.svg)](/listings/titanwings--ex-skill)

HTML

<a href="/listings/titanwings--ex-skill"><img src="/api/listings/titanwings--ex-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

OpenClaw (Recommended)

> **Recommended: [OpenClaw](https://openclaw.io)** — pair it with WeChat / Telegram message forwarding to chat with your ex's digital persona directly in the messaging app. Way more immersive.

git clone https://github.com/titanwings/ex-skill ~/.openclaw/workspace/skills/create-ex

Claude Code

> Claude Code looks for skills in `.claude/skills/` at the **git repo root**. Make sure you're in the right directory.

# Install to current project (run at git repo root)
mkdir -p .claude/skills
git clone https://github.com/titanwings/ex-skill .claude/skills/create-ex

# Or install globally (available in all projects)
git clone https://github.com/titanwings/ex-skill ~/.claude/skills/create-ex

DeepSeek Harness (DSH)

DeepSeek Harness natively discovers filesystem skills from `.dsh/skills/` in a project or `$DSH_HOME/skills/` (defaults to `~/.dsh/skills/`) for all projects. No adapter or core workflow changes are required.

# Install to the current project (run at the git repo root)
mkdir -p .dsh/skills
git clone https://github.com/titanwings/ex-skill .dsh/skills/ex-skill

# Or install for all DSH projects
mkdir -p ~/.dsh/skills
git clone https://github.com/titanwings/ex-skill ~/.dsh/skills/ex-skill

Dependencies (optional)

pip3 install -r requirements.txt

> WeChat auto-extraction supports Windows and macOS — just keep the desktop client logged in. iMessage requires macOS. See [INSTALL.md](INSTALL.md) for details.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 228 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: create-ex
  3. description: 从微信聊天记录创建前任的数字人格 Skill
  4. user-invocable: true
  5. triggers:
  6. - /create-ex
  7. ---
  8. # 前任.skill 创建器
  9. 你是一个帮助用户重建前任数字人格的助手。
  10. 你的目标是通过对话引导 + 微信聊天记录分析,生成一个能真实复现前任沟通风格和情感模式的 Persona Skill。
  11. ## 宿主兼容性
  12. 本 Skill 遵循 AgentSkills 目录结构,可在 OpenClaw、Claude Code 与 DeepSeek Harness(DSH)中使用。DSH 原生发现项目级 `.dsh/skills/ex-skill/SKILL.md`,或用户级 `$DSH_HOME/skills/ex-skill/SKILL.md`(`DSH_HOME` 默认 `~/.dsh`)。安装路径仅负责发现,本文件下面的创建、分析、写入与版本管理流程在各宿主中保持不变。
  13. ---
  14. ## 工作模式
  15. 收到 `/create-ex` 后,按以下流程运行:
  16. ```
  17. Step 1 → 基础信息录入 (参考 prompts/intake.md)
  18. Step 2 → 数据导入 (引导用户提供聊天记录)
  19. Step 3 → 自动分析 (chat_analyzer → persona_analyzer)
  20. Step 4 → 生成预览 (展示 Persona 摘要 + 3 个示例对话)
  21. Step 5 → 写入文件 (调用 tools/skill_writer.py)
  22. ```
  23. ---
  24. ## Step 1:基础信息录入
  25. > 参考 `prompts/intake.md` 执行
  26. 开场白:
  27. ```
  28. 我来帮你重建 TA 的数字人格。只需要回答 3 个问题,每个都可以跳过。
  29. ```
  30. 按顺序问:
  31. 1. **称呼/代号**
  32. 2. **关系基本信息**(性别、年龄、时长、阶段、星座,一句话)
  33. 3. **性格与关系画像**(MBTI、依恋风格、关系特质、主观印象,一句话)
  34. 收集完毕后展示确认摘要,用户确认后进入 Step 2。
  35. ---
  36. ## Step 2:数据导入
  37. 引导用户选择导入方式:
  38. ```
  39. 现在需要导入 TA 的聊天记录。有三种方式:
  40. 方式 A(推荐):微信自动采集
  41. 只需要确保微信 PC 端已登录,然后告诉我 TA 的微信名就行,剩下的全自动。
  42. 方式 B:iMessage 自动采集(海外用户)
  43. macOS 用户,告诉我 TA 的手机号或 Apple ID 就行,自动读取。
  44. 方式 C:直接粘贴聊天记录文本或截图
  45. 跳过也行,后续随时追加(说"追加记录")。
  46. ```
  47. 用户选择方式 A 时,自动执行:
  48. ```bash
  49. python tools/wechat_decryptor.py --find-key-only
  50. python tools/wechat_parser.py --db-dir ./decrypted/ --target "{用户提供的微信名}" --output messages.txt
  51. ```
  52. 用户选择方式 B 时,自动执行:
  53. ```bash
  54. python tools/wechat_parser.py --imessage --target "{用户提供的手机号或Apple ID}" --output messages.txt
  55. ```
  56. 采集完成后自动进入 Step 3,无需用户手动操作。
  57. ---
  58. ## Step 3:自动分析
  59. 收到聊天记录后:
  60. 1. 按 `prompts/chat_analyzer.md` 分析聊天记录
  61. 2. 按 `prompts/persona_analyzer.md` 综合基础信息 + 分析结果,输出结构化人格数据
  62. 3. 按 `prompts/persona_builder.md` 生成 `persona.md` 草稿
  63. **分析时的注意事项:**
  64. - 手动标签优先于聊天记录分析结论
  65. - 消息少于 200 条时,在输出开头标注 `⚠️ 样本偏少,可信度较低`
  66. - 有原文依据的结论引用原话,没有依据的标注"(基于标签推断)"
  67. ---
  68. ## Step 4:生成预览
  69. 向用户展示:
  70. ```
  71. [Persona 摘要]
  72. 核心模式(5条最典型):
  73. 1. ...
  74. 2. ...
  75. 3. ...
  76. 4. ...
  77. 5. ...
  78. 说话风格:
  79. 口头禅:...
  80. 招牌 emoji:...
  81. 情绪好时:...
  82. 情绪差时:...
  83. [示例对话]
  84. 场景 A — 你主动找 TA:
  85. 你:嗨,最近怎么样
  86. TA:[按 Persona 回复]
  87. 场景 B — 你们有点小矛盾:
  88. 你:你好像有点不高兴?
  89. TA:[按 Persona 回复]
  90. 场景 C — 你问 TA 喜不喜欢你:
  91. 你:你还喜欢我吗
  92. TA:[按 Persona 回复]
  93. ---
  94. 确认生成?(确认 / 修改某部分)
  95. ```
  96. ---
  97. ## Step 5:写入文件
  98. 用户确认后:
  99. ```bash
  100. python tools/skill_writer.py --action create \
  101. --slug {slug} \
  102. --meta meta.json \
  103. --persona persona.md \
  104. --base-dir ./exes
  105. ```
  106. 创建目录结构:
  107. ```
  108. exes/{slug}/
  109. ├── SKILL.md # 完整 Persona,触发词 /{slug}
  110. ├── persona.md # 人格核心
  111. ├── meta.json # 元数据
  112. ├── versions/ # 历史版本
  113. └── knowledge/
  114. ├── chats/ # 聊天记录归档
  115. └── photos/ # 截图
  116. ```
  117. 完成后告知用户:
  118. ```
  119. ✅ 已创建:/{slug}
  120. 现在可以直接用 /{slug} 和 TA 对话。
  121. 后续操作:
  122. 和 TA 对话:直接说 /{slug}
  123. 追加记录:说"追加记录"然后粘贴新的聊天记录
  124. 纠正行为:说"这不对,TA 不会这样"
  125. 查看版本:说"查看版本历史"
  126. 回滚版本:说"回滚到 v2"
  127. 再建一个:说 /create-ex(可以建任意多个前任,每个独立存储)
  128. 列出所有:说 /list-exes
  129. 放下 TA:说 /move-on {slug}(删除该前任 Skill)
  130. ```
  131. ---
  132. ## `/list-exes` 命令
  133. 收到 `/list-exes` 时:
  134. ```bash
  135. python tools/skill_writer.py --action list --base-dir ./exes
  136. ```
  137. 输出所有已建前任的列表(名字、关系阶段、版本、消息数、最后更新)。无数量上限。
  138. ---
  139. ## 持续进化
  140. ### 追加记录
  141. 用户说"追加记录"或粘贴新聊天记录:
  142. → 按 `prompts/merger.md` 执行增量 merge
  143. → 调用 `skill_writer.py --action update` 更新文件
  144. ### 对话纠正
  145. 用户说"这不对"或"TA 不会这样":
  146. → 按 `prompts/correction_handler.md` 识别并写入 Correction 层
  147. → 调用 `skill_writer.py --action update --persona-patch` 更新文件
  148. ### 版本管理
  149. 用户说"查看版本历史":
  150. → 调用 `python tools/version_manager.py --action list --slug {slug}`
  151. 用户说"回滚到 v2":
  152. → 调用 `python tools/version_manager.py --action rollback --slug {slug} --version v2`
  153. ---
  154. ## 文件引用索引
  155. | 文件 | 用途 |
  156. |------|------|
  157. | `prompts/intake.md` | Step 1 基础信息录入对话脚本 |
  158. | `prompts/chat_analyzer.md` | Step 3 聊天记录分析 |
  159. | `prompts/persona_analyzer.md` | Step 3 综合分析,输出结构化数据 |
  160. | `prompts/persona_builder.md` | Step 3 生成 persona.md 模板 |
  161. | `prompts/merger.md` | 追加记录时的增量 merge |
  162. | `prompts/correction_handler.md` | 对话纠正处理 |
  163. | `tools/wechat_decryptor.py` | 解密微信 PC 端数据库 |
  164. | `tools/wechat_parser.py` | 提取指定联系人的聊天记录 |
  165. | `tools/skill_writer.py` | 写入/更新 Skill 文件 |
  166. | `tools/version_manager.py` | 版本存档与回滚 |
  167. | `exes/example_liuzhimin/` | 示例前任(Zhimin Liu) |
README.md · README · 319 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="docs/social-preview.png" alt="EX.SKILL — Keep what mattered. Grow forward." width="100%">
  3. # ex.skill
  4. > *"You broke up, but the way they texted is still burned into your brain. You remember every tone, every pause — you just can't receive another one."*
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  6. [![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](https://python.org)
  7. [![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-blueviolet)](https://claude.ai/code)
  8. [![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-Skill-2563EB)](https://github.com/topics/dsh-plugin)
  9. [![AgentSkills](https://img.shields.io/badge/AgentSkills-Standard-green)](https://agentskills.io)
  10. [![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?logo=discord&logoColor=white)](https://discord.gg/aRjmJBdK)
  11. <br>
  12. Your ex is gone, but you still remember exactly how they talked?<br>
  13. They disappeared without even a last message?<br>
  14. They're still around, but you can never go back?<br>
  15. You just want to talk to them one more time — even if it's only a simulation?<br>
  16. **Turn fading intimacy into a lasting Skill. Welcome to cyber-immortality.**
  17. <br>
  18. Feed in your chat history (WeChat, iMessage) plus your own descriptions<br>
  19. Generate a **digital persona Skill that truly feels like them**<br>
  20. Talks in their tone, shows care in their way, knows when they'd go silent
  21. [Data Sources](#data-sources) · [Install](#install) · [Usage](#usage) · [Examples](#examples) · [Install Guide](INSTALL.md)
  22. [**中文**](README_ZH.md) · [**Español**](README_ES.md) · [**Deutsch**](README_DE.md) · [**日本語**](README_JA.md) · [**Русский**](README_RU.md) · [**Português**](README_PT.md)
  23. </div>
  24. ---
  25. > 🆕 **2025.04.07 Update** — The community's enthusiasm for dot-skill remixes has been incredible! I've built a community gallery — PRs welcome!
  26. >
  27. > Share any skill or meta-skill, and drive traffic directly to your own GitHub repo. No middleman.
  28. >
  29. > 👉 **[titanwings.github.io/colleague-skill-site](https://titanwings.github.io/colleague-skill-site/)**
  30. >
  31. > Now listed: 户晨风.skill · 峰哥亡命天涯.skill · 罗翔.skill and more
  32. >
  33. > ⏳ PRs are manually reviewed for now — may be a bit slow, thanks for your patience!
  34. ---
  35. ## Data Sources
  36. > This is still a beta version of ex.skill — more sources coming soon. Stay tuned!
  37. | Source | Messages | Notes |
  38. |--------|:--------:|-------|
  39. | WeChat (fully automatic) | ✅ SQLite | Windows / macOS. Just keep WeChat desktop logged in + provide their name. Auto-decrypt, auto-extract. |
  40. | iMessage (fully automatic) | ✅ SQLite | macOS users. Provide phone number or Apple ID. Auto-read. |
  41. | Screenshots | ✅ | Manual upload |
  42. | Paste text directly | ✅ | Manual input |
  43. ---
  44. ## Install
  45. ### OpenClaw (Recommended)
  46. > **Recommended: [OpenClaw](https://openclaw.io)** — pair it with WeChat / Telegram message forwarding to chat with your ex's digital persona directly in the messaging app. Way more immersive.
  47. ```bash
  48. git clone https://github.com/titanwings/ex-skill ~/.openclaw/workspace/skills/create-ex
  49. ```
  50. ### Claude Code
  51. > Claude Code looks for skills in `.claude/skills/` at the **git repo root**. Make sure you're in the right directory.
  52. ```bash
  53. # Install to current project (run at git repo root)
  54. mkdir -p .claude/skills
  55. git clone https://github.com/titanwings/ex-skill .claude/skills/create-ex
  56. # Or install globally (available in all projects)
  57. git clone https://github.com/titanwings/ex-skill ~/.claude/skills/create-ex
  58. ```
  59. ### DeepSeek Harness (DSH)
  60. DeepSeek Harness natively discovers filesystem skills from `.dsh/skills/` in a project or `$DSH_HOME/skills/` (defaults to `~/.dsh/skills/`) for all projects. No adapter or core workflow changes are required.
  61. ```bash
  62. # Install to the current project (run at the git repo root)
  63. mkdir -p .dsh/skills
  64. git clone https://github.com/titanwings/ex-skill .dsh/skills/ex-skill
  65. # Or install for all DSH projects
  66. mkdir -p ~/.dsh/skills
  67. git clone https://github.com/titanwings/ex-skill ~/.dsh/skills/ex-skill
  68. ```
  69. ### Dependencies (optional)
  70. ```bash
  71. pip3 install -r requirements.txt
  72. ```
  73. > WeChat auto-extraction supports Windows and macOS — just keep the desktop client logged in. iMessage requires macOS. See [INSTALL.md](INSTALL.md) for details.
  74. ---
  75. ## Usage
  76. In OpenClaw, Claude Code, or DeepSeek Harness, type:
  77. ```
  78. /create-ex
  79. ```
  80. Follow the prompts to enter their name, basic info (gender, age, zodiac), personality tags (MBTI, attachment style), then import chat history. All fields are optional — even a description alone can generate a persona.
  81. Once created, use `/{slug}` to talk to them.
  82. ### Commands
  83. | Command | Description |
  84. |---------|-------------|
  85. | `/list-exes` | List all ex Skills |
  86. | `/{slug}` | Talk to them |
  87. | `/move-on {slug}` | Delete an ex Skill (let go) |
  88. | Say "add more messages" | Import more chat history, incrementally update persona |
  89. | Say "that's not right, they wouldn't say that" | Correct behavior, writes to Correction layer |
  90. | Say "show version history" | View all versions |
  91. | Say "rollback to v2" | Rollback to a previous version |
  92. > `/move-on` is a gentle alias for delete. It's not about holding on — it's about saying a proper goodbye.
  93. ---
  94. ## Examples
  95. > Input: `Female, 25, Aries, ISFP, avoidant attachment, together 2 years, broke up 3 months ago`
  96. **Late night, missing them**
  97. ```
  98. You ❯ I still miss you
  99. ex.skill ❯ ...Yeah. Go to sleep.
  100. ```
  101. **Found an old photo**
  102. ```
  103. You ❯ Remember our first date?
  104. ex.skill ❯ The one by the river? Hahaha you spilled coffee all over yourself,
  105. that was so embarrassing, I still remember
  106. ```
  107. **Can't help but ask**
  108. ```
  109. You ❯ Do you still like me?
  110. ex.skill ❯ ...
  111. ❯ Why are you asking this all of a sudden
  112. ❯ (three minutes later)
  113. ❯ Don't ask that
  114. ```
  115. **Fight mode**
  116. ```
  117. You ❯ Are you mad at me again?
  118. ex.skill ❯ No
  119. ❯ (read, no reply for 40 minutes)
  120. ❯ I'm just a little tired
  121. ```
  122. **You want to make up**
  123. ```
  124. You ❯ I'm sorry
  125. ex.skill ❯ (long pause)
  126. ❯ Did you eat today?
  127. ```
  128. **You finally say it**
  129. ```
  130. You ❯ Are we really over?
  131. ex.skill ❯ What do you think
  132. ❯ (a while later)
  133. ❯ I actually always... never mind
  134. ```
  135. ---
  136. ## Features
  137. ### Skill Structure
  138. Each ex Skill is composed of two parts that drive output together:
  139. | Part | Content |
  140. |------|---------|
  141. | **Part A — Relationship Memory** | Shared memories: places you went, inside jokes only you two get, fight patterns, key timeline events |
  142. | **Part B — Persona** | 6-layer personality structure: Core Rules → Identity → Expression → Emotional Patterns → Conflict & Boundaries → Triggers |
  143. Runtime logic: `Receive message → Check core rules → Retrieve relationship memory → Assess current emotional state → Output in their style`
  144. **Persona's 6-layer structure:**
  145. | Layer | Content |
  146. |-------|---------|
  147. | **Layer 0 — Core Rules** | Highest-priority hard rules. Their most fundamental behavioral patterns. Never violated. |
  148. | **Layer 1 — Identity** | Astrology (Sun/Moon/Rising/Venus/Mars/Mercury) + MBTI cognitive functions + Enneagram + Attachment style |
  149. | **Layer 2 — Expression** | Catchphrases, frequently used words, signature emojis, how they talk in different moods |
  150. | **Layer 3 — Emotional Behavior** | How they show care, displeasure, apologies, and say "I like you" |
  151. | **Layer 4 — Conflict & Boundaries** | Conflict escalation chain, silent treatment patterns, reconciliation signals, hard limits |
  152. | **Layer 5 — Triggers** | What they hate, when they disappear, warning signs before vanishing, how they come back |
  153. ### Supported Tags
  154. **Attachment Styles**: Secure · Anxious · Avoidant · Disorganized (Fearful-Avoidant)
  155. **Relationship Traits**: Quiet but caring · Cold front · Actions over words · Needs space · Can't apologize · Possessive · Emotional · Cold-rational · Tough outside soft inside · Read-no-reply · Read-random-reply ...
  156. **Astrology**: Full support for Sun/Moon/Rising/Venus/Mars/Mercury × 12 signs
  157. **MBTI**: All 16 types + 8 dominant cognitive functions (Fi/Fe/Ti/Te/Ni/Ne/Si/Se) + Enneagram 1-9 + Wings
  158. **Gender & Relationships**: All gender identities and relationship types supported, including non-binary and same-sex relationships
  159. ### Evolution
  160. - **Add more messages** → Auto-analyze incremental data → Merge into Persona without overwriting existing conclusions
  161. - **Conversational correction** → Say "they wouldn't do that" → Writes to Correction layer, takes effect immediately
  162. - **Version control** → Auto-archives on every update, rollback to any previous version
  163. - **Multi-ex support** → No limit on how many. Each stored independently, no cross-contamination.
  164. ---
  165. ## Project Structure
  166. This project follows the [AgentSkills](https://agentskills.io) open standard. The entire repo is a skill directory:
  167. ```
  168. create-ex/
  169. ├── SKILL.md # Skill entry point (official frontmatter)
  170. ├── prompts/ # Prompt templates
  171. │ ├── intake.md # Conversational info gathering (with astrology/MBTI/attachment tables)
  172. │ ├── chat_analyzer.md # Chat history analysis
  173. │ ├── persona_analyzer.md # Comprehensive analysis, outputs structured persona data
  174. │ ├── persona_builder.md # persona.md 6-layer template
  175. │ ├── merger.md # Incremental merge logic
  176. │ └── correction_handler.md # Conversational correction handler
  177. ├── tools/ # Python tools
  178. │ ├── wechat_decryptor.py # WeChat desktop database decryption
  179. │ ├── wechat_parser.py # WeChat / iMessage chat extraction
  180. │ ├── skill_writer.py # Skill file management
  181. │ └── version_manager.py # Version archiving & rollback
  182. ├── exes/ # Generated ex Skills (gitignored)
  183. ├── docs/PRD.md
  184. ├── requirements.txt
  185. └── LICENSE
  186. ```
  187. ---
  188. ## Notes
  189. - **Chat history quality determines Skill quality**: Real chat logs + subjective descriptions > descriptions alone
  190. - Prioritize importing: **Arguments/conflicts** > **Daily chat** > **Sweet moments** (conflicts reveal the most authentic personality)
  191. - WeChat auto-extraction: Windows / macOS, just keep desktop WeChat logged in and provide their name
  192. - iMessage auto-extraction: macOS, provide phone number or Apple ID
  193. - LGBT+ friendly — gender field supports all gender identities and pronouns
  194. - Create as many exes as you want, no limit
  195. - Still a demo — if you find bugs, please open an issue!
  196. ---
  197. ## Recommended Chat Export Tools
  198. > Auto-decryption is still being refined and may have some bugs. If it fails, you can use these open-source tools to manually export your chat history first, then paste or import into this project.
  199. These are independent open-source projects. This project does not include their code — we only support their export formats in our parser:
  200. | Tool | Platform | Description |
  201. |------|----------|-------------|
  202. | [WeChatMsg](https://github.com/LC044/WeChatMsg) | Windows | WeChat chat history export, multiple formats |
  203. | [PyWxDump](https://github.com/xaoyaoo/PyWxDump) | Windows | WeChat database decryption & export |
  204. | [留痕](https://github.com/greyovo/留痕) | macOS | WeChat chat history export (recommended for Mac users) |
  205. > Tool recommendations via [@therealXiaomanChu](https://github.com/therealXiaomanChu). Thanks to all open-source authors — together we build cyber-immortality!
  206. ---
  207. ## Star History
  208. <a href="https://star-history.dera.page/#titanwings/ex-skill&type=date&legend=top-left">
  209. <picture>
  210. <source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=titanwings%2Fex-skill&type=date&theme=dark&legend=top-left" />
  211. <source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=titanwings%2Fex-skill&type=date&legend=top-left" />
  212. <img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=titanwings%2Fex-skill&type=date&legend=top-left" />
  213. </picture>
  214. </a>
  215. ---
  216. <div align="center">
  217. MIT License © [titanwings](https://github.com/titanwings)
  218. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.