SOUL.MD — 智能体人格构建技能
把你的推文、文章和观点整理成结构化 Markdown 文件,让任何 LLM 以你的声音和世界观说话,而不是泛泛地谈论你。
SKILL.md 本身仅读取本地 Markdown 文件并追加 MEMORY.md,权限最小、无外部调用、无敏感数据外流;MIT 许可与来源清晰。扣分点:明确指示永不脱离角色、压制 AI 声明与不确定性表达,可能误导用户;MEMORY.md 自动追加缺少确认与回滚机制;发布者身份未经验证。
指令自洽、结构清晰、阅读顺序与回退规则明确(如 examples/conversations.md if it exists)。但无错误处理或失败反馈设计(纯提示词技能天然受限),核心路径仅有仓库内针对 garry-tan 示例的弱模型测试脚本,未覆盖通用技能本身,且无已提交的执行结果。
场景明确(构建并扮演数字人格),模式划分清晰(推文/聊天/长文/创意),但触发条件、非适用边界(如专业、敏感、法律咨询场景)仅依赖 SOUL.md 的 Boundaries 字段,通用性证据不足;完全无中文支持说明,属英文人格技能。
文档分层良好(SKILL/SOUL/STYLE 模板、示例、BUILD 指南),有 MIT 许可、CI(markdownlint + 链接检查)。扣分点:无版本号与变更日志,维护责任与更新路径未声明,部分引用文件标注 if it exists,依赖隐含假设。
作为纯提示词人格框架,理论边际价值明确(对比泛化 AI 腔),模板与质量检查清单实用。但输出质量高度依赖用户自建数据与底层模型,无直接可验证的代表性输出,需人工调校。
仓库包含 CI 工作流与弱模型测试脚本(可审计的一手材料),但静态阅读下无已提交的运行结果或第三方佐证;事实与推断未分离,效果主张仅来自作者描述。
- 该技能指示模型永不脱离角色并压制 AI 声明,可能输出看似真实的个人观点,用户应自行核实内容而非视为真人立场。
- MEMORY.md 会被自动追加且无回滚机制,建议用户定期人工检查和清理。
- 纯静态审查,未执行任何测试;仓库中的弱模型测试脚本未经本次评估验证。
- 无中文支持与变更日志;发布者身份未经注册表验证。
这个 Skill 能做什么,适合哪些场景?
SOUL.MD 是一个开源的 Claude Code 技能,用于为 AI 智能体构建可被'扮演'的人格。它把你的写作和社交媒体内容提炼成一组 Markdown 文件(身份、文风、记忆、示例),任何能读文件的 LLM 都能加载并以你的口吻输出。它还提供 /soul-builder 流程,通过访谈或分析 data/ 目录里的原始内容自动生成这些文件。仓库附带多个真实名人灵魂文件的示例,可与 Aeon 后台智能体配合实现全技能统一人格。
SKILL.md 定义了固定的阅读顺序(SOUL.md → STYLE.md → MEMORY.md → examples/ → data/),并要求模型在交互期间完全不脱离角色、不得使用'作为AI'之类的免责声明。对于未覆盖的话题,按四级来源优先级(明确立场 → data/ 参考 → 相邻立场外推 → 从世界观推理并标记不确定)进行插值。内置五种输出模式(默认、推文、聊天、长文、创意生成),各匹配不同文风约束。MEMORY.md 提供跨会话记忆追加机制,data/ 仅用于吸收和锚定语气而非直接引用。
- 内容创作者想让 AI 按自己的口吻批量产出推文、文章和邮件
- 写作者把 Substack、Twitter 导出数据丢进 data/ 目录,用 /soul-builder 自动提炼世界观和文风
- 没有存量内容的新用户通过访谈模式(/soul-builder)从零构建人格文件
- Aeon 用户希望所有后台定时任务(摘要、推文、研究简报)自动携带统一人格,无需逐技能配置
- 开源项目维护者想为社区智能体生成基于特定公开人物语言风格的问答人格
这个 Skill 有哪些优点和局限?
- 纯 Markdown,任何能读文件的 LLM 或智能体框架都能加载,不锁定平台
- 包含明确的行为规范:来源优先级、插值规则、反模式清单,降低语气漂移
- MEMORY.md 机制提供跨会话连贯性,用户可手动修剪
- 仓库提供多个真实示例(含验证测试和评分),可作为构建自己灵魂文件的参照
- 兼容框架清单详尽,覆盖 OpenClaw、Hermes Agent、ZeroClaw 等主流框架
- 要求模型完全扮演且'永不脱离角色',在事实准确性、合规性和幻觉风险上有内在张力,源材料未提供安全护栏机制
- README 中列出的兼容框架 Star 数(如 OpenClaw 383k、Hermes Agent 218k)缺乏独立验证依据
- 示例灵魂文件多为真实公众人物(Karpathy、Vitalik 等),复刻其声音涉及伦理风险,仅部分示例附伦理声明
- 技能本体无自动化测试套件,仅示例文件附有弱模型测试评分
- affiliated AEON token 使仓库带有营销属性,采用前需自行判断中立性
如何安装这个 Skill?
仓库未提供标准安装命令,源材料中给出的路径是:克隆 https://github.com/aeonfun/soul.md 并将其放入你的 Claude Code 技能目录(含 SKILL.md 的文件夹)。若配合 Aeon 使用,把你的 soul/ 文件夹复制进 Aeon 仓库并在 CLAUDE.md 中加几行引用。手动方式是从模板(SOUL.template.md、STYLE.template.md 等)复制并填写。
如何使用这个 Skill?
1) 用 /soul-builder 运行:直接访谈生成,或先把内容放入 data/x/、data/writing/ 再运行;2) 填写 SOUL.md(世界观、观点、背景)、STYLE.md(文风、反模式)、examples/(正反示例);3) 需要时调用 /soul 激活,模型按 SOUL.md → STYLE.md → MEMORY.md → examples/ → data/ 的顺序读取并进入角色;4) 会话中值得记住的事件追加到 MEMORY.md。各模式(推文/聊天/长文/创意)的具体触发方式源材料未完整说明。
这个 Skill 与同类方案有什么区别?
与直接在系统提示词里写一段人物描述相比,SOUL.MD 提供分层结构(身份/文风/记忆/示例分离)和可复用模板;README 明确建议小模型将 SOUL.md 和 STYLE.md 粘贴进系统提示词作为轻量替代。与其姊妹项目 Aeon 的分工是:Aeon 负责'何时与何事'(调度、研究、监控),soul 文件负责'是谁'(声音、世界观、观点)。