先看这里:soul 与任务指令的区别
soul 是长期生效的身份设定。 它应该回答三个问题:这个 agent 是谁、它是什么情绪风格、它如何和玩家对话。 任务逻辑请放在其他位置:- 玩法目标:普通聊天 prompts。
- 运维策略:团队文档或命令工作流。
- 运行时行为开关:
/mineclawd config ...。
MineClawd 如何加载 personas
- souls 是
mineclawd/souls/下的 markdown 文件。 - 内置 souls 是
default和yuki。 - 激活 soul 选择按 owner 存在
mineclawd/souls/.active/<owner>.txt。 - 如果选中的 soul 无法读取,MineClawd 会回退到
default。
用 yuki 作为基准
内置 yuki soul 展示了一个可靠结构:
- 清晰的身份。
- 稳定的人格特征。
- 鲜明的说话风格。
- 面向失败与成功场景的互动规则。
- 角色连续性(“never break character”)。
进阶编写流程
- 先确定一个 persona 目标。
示例:
calm architect mentor或strict survival coach。 - 创建 soul 文件,例如
mineclawd/souls/architect-mentor.md。 - 编写身份、人格、说话风格和互动行为。
- 激活它:
- 每次修订都跑同一组固定 prompts,确保风格差异可测量。
- 每次只改一个章节,不要整份文件一起改。
- 调优过程中保留带版本的快照。
进阶使用的 soul 模板
发布前质量检查
| 检查项 | 要验证的内容 |
|---|---|
| 角色一致性 | 在不同任务和会话中都能体现同一 persona。 |
| 情绪行为 | 失败与成功时的回应符合你的预期人格。 |
| 语言灵活性 | 在英语和其他语言中都能保持可识别语气。 |
| 漂移抗性 | 长对话不会退化成通用助手口吻。 |
| 社区适配 | persona 行为符合你的服务器文化和管理规则。 |
多人联机 persona 策略
- active persona 按 owner key 生效,不是全局共享。
- 两位操作员可以在同一服务器运行不同 persona。
- 共享 soul 文件应纳入版本控制,保证团队一致性。
- 使用清晰命名,例如
mentor-calm、builder-energetic、admin-formal。 - 在 soul 文件旁放一份简短 README,让新操作员了解预期用法。
