ex-skill 中文教程：从虚构描述开始，先弄清数据去哪了
ex-skill 是一个 Claude Code Skill。它把描述、聊天、社交截图或照片整理成关系记忆和人物风格文件，再通过命令调用。这个项目碰到真实人物与私人通信，安装并不是难点；真正要先做的是取得同意、减少数据，并弄清本地文件和模型请求的边界。
1. 先判断资料能不能用
初次测试只用虚构人物，或者使用你自己写的、不含对方身份信息的描述。要加入真人聊天、截图或照片，先取得相关人员明确同意，并约定用途、保存时间和删除方式。官方合规文档禁止未经同意公开分享，也禁止骚扰、跟踪、冒充、欺诈和商业传播。
2. 安装到单独测试项目
官方要求 Claude Code 与 Node.js 18+。Claude Pro/Max 订阅或 Anthropic API Key 是宿主模型的费用条件，仓库本身没有充值或配额转售流程。先安装在一个不含正式代码和私人文件的测试目录，避免全局安装扩大可访问范围。
node --version
mkdir ex-skill-test && cd ex-skill-test
mkdir -p .claude/skills
git clone https://github.com/therealXiaomanChu/ex-skill \
.claude/skills/create-exrequirements.txt 中启用的 Python 依赖只有可选的 Pillow，用来读取照片 EXIF。描述测试不需要先装它，也不要为了“完整体验”主动加入位置元数据。
3. 用虚构描述跑一遍生命周期
在 Claude Code 输入 /create-ex。官方说明所有字段均可跳过，所以可以只写一段虚构人物描述，不导入任何聊天或照片。生成后检查本地 exes/ 目录中的 persona 与 memory：事实是否仅来自输入，是否混入真实姓名、地点或联系方式，人物口吻是否被误写成客观事实。
项目还提供 /{slug}-memory、/{slug}-persona、/ex-rollback、/delete-ex 和 /let-go。不要只看对话效果；还要测试修改、回滚、删除，并记录每一步产生了哪些文件。
4. 本地文件不等于完全离线
官方合规文档称，聊天解析在本地完成，生成的 persona.md 与 memory.md 保存在 gitignored 的 exes/ 目录，项目本身没有数据上传、远程存储或遥测功能。文档也明确写着，Claude Code 与 Anthropic API 的对话请求是网络交互。
这意味着文件可以留在本地，但送给模型处理的内容仍可能进入网络请求。使用前要查看自己的 Claude Code 与 Anthropic 账户设置、请求记录和保留政策。仓库的 .gitignore 只能阻止常规 Git 提交，不能代替磁盘加密、备份清理或云同步检查。
5. 输出只能当作模型生成的表示
Relationship Memory 保存共同经历和时间线，Persona 保存说话风格与行为规则。它们都来自有限资料和用户的主观描述。生成结果可能遗漏、夸大或补出不存在的细节，不能证明真人怎样想，也不能代替本人同意。
如果对话让你更难停止使用、明显影响生活或强化联系当事人的冲动，应停用。官方合规文档也建议在持续低落或出现自伤想法时暂停并寻求专业帮助。
6. 相比 SillyTavern 怎么选
相比 SillyTavern，ex-skill 针对私人关系资料，带有记忆、纠正、回滚和删除命令。SillyTavern 的官方角色文档描述的是通用角色管理：角色包含名称、人物设定和对话历史，可用于单人或群聊。只想写虚构人物或切换多个角色时，通用角色卡更合适，也能避免复刻真实可识别的人。
7. 验证状态与验证边界
验证边界：/create-ex、解析脚本、Anthropic 请求内容、生成文件、回滚、删除和 let-go 均未实测。官方提供 /delete-ex 不代表它会清除原始导出、临时副本、版本存档、备份或服务端记录，使用者必须逐处复查。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
近期变化与关注原因
项目把关系资料整理、人物提示、记忆更新、纠正、回滚与删除做成一套中文命令流程，题材也带来持续搜索。这些累计值不能解释成独立访问人数。
适合谁用
适合在本人控制、相关人员知情同意的前提下做私人关系记录，或用完全虚构的人物测试 Claude Skill 的记忆与 persona 结构。它不适合核实真实人物想法，也不应公开成品、冒充真人或用来联系与影响当事人。若对话加重情绪困扰或影响生活，应停止使用；官方合规文档也给出相同方向的暂停建议。
采用建议
ex-skill 的命令和文件结构完整，但题材直接涉及真实人物、私人通信和照片。适合从虚构人物或已获同意的最少描述开始，先核对生成、删除和网络数据边界。没有明确同意、无法控制资料流向，或使用后情绪状态变差时，不应继续加入私人材料。
原教程未展开的系统信息
核心功能
描述优先的创建流程
运行 /create-ex 后填写代号、基本信息与性格画像，并选择数据来源。官方说明所有字段都可跳过，仅凭用户自己的文字描述也能生成，这也是减少第三方隐私输入的更稳妥做法。
关系记忆与人物风格分层
生成结果分为 Relationship Memory 与 Persona：前者保存共同经历和关系时间线，后者保存身份、说话风格、情感模式与行为规则。模型先判断人物会怎样回答，再从记忆中补充上下文。
更新、纠正与生命周期命令
新增资料可以合并到已有结果，对话中的纠正会写入 Correction 层；项目还提供列表、memory、persona、rollback、delete 和 let-go 命令。
架构与数据流
SKILL.md 是入口，prompts 目录负责资料录入、记忆与人物分析、生成、合并和纠正，tools 目录包含微信、QQ、社交内容与照片元信息解析脚本，以及 Skill 写入和版本管理。生成结果写入本地 exes 目录。宿主是 Claude Code：本地脚本负责文件解析与整理，模型对话请求则通过 Claude Code 发往 Anthropic。
常见问题
ex-skill 必须导入聊天记录和照片吗？
不必。官方 README 说明所有字段都能跳过，仅凭描述也能生成。初次测试应使用自己写的虚构人物，或只用得到明确同意的最少资料。
ex-skill 的数据会不会离开本机？
官方称文件解析和生成文件保存在本地，项目本身没有上传、远程存储或遥测；但同一合规文档明确写明 Claude Code 与 Anthropic API 的对话请求是网络交互。不要把“本地文件”理解成“模型请求完全离线”，应另查账户的数据设置与保留政策。
ex-skill 生成的人物能代表真实的前任吗？
不能。它只根据用户提供的材料与主观描述生成模型表示，可能遗漏、夸大或编造细节。官方也提醒，这个 Skill 只是使用者记忆中的对方，不应拿它判断真人的想法或意愿。
删除 ex-skill 人物后还要检查什么？
官方提供 /delete-ex 命令，但本轮没有实测删除范围。执行后仍应检查 exes 目录、原始导出文件、照片、临时副本、版本存档和备份；模型服务端的请求记录与保留规则要按自己的 Anthropic 账户政策另行确认。