ex-skill 是什么?

ex-skill 是一个 Claude Code Skill,把用户提供的关系描述、聊天记录、社交截图或照片整理成 Relationship Memory 与 Persona 文件,再通过命令调用这个人物表示。项目把用途限定为个人回忆与情感记录,并明确禁止骚扰、跟踪、冒充、欺诈和未经同意的公开分享。

⭐ 4,201 Stars 🍴 428 Forks Python — 作者: therealXiaomanChu
来源:github.com/therealXiaomanChu/ex-skill;https://github.com/therealXiaom… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

项目把关系资料整理、人物提示、记忆更新、纠正、回滚与删除做成一套中文命令流程,题材也带来持续搜索。这些累计值不能解释成独立访问人数。

来源:github.com/therealXiaomanChu/ex-skill

核心功能

描述优先的创建流程

运行 /create-ex 后填写代号、基本信息与性格画像,并选择数据来源。官方说明所有字段都可跳过,仅凭用户自己的文字描述也能生成,这也是减少第三方隐私输入的更稳妥做法。

来源:github.com/therealXiaomanChu/ex-skill
关系记忆与人物风格分层

生成结果分为 Relationship Memory 与 Persona:前者保存共同经历和关系时间线,后者保存身份、说话风格、情感模式与行为规则。模型先判断人物会怎样回答,再从记忆中补充上下文。

来源:github.com/therealXiaomanChu/ex-skill
更新、纠正与生命周期命令

新增资料可以合并到已有结果,对话中的纠正会写入 Correction 层;项目还提供列表、memory、persona、rollback、delete 和 let-go 命令。

来源:github.com/therealXiaomanChu/ex-skill
本地文件与明确合规边界

官方合规文档称解析在本地完成,生成的 persona.md 与 memory.md 保存在 gitignored 的 exes 目录,项目没有遥测或远程存储;同时明确 Claude Code 与 Anthropic API 的对话请求是网络交互。

来源:github.com/therealXiaomanChu/ex-skill/blob/main/docs/COMPLIANCE.md

技术架构

SKILL.md 是入口,prompts 目录负责资料录入、记忆与人物分析、生成、合并和纠正,tools 目录包含微信、QQ、社交内容与照片元信息解析脚本,以及 Skill 写入和版本管理。生成结果写入本地 exes 目录。宿主是 Claude Code:本地脚本负责文件解析与整理,模型对话请求则通过 Claude Code 发往 Anthropic。

来源:github.com/therealXiaomanChu/ex-skill;https://github.com/therealXiaom…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Claude Code Node.js 18+ Pillow>=9.0.0(可选,用于读取照片 EXIF)Pillow>=9.0.0… 描述优先的创建流程 关系记忆与人物风格分层 更新、纠正与生命周期命令更新、纠正与生命周期命… 本地文件与明确合规边界 ex-skill 项目本体 核心功能 关键依赖

技术栈

语言Markdown Skill 与 Python 工具脚本框架Claude Code Skill,遵循 Agent Skills 目录结构
Claude CodeNode.js 18+Pillow>=9.0.0(可选,用于读取照片 EXIF)
安装在项目 .claude/skills/create-ex 或用户 ~/.claude/skills/create-ex;需要 Claude Pro/Max 额度或 Anthropic API Key;MIT 许可
来源:github.com/therealXiaomanChu/ex-skill;https://github.com/therealXiaom…

快速上手

先确认 Node.js 18+ 和 Claude Code 可用,在一个单独测试项目的 .claude/skills/create-ex 目录克隆官方仓库。不要先导入聊天或照片;运行 /create-ex,只用自己写的一段虚构人物或已获同意的关系描述测试,所有字段都可跳过。检查生成的 exes 文件、调用命令和删除效果后,再决定是否加入最少量资料。照片如非必要不要使用;确需使用时先移除 EXIF 中的位置和时间信息。
来源:github.com/therealXiaomanChu/ex-skill;https://github.com/therealXiaom…

使用场景

适合在本人控制、相关人员知情同意的前提下做私人关系记录,或用完全虚构的人物测试 Claude Skill 的记忆与 persona 结构。它不适合核实真实人物想法,也不应公开成品、冒充真人或用来联系与影响当事人。若对话加重情绪困扰或影响生活,应停止使用;官方合规文档也给出相同方向的暂停建议。

来源:github.com/therealXiaomanChu/ex-skill;https://github.com/therealXiaom…

优势与局限

