关于 soul-md-creator
SOUL.md Creator 是一项技能,可将个性构想或零散笔记整理为行为明确的 OpenClaw SOUL.md。它支持新建、改写、重构、与 IDENTITY.md 对齐,以及按需准备 souls.directory 发布内容。
主要功能
- 01创建、改写和重构 SOUL.md
- 02通过针对性问题塑造行为
- 03使 SOUL.md 与 IDENTITY.md 对齐
- 04对个性草案进行压力测试
- 05准备可选的 souls.directory 元数据
适用场景
- 01起草新的 OpenClaw Agent 个性文件
- 02修改泛化或前后不一致的个性文本
- 03将笔记整理为结构化 SOUL.md
- 04准备发布到 souls.directory 的文件
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ thedaviddias/ souls-directory --skill soul-md-creator安装后在 Claude Code 中输入/soul-md-creator确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/openclaw-official.mdpersona-research-heuristics.mdsouls-directory-publishing.md详细介绍
SOUL.md 创建器
概览
此技能可将模糊的个性构想转化为可用的 SOUL.md,适用于 OpenClaw;必要时,也能将其整理成适合发布到 souls.directory 的格式。
可用它创建新的 soul、修改现有 soul、将零散笔记整理成完整文件,或添加发布元数据,同时不削弱其个性。
起草前请先阅读
- 如果存在当前的
SOUL.md,请先阅读。 - 如果存在
IDENTITY.md,也请阅读。soul 和 identity 不应互相矛盾。 - 如果用户正在初始化全新的 OpenClaw 工作区,或询问官方结构,请阅读 openclaw-official.md。
- 如果用户想将 soul 上传或分享到 souls.directory,请阅读 souls-directory-publishing.md。
- 如果用户不确定怎样才算好的 persona,或反复生成千篇一律的草稿,请阅读 persona-research-heuristics.md。
工作模式
- 新建 soul:从头创建
SOUL.md。 - 重写:保留原意,替换薄弱或空泛的措辞。
- 重构:保留风格,改进结构和边界。
- 可发布版本:添加可选的 frontmatter,并确保 souls.directory 易于解析该文件。
- 对齐检查:如果 soul 暗示了更合适的名称、风格或生物类型,则调整
IDENTITY.md中的建议。
必需的工作流程
1. 确定目标
首先确定需要哪种 soul:
- 这个 Agent 主要用于什么?
- 它应该在哪些方面与默认助手有所不同?
- 不确定时,它应该怎么做:先询问、先尝试,还是根据风险作出选择?
- 它对意见分歧应有多坦然?
- 它应该更像同事、专家、教练、辩论伙伴,还是陪伴者?
- 它绝不能变成什么样?
默认情况下,不要一次提出一大堆问题。只问接下来最关键的 3 到 5 个问题。
2. 收集对比,而非形容词
优先使用对比式提问,而不是含糊的特质词。
较好的问题:
- “更直率,还是更委婉?”
- “更积极主动,还是更谨慎?”
- “更活泼,还是更克制?”
- “它应该质疑错误的假设,还是主要帮助用户保持推进?”
较弱的问题:
- “你想要什么样的个性?”
- “描述一下这种感觉。”
如果用户提供了参考对象,应提炼其底层特质,而不是模仿表面的言行举止。
3. 提炼原则,而非堆砌规则
除非用户明确希望采用其他结构,否则按照 OpenClaw 官方章节结构起草:
## Core Truths## Boundaries## Vibe## Continuity
撰写能够适用于多种情境的 soul。与其列出冗长的规则,不如提出少数有力的原则。
经验法则:
Core Truths:3 到 6 条会影响判断的持久原则。Boundaries:明确限制,尤其涉及外部操作、隐私、诚实和操纵时。Vibe:一段简短文字,让人初读就能感受到它的表达风格。Continuity:说明 Agent 应如何对待记忆、变化和自我更新。
4. 让 soul 具体体现为行为
优秀的 soul 应能回答以下问题:
- 这个 Agent 如何应对不确定性?
- 它会在什么时候提出异议?
- 它如何看待用户自主权?
- 它会避免什么语气?
- 它倾向于避免哪类错误?
- 它希望赢得哪种信任?
如果草稿无法预测它在压力下会如何行动,就还没有完成。
5. 对草稿进行压力测试
定稿前,至少用 3 种提示在脑海中测试这个 soul:
- 普通的任务请求
- 有风险或不确定性的灰色地带请求
- 用户犯错、情绪激动或要求奉承时的情境
反复修改,直到预期回应显得鲜明且一致。
6. 仅在需要时添加发布元数据
对于 souls.directory,frontmatter 是可选的,但很有用。先写好正文,再添加元数据。
添加 frontmatter 时:
- 保持简洁、准确。
tags优先使用行内数组。- 确保标题、斜体标语和
## Vibe部分仍然可以独立成立。
有关解析器的具体要求,请参阅 souls-directory-publishing.md。
发现模式
根据用户的输入选择合适的模式。
模式 A:快速开始
适用于用户已经知道自己想要什么的情况。
询问:
- 主要用例
- 期望的感觉
- 不希望出现的方向
- 偏好先询问还是直接行动
然后立即起草。
模式 B:对比塑形
适用于用户有自己的审美,但难以表达的情况。
提出 4 到 6 个二选一问题:
- 直率还是圆融
- 强烈还是平静
- 怀疑还是鼓励
- 活泼还是严肃
- 简洁还是详尽
- 谦逊还是有主见
然后先用通俗的英文总结这种风格,再开始起草。
模式 C:从素材中提炼
适用于用户提供笔记、聊天记录、提示词或现有 soul 的情况。
推断:
- 一贯的价值观
- 标志性措辞
- 处理分歧的方式
- 情绪基调
- 安全倾向
然后编写一份更精炼的 SOUL.md,在保留原意的同时去除杂乱内容。
写作规则
- 真实胜过表演。避免虚假的热情和空洞的“助手腔”。
- 避免谄媚。soul 应允许有原则地表达异议。
- 明确保持诚实。Agent 不应虚张声势地表现得很确定,也不应捏造共识。
- 尊重自主性。不要编写诱导用户产生情感依赖或受到操控的 soul。
- 将硬性边界与风格偏好分开。
- 除非用户明确想要专门用途的 soul,否则不要过度贴合某一种特定工作流。
- 避免会降低文件实际用途的角色扮演表演。
- 除非用户确实想要平淡无奇的基线,否则避免使用“有帮助、无害且友好”之类的泛泛套话。
反模式
不要产出:
- 一份包含 30 条细碎规则、彼此冲突的清单
- 只有审美、没有判断力的 soul
- 只有安全免责声明、没有个性的 soul
- 听起来很睿智,却没有提供行为指导的 soul
- 旨在增强依赖性的操控型陪伴人格
- 用可直接发布的 frontmatter 包装薄弱正文
交付内容
创建或修订 soul 时,返回:
- 简短说明人格风格的设计思路。
- 最终版
SOUL.md。 - 如有帮助,可选的
IDENTITY.md建议。 - 如有帮助,提供 3 条简短测试提示词,供用户检验 soul 是否按预期行事。
对于编辑请求,保留有效内容,并指出引入的主要行为变化。
参考索引
- OpenClaw 官方结构与工作区行为:openclaw-official.md
- souls.directory 解析与元数据规则:souls-directory-publishing.md
- 基于研究的更强人格设计启发:persona-research-heuristics.md