ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

拆解前任.skill 项目架构:SKILL.md + Prompts + Tools 如何协同打造 AI 人格

拆解前任.skill 项目架构:SKILL.md + Prompts + Tools 如何协同打造 AI 人格 拆解前任.skill 项目架构SKILL.md Prompts Tools 如何协同打造 AI 人格【免费下载链接】ex-skill前任 skill项目地址: https://gitcode.com/gh_mirrors/exsk/ex-skillex-skill前任.skill是一个把回忆蒸馏成 AI 人格的开源 Skill 框架导入微信聊天记录、iMessage、短信、照片和社交媒体导出配合你的一句话描述就能生成一个会像她一样说话的 AI Skill。本文将从架构视角拆解它一个 SKILL.md 入口文件、7 个 prompts/ 提示词模板、7 个 tools/ Python 工具如何各司其职地协同工作。项目总览三层架构一图看懂整个仓库只有四个核心部分职责清晰得像一条流水线层级目录角色类比大脑SKILL.md主控流程触发条件、步骤编排、工具调用规则总导演剧本prompts/7 个 Prompt 模板定义怎么分析、怎么生成编剧工具tools/7 个 Python 脚本负责数据解析与版本管理道具组产物exes/生成的每个前任 Skill 的存放目录含示例小美舞台一条消息进来后的运行逻辑是收到消息 → Persona 判断心情和态度 → Memories 提供记忆细节 → 用她的语气输出也就是说她像不像由Persona性格决定她记得什么由Memories共同记忆提供——这两个部分正是整个架构围绕的核心。第一层SKILL.md —— 驱动全流程的主控入口SKILL.md 是整个 Skill 的操作系统文件开头的 frontmatter 遵循 AgentSkills 标准name: create-ex、user-invocable: true、允许的工具白名单让 Claude Code 能识别并调用它。它定义了四大块内容触发条件/create-ex、帮我创建一个前任 skill 等自然语言均可启动对已有 Skill 说这不对/她不会这样则进入进化模式工具使用规则一张对照表明确规定什么任务用什么工具——解析微信走 tools/wechat_parser.py、读 PDF 直接用Read、写入文件用Write/Edit五步主流程基础信息录入 → 原材料导入 → 双线路分析 → 生成预览 → 写入文件进化与管理命令/list-exes列出全部、/ex-rollback回滚版本、/delete-ex删除一个精妙的设计SKILL.md 中大量使用${CLAUDE_SKILL_DIR}变量引用模板与脚本路径这样无论 Skill 安装在项目级.claude/skills/还是全局~/.claude/skills/路径都能正确解析。第二层prompts/ —— 人格蒸馏的灵魂模板prompts/ 目录是本项目最有价值的部分7 个模板覆盖了录入—分析—生成—进化全生命周期1️⃣ 信息录入intake.md只问 3 个问题昵称、基本信息一句话、性格画像一句话全部可跳过。它还内置了依恋类型表安全/焦虑/回避/混乱和恋爱标签库爱撒娇、翻旧账、冷战派……让 LLM 能把你随意写的一句话解析成结构化字段。2️⃣ 双线路分析两个 Analyzermemories_analyzer.md线路 A从原材料中提取关系时间线、共同日常、偏好习惯、冲突模式、情感动态persona_analyzer.md线路 B提取表达风格口头禅、句长、emoji 习惯、情感逻辑、关系行为并内置了一张标签翻译表——把焦虑型翻译成对方回复慢了会反复看手机超过 2 小时发你在干嘛这类具体可执行的行为规则 核心洞察好的 Persona 不写形容词她很敏感而是写行为回消息慢了你会反复看手机。这是真实感的关键。3️⃣ 生成器两个 Buildermemories_builder.md生成memories.md要求有画面感❌你们经常约会 ✅周末去三里屯她每次都要拐去喜茶买多肉葡萄persona_builder.md生成persona.md采用5 层结构下文详述4️⃣ 进化双保险merger.md correction_handler.mdmerger追加新聊天记录时按只增不覆盖原则做增量合并遇到矛盾则输出冲突提示让你决定correction_handler当你说她不会这样时自动识别纠正意图按[场景] 不应该 X应该 Y格式写入 Correction 层立即生效第三层tools/ —— 7 个 Python 工具负责数据管道工具职责亮点wechat_parser.py解析微信导出 txt/html兼容 WechatExporter 格式imessage_parser.py解析 iMessage--direct直接读 macOS chat.dbsms_parser.py解析 Android 短信备份支持 XML/CSVphoto_analyzer.py提取照片 EXIF 元数据纯 Python 解析 JPEG零依赖只取时间线不传内容social_media_parser.py解析微博/豆瓣/小红书/Instagram 导出按平台分发解析策略skill_writer.py写入 Skill 文件、列出已有 Skill内置 SKILL.md 合并模板version_manager.py版本存档与回滚最多保留 10 个历史版本分工哲学很清晰确定性工作解析、归档、回滚交给 Python创造性工作理解、提炼、扮演交给 LLM。照片尤其讲究隐私——只提取日期位置等 EXIF 元数据内容永不离开本地。生成的 Persona5 层结构如何让人格立起来每个前任 Skill 的persona.md由 persona_builder.md 按 5 层结构生成可以对照仓库自带的示例文件 感受效果层级内容示例小美Layer 0核心性格最高优先级行为规则任何情况不得违背生气时已读不回语气从好呀变嗯哦Layer 1身份职业、MBTI、依恋类型、关系背景ENFP、UI 设计师、焦虑型依恋Layer 2表达风格口头禅、句长、emoji 习惯 直接对话示例随便啊→不想吃面→嘿嘿你怎么知道的 Layer 3情感逻辑情感优先级、退缩触发、如何表达不满安全感 被关注 被理解Layer 4/5关系与边界对伴侣/朋友/家人的行为、底线雷区底线拒绝欺骗和敷衍道歉最终 skill_writer.py 把 memories.md persona.md 合并成一份完整的exes/{slug}/SKILL.md并写入运行时规则先由 PART BPersona判断她会不会回什么心情再由 PART AMemories提供相关记忆、日常细节输出时保持 PART B 的表达风格Layer 0 永远优先进化机制让 Skill 越用越像她静态生成只是起点ex-skill 真正的差异化在于持续进化共三条路径追加原材料导入新聊天记录 → merger.md 增量分析 → 备份版本 → 追加进文件 → 重新生成 SKILL.md✏️对话纠正一句她不会这样 → correction_handler.md 生成 Correction 记录写入 Correction 层优先遵守每文件上限 50 条自动归纳合并版本回滚每次更新自动存档到versions//ex-rollback {slug} {version}一键回到任意历史版本由 version_manager.py 实现快速上手3 步安装并创建第一个 SkillStep 1克隆安装以 Claude Code 为例详见 INSTALL.mdmkdir -p .claude/skills git clone https://gitcode.com/gh_mirrors/exsk/ex-skill .claude/skills/create-ex pip3 install -r requirements.txt # 可选依赖Step 2启动创建在 Claude Code 中输入/create-ex回答 3 个问题选择数据来源微信/iMessage/短信/照片/社交媒体/直接粘贴可混用可跳过。Step 3调用你的 Skill/{slug} # 完整版Persona 共同记忆 /{slug}-memories # 仅共同记忆 /{slug}-persona # 仅人物性格效果示例摘自 README.md问她想吃什么先说随便啊你说面她拒绝你说火锅——嘿嘿你怎么知道的 。总结为什么这个架构值得借鉴SKILL.md 做编排Prompt 做认知Tools 做执行——三层职责分离任何一层都可以独立演进把形容词翻译成行为规则——Layer 0 的标签翻译表是人格真实感的核心技巧确定性归脚本创造性归模型——解析回滚交给 Python理解扮演交给 LLM进化闭环设计——追加、纠正、回滚三条路径让 Skill 从快照变成活档案如果你想研究 AI 人格工程Persona Engineering的落地实现ex-skill 的prompts/目录就是最值得逐行阅读的教材。【免费下载链接】ex-skill前任 skill项目地址: https://gitcode.com/gh_mirrors/exsk/ex-skill创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表