优势

  • 创建、记忆、人物风格、纠正、回滚和删除形成完整生命周期
  • 所有录入字段都可跳过,可从用户自写描述开始
  • 生成文件位于 gitignored 的本地目录,项目没有自带遥测或远程存储
  • 仓库单独提供隐私、禁止用途与心理健康边界说明

局限

  • 输出是模型依据有限资料生成的表示,不是当事人的真实想法或可靠复原
  • 聊天、截图和照片包含他人的权利与敏感信息,知情同意不能省略
  • 本地解析不等于完全离线,Claude Code 与 Anthropic API 的模型请求仍会经过网络
  • 照片解析可能读取 EXIF 中的时间与地点,增加不必要的隐私暴露
  • 官方没有发布 GitHub Release,也没有可核实的版本号;主分支变化需要重新审查
来源:github.com/therealXiaomanChu/ex-skill;https://github.com/therealXiaom…

最新版本

2026-09-23 核对时,官方仓库没有 GitHub Release,也没有可核实的版本号。项目通过 main 分支持续维护;安装会直接克隆当前代码,因此每次更新前都应查看差异,尤其关注解析脚本、提示文件和数据处理说明。

来源:github.com/therealXiaomanChu/ex-skill;https://github.com/therealXiaom…

实测与证据

status: docs_only_official_sources_checked_not_installed  |  checked_at: 2026-09-23  |  environment: 只阅读 therealXiaomanChu/ex-skill 官方 README、requirements.txt、COMPLIANCE.md、GitHub Releases 状态,以及 SillyTavern 官方仓库与角色文档;没有克隆或运行项目,也没有提交任何聊天、照片或身份资料  |  limitations: 没有观察 /create-ex、解析脚本、Anthropic 请求内容、生成目录、回滚、删除或 let-go 的实际行为,也没有验证数据保留策略。隐私与数据流说明来自项目官方文档,使用者仍需检查自己的 Claude Code 和 Anthropic 账户设置。  |  observed_output: GitHub latest-release API 返回 404,仓库 Releases 没有正式发布;README 要求 Claude Code 与 Node.js 18+,requirements.txt 唯一启用的 Python 依赖是可选 Pillow>=9.0.0。

来源:github.com/therealXiaomanChu/ex-skill;https://github.com/therealXiaom…

同类项目对比

相比 SillyTavern,ex-skill 聚焦从私人关系资料生成 Claude Skill,并提供关系记忆、纠正、回滚和删除命令。SillyTavern 官方角色文档描述的是通用角色管理:每个角色有名称、人物设定与对话历史,可以创建多个角色并用于单人或群聊。想研究 ex-skill 的特定记忆流程,可在同意和最小数据原则下测试;只想写虚构角色或在多种模型后端聊天时,SillyTavern 的通用角色方式更贴合目标,也能避开模仿真实可识别人物。

来源:github.com/therealXiaomanChu/ex-skill;https://github.com/SillyTavern/…

总结评价

ex-skill 的命令和文件结构完整,但题材直接涉及真实人物、私人通信和照片。适合从虚构人物或已获同意的最少描述开始,先核对生成、删除和网络数据边界。没有明确同意、无法控制资料流向,或使用后情绪状态变差时,不应继续加入私人材料。

来源:github.com/therealXiaomanChu/ex-skill;https://github.com/therealXiaom…

常见问题

ex-skill 必须导入聊天记录和照片吗?

不必。官方 README 说明所有字段都能跳过,仅凭描述也能生成。初次测试应使用自己写的虚构人物,或只用得到明确同意的最少资料。

ex-skill 的数据会不会离开本机?

官方称文件解析和生成文件保存在本地,项目本身没有上传、远程存储或遥测;但同一合规文档明确写明 Claude Code 与 Anthropic API 的对话请求是网络交互。不要把“本地文件”理解成“模型请求完全离线”,应另查账户的数据设置与保留政策。

ex-skill 生成的人物能代表真实的前任吗?

不能。它只根据用户提供的材料与主观描述生成模型表示,可能遗漏、夸大或编造细节。官方也提醒,这个 Skill 只是使用者记忆中的对方,不应拿它判断真人的想法或意愿。

删除 ex-skill 人物后还要检查什么?

官方提供 /delete-ex 命令,但本轮没有实测删除范围。执行后仍应检查 exes 目录、原始导出文件、照片、临时副本、版本存档和备份;模型服务端的请求记录与保留规则要按自己的 Anthropic 账户政策另行确认。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件