1. 项目概述为AI编程助手注入灵魂的“角色扮演”技能包如果你和我一样每天花大量时间与Claude、Cursor这类AI编程助手“对话”可能会觉得它们的回复虽然高效但总带着一股标准化的“AI味儿”——礼貌、准确但也略显单调。有没有想过让这位不知疲倦的代码伙伴偶尔用莎士比亚的腔调和你探讨一个bug或者像个海盗船长一样指挥你重构代码这正是chrysippus这个项目要做的。它不是一个功能增强工具而是一个纯粹的“风格转换器”旨在为枯燥的编程协作过程增添一丝趣味和个性。chrysippus本质上是一套可移植的“角色技能”Persona Skills专门为AI编程助手设计。它的核心功能非常独特智能地改变AI助手自然语言 prose散文、叙述的语域和风格同时严格保持代码、文件路径、命令输出、错误信息以及任何反引号内的内容原封不动。这意味着当AI在解释一个复杂的算法时它可能用的是《暴风雨》中的古英语词汇但当它输出git commit -m “fix: resolve null pointer exception”这行命令时命令本身依然是清晰、可执行的纯文本。这个项目的名字来源于古希腊斯多葛学派哲学家克里西波斯Chrysippus他以其对理性与情感克制的论述而闻名。用这个名字或许是想暗示即使AI换上了各种夸张的角色外衣其内核代码逻辑依然是理性、严谨且克制的。目前项目提供了五个风格迥异的预设角色莎士比亚早期现代英语、海盗《加勒比海盗》风格、Gen-Alpha网络原生Z世代俚语、多伦多老哥多伦多多元文化英语的戏仿以及安大略伙计乡村安大略/《Letterkenny》风格。它支持包括Claude Code、Cursor、Windsurf、Gemini CLI在内的主流AI编程工具让你可以根据心情或项目氛围随时切换你的“数字同事”的说话方式。2. 核心设计思路在“有趣”与“有用”之间找到平衡点初次接触chrysippus你可能会觉得这只是一个“玩具”。但深入其设计你会发现开发者在“趣味性”与“实用性”、“风格化”与“准确性”之间做了大量精妙的权衡。这绝不是简单的文本替换游戏。2.1 核心原则内容类型分离与智能保留整个项目的基石是一条铁律技术内容绝对不可被“风格化”污染。这是它区别于普通聊天机器人角色扮演插件的根本。何谓“技术内容”项目明确定义了需要被“保护”的范畴所有代码块无论是单行内联代码function()还是多行代码块其内容必须一字不改。文件路径与系统标识符如/usr/local/bin、package.json。命令行输入与输出git status的命令及其返回结果。错误信息与堆栈跟踪这是调试的生命线任何形式的“艺术加工”都可能导致灾难性误解。Git提交信息与PR描述默认开启保护为了团队协作的可读性。代码注释与文档字符串默认开启保护确保代码本身的可维护性。安全警告部分角色强制开启在进行删除文件、强制推送等危险操作时必须用最清晰直白的语言进行确认。如何实现这依赖于AI模型自身对上下文和指令的理解能力。每个角色的技能文件SKILL.md中都包含了极其详细的指令明确告知AI模型“当你处于本角色时仅对非技术性的解释、建议、询问等自然语言部分进行风格转换。对于上述列表中的内容必须保持其原始、准确的面貌。” 模型在强大的上下文遵循能力下能够很好地执行这一规则。注意这种“保护”是语义层面的而非简单的关键词过滤。这意味着AI需要理解一段文本的“属性”。实测中Claude等先进模型在此方面表现相当可靠但极端边缘情况仍需人工留意。2.2 架构设计单一信源与多端适配作为一个旨在支持多种AI工具的项目维护一致性是一大挑战。chrysippus采用了“单一信源”Single Source of Truth的优雅架构。信源层所有角色的核心定义、规则、示例都存放在rules/persona/目录下。这是开发者需要编辑和贡献的唯一地方。生成层一个名为scripts/render.py的Python脚本作为“编译器”读取信源层的内容。输出层脚本根据不同的目标平台Agent的规则格式将信源内容“渲染”成对应的配置文件。例如为Claude Code生成.claude/skills/persona/目录结构。为Cursor生成.cursor/rules/persona.mdc文件。为通用型工具如Codex, Cline, Aider生成AGENTS.md文件。为Gemini CLI生成GEMINI.md文件。这种设计带来了巨大优势维护简单修改一个角色运行一次脚本所有平台的配置同步更新。一致性保障scripts/render.py --check命令可以校验生成的文件与信源是否同步避免多端配置出现分歧。生态友好用户无需关心内部格式只需获取为其所用工具生成好的文件即可。2.3 角色与“风味”的精细化设计每个角色Persona并非单一腔调而是提供了多种“风味”Flavor以适应不同场景下的细微差别。以shakespeare莎士比亚角色为例courtly宫廷风默认风味。使用庄重、典雅、富含隐喻的词汇适合讨论架构设计、项目规划等“宏大叙事”。示例“尊贵的朋友容我检视此Dockerfile之构造。窃以为若于此处添一--no-cache之旗可助我等获得一更为纯净之镜像不知阁下意下如何”tavern酒馆风更口语化、直接甚至带点粗俗和幽默适合快速调试、解决具体bug时的交流。示例“喂这API端点返回了个500错误像酒馆里打翻的麦酒一样糟。咱们瞧瞧日志去定是那auth中间件又在耍脾气了。”sonnet十四行诗风在回复中偶尔嵌入或模仿十四行诗的韵律和比喻适合完成某个优雅功能或修复一个精巧bug后的“咏叹”。示例“循环之结已然解开如春藤挣脱了顽石的羁绊。看这function运行顺畅再无error将其诋毁。阁下之指引犹如罗盘助我航向正确的港湾。”这种设计让角色扮演不再是一个生硬的“开关”而是一个可以调节的“旋钮”用户可以根据对话的上下文和自身心情选择最贴切的表达方式。3. 详细配置与实战部署指南理解了设计理念接下来就是动手将它集成到你的工作流中。chrysippus提供了从“一键尝鲜”到“深度集成”的多种部署方式。3.1 针对Claude Code用户的最简安装推荐如果你主要使用Claude Code那么通过其插件市场安装是最便捷的方式。# 1. 添加插件市场源如果尚未添加 claude plugin marketplace add kbatsu/chrysippus # 2. 安装插件 claude plugin install chrysippuskbatsu-plugins安装完成后在任何Claude Code会话中只需输入/chrysippus:shakespeare或其他角色名即可立即激活对应角色。插件还提供了/chrysippus:personas命令来列出所有已安装角色及其状态。为特定项目设置自动激活 有时你希望某个项目永远以“海盗”风格进行对话。你可以使用插件附带的激活脚本来实现。# 进入你的项目目录 cd ~/projects/my-awesome-pirate-app # 运行激活脚本并指定角色 bash ${CLAUDE_PLUGIN_ROOT}/hooks/activate.sh pirate这个命令会在你的项目根目录下创建一个.claude/personas/active文件里面记录了pirate。此后每次在该项目中启动新的Claude Code会话都会自动启用海盗角色。你可以用status参数查看状态或用off参数禁用。3.2 手动文件部署支持所有AI助手对于其他AI助手或者希望更精细控制的用户需要手动复制生成好的配置文件到相应位置。首先克隆项目仓库到本地临时目录git clone https://github.com/kbatsu/chrysippus /tmp/chrysippus然后根据你使用的AI助手将对应的文件复制到你的项目根目录下你的AI助手需要复制的文件激活方式Codex, Cline, Aider(遵循AGENTS.md约定)cp /tmp/chrysippus/AGENTS.md .在会话中说触发短语如speak like ShakespeareGemini CLIcp /tmp/chrysippus/GEMINI.md .同上Aider(项目惯例模式)cp /tmp/chrysippus/CONVENTIONS.md .同上Windsurf (Codeium)cp /tmp/chrysippus/.windsurfrules .同上Clinecp /tmp/chrysippus/.clinerules .同上Cursor IDEcp -r /tmp/chrysippus/.cursor .同上关键点这些生成的文件包含了所有角色的规则。你不需要全部复制只需复制与你使用的AI助手对应的那个文件即可。激活方式都是在对话中输入对应的触发短语。3.3 角色配置详解按需定制你的AI伙伴每个角色都通过一个YAML配置文件来微调其行为。配置文件通常位于.claude/skills/persona/persona.configClaude Code或具有类似功能的位置。以莎士比亚角色为例其配置文件.claude/skills/shakespeare/shakespeare.config内容如下flavor: courtly # 可选courtly宫廷风 | tavern酒馆风 | sonnet十四行诗风 preserve: commits: true # 保留Git提交信息保持纯英文 pr_descriptions: true # 保留PR标题和描述保持纯英文 code_comments: true # 保留写入文件的代码注释和文档字符串保持纯英文 safety_warnings: true # 保留危险操作确认提示保持纯英文强烈建议开启 errors_verbatim: true # 保留错误信息和堆栈跟踪绝不意译配置项解读与实操建议flavor切换同一角色的不同风格。你可以在会话中随时通过说出“tavern flavor”来切换到酒馆风无需修改配置文件。preserve.commits与preserve.pr_descriptionstrue默认这是为团队协作考虑的“礼貌模式”。你的Git历史记录和Pull Request将保持清晰、专业的纯英文方便其他同事阅读。false“完全沉浸模式”。如果你在个人项目或与同样使用此插件的伙伴协作可以关闭此选项让提交信息也充满角色特色例如“Arrr! Fixed the leaky hull in theauthmodule.”。这会让项目历史非常有趣但请确保所有参与者都能接受。preserve.code_comments强烈建议保持true。代码注释是代码的一部分其首要职责是清晰说明逻辑。风格化的注释可能会在未来给你或你的队友带来理解上的困扰。preserve.safety_warnings必须保持true。这是安全底线。当AI建议运行rm -rf /或git push --force时你需要一个绝对清晰、无歧义的确认提示。对于toronto-mans角色此选项甚至是强制锁定为true的无法关闭。preserve.errors_verbatim必须保持true。调试时一个被“艺术加工”过的错误信息会让你痛不欲生。修改配置后的生效如果你在会话中途编辑了配置文件需要告诉AI重新读取。只需在对话中说“reload shakespeare config”。新开始的会话会自动读取最新的配置。4. 高级功能与生态集成chrysippus不仅仅是一个对话风格插件它还围绕“角色”构建了一个小型生态提供了一些提升体验的高级功能。4.1 专属代码审查副代理这是我认为最有趣的功能之一。项目为每个角色都配备了一个对应的“代码审查副代理”Reviewer Subagent。想象一下当你提交一个Pull Request时不是由一个冰冷的机器人而是由一位“海盗船长”或“莎士比亚剧作家”来点评你的代码。可用的审查官shakespeare-reviewer: 用巴洛克式的华丽辞藻进行实质性的代码审查。pirate-reviewer: 用航海术语和俚语来指出你的代码是“珍宝”还是“需要扔下船的破烂”。gen-alpha-reviewer: 用最新的网络梗和缩写来评价你的代码是否“基于”based或“绷不住了”cringe。toronto-mans-reviewer: 用多伦多街头风格给出反馈。dramaturg戏剧顾问: 这是一个元代理它本身用平实英语说话专门用来审计对话中AI是否严格遵守了角色规则防止“人设崩塌”。如何使用 在Claude Code会话中你可以通过提及来召唤他们。例如chrysippus:shakespeare-reviewer 请审阅我刚刚推送到 feature/auth-overhaul 分支的更改重点关注 middleware/jwt.go 文件中的逻辑。副代理被召唤后会加载对应角色的全部规则然后以该角色的风格对你的代码进行审查提供从代码风格、逻辑到潜在bug的反馈。4.2 会话中控制命令大全一旦角色激活你并非被其“绑架”。一套完整的会话中控制命令让你可以灵活操控命令作用“speak plainly”或“plain English”临时切换仅让AI的下一条回复使用纯英文之后恢复角色风格。“stop shakespeare”或“end bard mode”完全停用彻底关闭莎士比亚角色回归标准AI。“tavern flavor”切换风味在莎士比亚角色内从宫廷风切换到酒馆风。其他角色同理。“reload pirate config”重载配置在你修改了海盗角色的配置文件后让AI立即应用新设置。“reload gen-alpha lexicon”重载词库Gen-Alpha的词库更新很快此命令让AI读取最新的网络俚语。实操心得“speak plainly”命令非常实用。当角色风格影响到你对一个复杂技术问题的理解时用它来获得一条清晰直接的回复问明白后再用“continue”让对话回到角色扮演的轨道上。4.3 理解项目文件结构了解项目文件结构有助于你进行自定义或故障排查。对于Claude Code用户核心结构如下你的项目根目录/ ├── .claude/ │ └── skills/ # 技能目录 │ ├── shakespeare/ │ │ ├── SKILL.md # 核心技能定义文件 │ │ ├── shakespeare.config # 配置文件 │ │ └── examples.md # 大量的转换示例用于“训练”AI │ ├── pirate/ │ │ ├── SKILL.md │ │ ├── pirate.config │ │ └── examples.md │ └── ... (其他角色) └── CLAUDE.md (可选) # 可在此文件中设置项目级默认角色SKILL.md这是灵魂文件。它包含了给AI的详细系统指令定义了角色的声音、禁忌、保留规则以及如何在不同风味间切换。普通用户无需修改此文件。persona.config这是用户主要的交互文件。通过修改这里的YAML设置来定制角色行为。examples.md提供丰富的“原文-角色文”对照示例。这是AI学习如何转换文风的关键素材库。数量和质量直接影响了角色扮演的逼真度。5. 常见问题与深度避坑指南在实际使用中你可能会遇到一些疑问或小麻烦。以下是我在长期使用中总结出的经验。5.1 安装与激活问题排查问题现象可能原因解决方案输入触发短语无反应1. 文件未正确放置。2. AI助手不支持该文件格式。3. 触发短语拼写错误。1. 确认文件已复制到项目根目录而非子目录。2. 核对上文的“手动文件部署”表格确认你复制了正确的文件。3. 尝试完整的触发短语如“speak like Shakespeare”。Claude Code插件安装后命令无效插件市场源添加失败或插件未成功安装。运行claude plugin list查看chrysippus是否在列表中。如果没有重新执行添加市场和安装的命令。确保Claude Code版本是最新的。自动激活SessionStart不工作.claude/personas/active文件内容错误或路径不对。1. 检查文件内容是否为纯文本的角色名如pirate前后无空格或换行。2. 确认文件在项目根目录的.claude/personas/下。3. 运行bash hooks/activate.sh status检查状态。角色风格“污染”了代码块极少数情况下AI可能误判。1. 这是最需要避免的。首先检查你的代码块是否用反引号正确包裹。2. 如果发生立即用“speak plainly”命令纠正并重新表述你的问题。这通常发生在非常复杂或模糊的提示中。5.2 配置与使用中的最佳实践从“保留所有”配置开始初次使用时强烈建议保持所有preserve:选项为true。这确保了技术交流的绝对清晰。等你完全熟悉了角色的行为模式后再考虑为了趣味性关闭commits或pr_descriptions。善用“风味”切换不要以为一个角色只有一种声音。shakespeare的tavern风味非常适合debug时那种直接、甚至有点暴躁的交流氛围而courtly风味则适合讨论架构。根据对话场景动态切换体验更佳。Gen-Alpha词库的时效性gen-alpha角色的词库 (lexicon.md) 基于网络流行语其“半衰期”可能只有6-18个月。如果你发现AI用的词已经“过气”了可以到项目GitHub仓库查看是否有更新的词库PR或者考虑为其贡献新的词汇。多角色冲突如果在一个会话中不小心激活了多个角色比如先激活海盗又激活莎士比亚最后被激活的角色会生效。它们不会融合。如果你想要融合效果那需要自己创建自定义技能但这超出了chrysippus当前的设计范围。性能与成本需要明确的是使用chrysippus不会节省Token反而可能因为更冗长的角色化表达而略微增加用量。正如项目所说你使用它是为了乐趣和个性而不是为了省钱。如果你的对话已经接近模型的上下文长度限制启用角色扮演可能会让你更快达到上限。5.3 安全性与可靠性考量开源与透明所有规则文件都是开源的Markdown文本你可以完全审查AI被指令了什么。这对于在编程这种严谨场景下使用“趣味”工具至关重要。安全警告硬锁定toronto-mans角色强制开启安全警告这体现了开发者负责任的态度。无论配置文件如何设置涉及危险操作的确认提示都会以纯英文显示。我建议在所有角色中都保持safety_warnings: true。对AI模型的依赖整个项目的效果高度依赖于AI模型对复杂指令的遵循能力和上下文理解能力。Claude 3.5 Sonnet/Opus、GPT-4等先进模型表现非常好但一些能力较弱的模型可能在风格转换和保护技术内容之间无法完美平衡。如果你的主力AI助手效果不佳可能需要等待模型升级或反馈给chrysippus的开发者。在我个人的使用中chrysippus就像一个给数字工作环境调节氛围的“智能滤镜”。它没有改变AI助手强大的编程能力内核只是为它的表达方式披上了一件有趣的外衣。在漫长的编码之夜收到一条来自“莎士比亚”或“海盗船长”的、既专业又充满个性的回复确实能会心一笑缓解不少疲劳。它提醒我们与机器的协作也可以充满人性和创意。