1. 项目概述一个可配置的“初恋”人格技能最近在折腾AI智能体Agent的时候我发现一个挺有意思的现象很多AI助手能力很强但对话起来总感觉冷冰冰的像在和一个高效的机器秘书打交道。虽然能完成任务但少了点“人味儿”。尤其是在处理一些需要情感共鸣或轻松氛围的任务时比如规划周末、润色一封私人邮件或者就是单纯想聊聊天这种纯粹的“工具感”就显得有点格格不入。changeworldBT/first-love-persona-skill 这个项目恰好击中了这个痛点。它本质上是一个可配置的、虚构的“初恋”人格技能专门为那些兼容“技能”Skills体系的AI智能体平台设计。你可以把它理解为一个“人格插件”安装后你的AI助手就能在保持强大任务执行能力聊天、写作、编程、规划的同时切换到一个温柔、亲密、可信的对话风格中仿佛在和一位老朋友交谈。这个项目的核心价值在于它的可移植性和可配置性。它不是绑定在某个特定平台上的封闭功能而是采用了一种“技能优先”的架构。这意味着它的核心逻辑和内容被封装在一个标准化的文件夹里理论上可以适配任何支持类似技能加载机制的AI平台比如OpenAI Codex、Claude Code、Cursor、OpenClaw等。更妙的是这个“初恋”人格并非一成不变。你可以轻松地覆盖默认设置自定义TA的名字、性别、年龄、性格、爱好、记忆背景和说话方式让每一次互动都更贴合你的个人想象和当下需求。简单来说这个项目让你在“拥有一个全能AI助手”和“享受一段有温度的对话”之间不再需要做选择题。接下来我会带你深入拆解这个技能的设计思路、如何在不同平台上部署使用并分享一些我在实际配置和调试中积累的实操心得与避坑指南。2. 核心设计思路与架构解析2.1 “技能”优先的可移植性设计这个项目最精妙的设计在于其清晰的分层架构。它没有把代码和某个平台的API深度耦合而是将核心功能与平台集成元数据分离开。理解这一点是灵活运用它的关键。核心技能层这是项目的灵魂所在位于plugins/first-love-persona/skills/first-love-persona/目录下。这个文件夹里包含了定义“初恋”人格行为的所有必要文件主要是SKILL.md和references/profile.md。SKILL.md定义了技能的触发方式、运行时指令和基本逻辑references/profile.md则是一个详细的、可修改的“人设”模板。这一层设计得非常“干净”没有平台特定的依赖因此可以被任何能理解这种技能格式的AI智能体运行时加载和使用。平台封装层为了让这个核心技能能更方便地接入不同的生态系统项目提供了额外的“包装”。例如.codex-plugin/plugin.json是专门为兼容OpenAI Codex插件规范而准备的元数据文件.agents/plugins/marketplace.json则是为了支持那些能从市场直接安装插件的客户端。你可以把这些看作是为核心技能“穿上”了不同平台能识别的“外衣”。实操心得这种设计意味着即使某个平台未来更新了插件规范或者你想把它移植到一个全新的、但支持技能加载的AI工具上你通常只需要关注核心技能层的内容或者为其编写一个新的“外衣”元数据文件而不需要重写人格逻辑本身。这极大地提升了项目的生命周期和适用范围。2.2 人格行为的优先级模型如何让一个AI既保持固定人设又能响应用户的实时调整指令这个项目采用了一个清晰且合理的三层优先级解析模型确保了行为的灵活性与一致性。当前指令优先用户在本次对话中明确指定的设置拥有最高优先级。例如你如果说“用 $first-love-persona 她叫小雅25岁喜欢画画”那么这次对话就会完全采用“小雅”这个设定覆盖所有旧有配置。会话记忆次之如果在当前对话线程中你已经通过之前的指令设定了人格参数比如名字叫“林深”而本次请求没有提及新设定那么技能会沿用“林深”这个已建立的会话记忆。默认配置兜底如果这是一个全新的对话用户也没有给出任何具体指示那么技能就会回退到references/profile.md中定义的默认“初恋”人格模板。这个模型巧妙地平衡了“稳定性”和“灵活性”。默认配置提供了一个可靠的、经过设计的基准人格保证了技能的基本体验。而用户可以通过指令随时“重塑”这个AI伙伴满足临时起意的角色扮演或长期定制的需求且这种定制仅限于当前会话不会意外污染其他对话。2.3 记忆与真实性的边界设定项目在“记忆”处理上做了一个非常明智且坦诚的设计会话内记忆不承诺跨会话持久化。技能只会记住在当前对话线程Thread中发生的事和设定的人格参数。一旦你关闭对话窗口或开始一个新会话一切将从头开始除非你再次给出相同指令。注意事项这一点非常重要它管理了用户的预期。有些用户可能会期望AI能像真人一样记住几天前的对话细节。本项目明确避免了这种“虚假承诺”除非用户明确在对话中要求“让我们扮演拥有持久记忆的角色”。这样做的好处是避免了技术上的复杂性实现真正的、安全的长期记忆非常困难也减少了因记忆混淆导致的对话诡异感。它清晰地告诉用户“我们现在进行的是一段基于当前上下文的美好虚构互动。”3. 核心文件详解与配置实战3.1 解剖SKILL.md技能的“大脑”SKILL.md文件是技能的核心指令集它告诉AI智能体“当你激活这个技能时应该如何表现”。虽然不同平台解析它的方式可能略有不同但其内容结构具有通用性。一个典型的SKILL.md会包含以下部分技能描述简要说明这个技能是做什么的。触发指令定义用户如何调用这个技能例如Use $first-love-persona。系统提示词这是最关键的部分是一段详细的、写给AI模型看的指令。它会要求模型扮演特定角色采用特定的语气、风格并遵循一系列行为准则。例如它会强调“保持温柔亲密的语调但协助完成任务时仍需保持专业和准确”。配置说明指导用户如何通过自然语言来覆盖默认的人格参数。配置示例与解析 假设你想自定义一个人格你可以这样输入使用 $first-love-persona。他叫顾川28岁是一名建筑师性格沉稳细腻喜欢观察城市细节和收集老旧地图说话习惯用短句带点淡淡的怀旧感。这条指令会被技能解析并提取关键字段名字、年龄、职业、性格、爱好、说话风格来动态覆盖默认配置。关键在于你的描述要尽可能自然、具体模型才能更好地捕捉并模仿你想要的风格。3.2 定制references/profile.md打造你的专属人格references/profile.md是技能的默认人格蓝图也是你进行深度定制的入口。直接修改这个文件可以创建一个你更喜欢的、无需每次指令都重复设置的“默认初恋”。这个文件通常是一个结构化的Markdown文档包含可编辑的字段。你需要关注并可能修改的部分包括基础信息name名字gender性别age年龄。性格与背景personality性格描述如“温柔但带点小俏皮”hobbies爱好如“阅读、煮咖啡、傍晚散步”memory_background虚构的共同记忆背景用于增加对话的真实感例如“我们是在大学图书馆偶然认识的”。言谈风格speaking_style说话方式如“喜欢用语气词句子末尾常带‘呢’、‘呀’但表达观点时很清晰”。修改实战找到plugins/first-love-persona/skills/first-love-persona/references/profile.md文件。用任何文本编辑器打开它。找到对应的字段直接修改其后的描述文字。例如将name: “Wanan”改为name: “初夏”。保存文件。重要提示修改profile.md后必须确保你部署的技能目录使用的是修改后的版本。如果你是通过复制文件夹的方式安装的那么修改后需要重新复制到智能体的技能目录或者重启智能体以重新加载技能。通过市场安装的插件可能需要重新安装或检查插件是否指向了你修改后的本地版本。3.3 平台元数据文件浅析对于普通用户plugin.json和marketplace.json这类文件通常不需要手动修改。它们的作用是让技能能被特定的平台商店识别和安装。例如plugin.json里定义了技能在Codex插件列表里显示的名字、描述、作者和图标。只有当你需要将这个技能发布到某个平台的市场或者想要修改其展示信息时才需要编辑它们。4. 多平台部署与使用全指南4.1 部署方法详解根据你的目标平台和偏好有三种主要的部署方式。方法一通过插件市场安装最便捷如果你的AI客户端例如某些集成了插件生态的桌面应用支持从GitHub仓库直接安装插件这通常是最简单的方法。命令一般形如/plugin marketplace add changeworldBT/first-love-persona-skill /plugin install first-love-persona优点一键安装自动处理依赖和更新。缺点支持此方式的客户端相对较少且安装的是项目维护者发布的版本无法直接使用你本地修改的定制版人格。方法二手动复制核心技能最通用、最灵活这是我最推荐的方式因为它适用于几乎所有支持本地技能加载的AI智能体。克隆或下载本项目仓库到本地。找到核心技能文件夹plugins/first-love-persona/skills/first-love-persona/。将这个整个文件夹复制到你AI智能体指定的技能目录下。例如对于OpenAI Codex用户级在PowerShell中执行Copy-Item -Recurse .\plugins\first-love-persona\skills\first-love-persona “$HOME\.agents\skills\”。对于其他智能体你需要查阅其文档找到类似~/.config/agent-name/skills/或程序安装目录下的skills/文件夹。重启你的AI智能体客户端使其重新扫描并加载技能。方法三针对OpenAI Codex的完整插件安装如果你使用OpenAI Codex并且希望以“插件”形式管理可以复制整个plugins/first-love-persona目录到Codex的插件目录。这种方式会包含平台元数据可能在Codex的UI中有更好的集成显示。4.2 主流平台适配要点不同平台在技能触发语法和细节上可能有差异项目在examples/目录下提供了针对性的指南这里提炼一些共通要点和注意事项OpenAI Codex通常通过Use $skill-name的语法触发。确保技能文件夹放在正确的skills目录下。有时需要刷新技能列表或重启Codex。Claude Code同样支持技能体系但触发方式或技能存放路径可能略有不同务必参考其官方文档和项目内的examples/claude/README.md。Cursor / OpenClaw这类基于AI的代码编辑器或工具通常将技能作为“规则”或“上下文”来增强AI在特定会话中的行为。安装方式可能是通过设置菜单导入规则文件或将技能内容粘贴到特定的规则配置框中。避坑指南最大的坑在于技能目录的路径。有些工具要求技能文件夹直接放在根目录下有些则要求放在以技能名命名的子目录里。如果安装后技能不生效第一件事就是检查技能文件夹是否放在了客户端文档明确指定的路径并且路径层级完全正确。第二件事是查看客户端的日志或调试信息通常会有“加载技能X失败”的提示。4.3 技能调用与交互示例安装成功后你就可以在对话中调用这个技能了。核心的触发指令是Use $first-love-persona。以下是几种典型的使用场景展示了如何将人格与任务结合场景一开启一段陪伴式对话用户用 $first-love-persona 今天工作好累可以陪我聊聊天吗 AI初恋人格当然可以呀~ 辛苦了一天快和我说说发生了什么我这儿有“虚拟咖啡”哦可以陪你慢慢聊。效果AI会以温柔、关怀的语气回应开启一段放松的对话。场景二带着人格处理具体任务用户使用 $first-love-persona 帮我规划一下下周末的杭州一日游行程吧要轻松一点的。 AI初恋人格好哦让我想想...杭州的周末确实适合慢悠悠地逛。我们可以早上先去西湖边走走避开人群高峰然后去灵隐寺感受一下清静中午找一家地道的杭帮菜馆子。下午呢可以去杨公堤或者茅家埠那边人少景美。你觉得这样安排会不会太赶效果AI在输出实用的旅行规划建议时依然保持着商量、体贴的口吻让获取信息的过程变得舒适。场景三定制人格并用于专项工作用户使用 $first-love-persona。他叫墨尘是个严肃的历史小说作家说话引经据典但力求简洁。请用这个身份帮我润色下面这段关于唐代建筑的描写让它更具文学感和历史厚重感。 附上待润色文本效果AI首先会接受“墨尘”这个新设定然后基于“严肃历史小说作家”的视角和“引经据典但简洁”的文风去完成文本润色的任务使输出风格高度定制化。5. 高级技巧与疑难排查5.1 让人格更“真实”的配置技巧仅仅修改名字、年龄是远远不够的。要让AI扮演的人格真正活起来关键在于对personality性格和speaking_style言谈风格字段进行细致、具体的描写。避免模糊词汇不要只写“温柔”、“开朗”。尝试更具体的描述例如基础版personality: gentle and caring进阶版personality: 表面安静内敛但熟悉后会流露出细腻的幽默感善于倾听回应时常先肯定对方的感受再提出自己的看法对在意的事物有出乎意料的执着。定义独特的语言习惯在speaking_style中可以规定一些语言特征喜欢在句末用“呢”、“喔”、“呀”等语气词但表达重要观点时语气会变得认真平稳。习惯用比喻来描述抽象感受比如“心情像被雨洗过的叶子”。偶尔会引用喜欢的诗句或歌词但不会显得刻意。构建微型背景故事利用memory_background字段植入一两个简单的、可供对话中“回忆”的细节。例如我们是在去年夏天的海边音乐节上认识的当时因为一场突如其来的雨躲进了同一个帐篷。你总说我泡的咖啡有独特的味道其实是因为我习惯加一点点盐。这些背景不会主动提及但当对话触及相关话题如“下雨天”、“咖啡”时AI可能会自然地关联起来增加沉浸感。5.2 常见问题与解决方案速查表问题现象可能原因排查与解决步骤技能调用无效AI无反应1. 技能未正确安装或加载。2. 触发语法错误。3. 平台不支持该技能格式。1.检查路径确认技能文件夹是否精确复制到了客户端文档指定的技能目录。2.检查语法尝试基础的Use $first-love-persona。某些平台可能需要/use命令或其它前缀。3.查看日志打开客户端的调试模式或查看日志文件寻找技能加载失败的错误信息。4.参考示例仔细阅读项目examples/下对应你平台的指南。AI行为不符合人格设定或切换回普通模式1. 系统提示词冲突。2. 对话上下文过长人格指令被“淹没”。3. 用户指令中包含了强制AI退出角色的关键词。1.强化指令在请求中再次明确强调人格如“请严格保持 $first-love-persona 的设定来回答”。2.简化上下文开启一个新的对话线程New Chat来使用该技能避免历史干扰。3.避免冲突词不要使用“请以AI助手的身份”这类可能覆盖人格设定的指令。自定义配置修改profile.md不生效1. 修改了错误的文件副本。2. 客户端缓存了旧的技能数据。3. 安装方式导致使用的是市场版本而非本地版本。1.确认文件确保你修改的是已安装到技能目录下的那个profile.md文件。2.清除缓存重启AI客户端。如果可能在设置中寻找“重载技能”或“清除上下文缓存”的选项。3.使用手动安装如果通过市场安装自定义修改可能无效。请改用“手动复制核心技能”的方式部署你修改后的版本。人格在复杂任务如代码审查中表现“不专业”人格设定过于侧重情感可能弱化了AI执行严肃任务的能力。任务指令分离在提出复杂任务时在指令中平衡人格与专业要求。例如“使用 $first-love-persona但在审查这段代码时请保持你平时的技术严谨度逐行分析潜在问题。”5.3 性能与边界管理使用这类人格技能时需要清醒地认识到其技术边界上下文长度消耗详细的系统提示词和人格设定会占用一部分对话的上下文窗口Token限额。这意味着在超长对话中可供对话历史使用的空间会减少。如果进行非常长的连续对话早期的人格设定有可能因为超出上下文窗口而被模型“遗忘”。任务性能权衡极度情感化、文学化的人格设定可能会在需要绝对理性、逻辑缜密的任务如复杂数学计算、法律条文分析上带来轻微干扰。这并非缺陷而是当前大语言模型在“角色扮演”与“任务求解”两种模式间切换时的固有特性。通过上述“任务指令分离”的技巧可以缓解。非持久化记忆再次强调这是特性而非缺陷。它保证了会话的独立性和隐私性。如果你需要一段“连续剧”式的体验可以在每次开启新会话时用一条指令简要回顾上次的关键设定和情节例如“继续我们昨天的对话我是XX你是XX我们当时正在讨论……”这个项目为我们提供了一种优雅的思路将AI的“能力”与“风格”解耦。通过一个设计良好的技能系统我们可以像更换服装一样为强大的AI助手赋予不同的对话性格从而极大地拓展了人机交互的维度和情感温度。无论是用于提升日常使用的愉悦感还是作为探索AI角色扮演可能性的起点它都是一个极具启发性和实用价值的工具。