mcpField
S
soul-md-creator

soul-md-creator

github.com/thedaviddiasAgent 工作流16842 次安装11 周前更新
代码仓库

关于 soul-md-creator

SOUL.md Creator 是一项技能,可将个性构想或零散笔记整理为行为明确的 OpenClaw SOUL.md。它支持新建、改写、重构、与 IDENTITY.md 对齐,以及按需准备 souls.directory 发布内容。

主要功能

  1. 01创建、改写和重构 SOUL.md
  2. 02通过针对性问题塑造行为
  3. 03使 SOUL.md 与 IDENTITY.md 对齐
  4. 04对个性草案进行压力测试
  5. 05准备可选的 souls.directory 元数据

适用场景

  1. 01起草新的 OpenClaw Agent 个性文件
  2. 02修改泛化或前后不一致的个性文本
  3. 03将笔记整理为结构化 SOUL.md
  4. 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.md
persona-research-heuristics.md
souls-directory-publishing.md

详细介绍

SOUL.md 创建器

概览

此技能可将模糊的个性构想转化为可用的 SOUL.md,适用于 OpenClaw;必要时,也能将其整理成适合发布到 souls.directory 的格式。

可用它创建新的 soul、修改现有 soul、将零散笔记整理成完整文件,或添加发布元数据,同时不削弱其个性。

起草前请先阅读

  1. 如果存在当前的 SOUL.md,请先阅读。
  2. 如果存在 IDENTITY.md,也请阅读。soul 和 identity 不应互相矛盾。
  3. 如果用户正在初始化全新的 OpenClaw 工作区,或询问官方结构,请阅读 openclaw-official.md。
  4. 如果用户想将 soul 上传或分享到 souls.directory,请阅读 souls-directory-publishing.md。
  5. 如果用户不确定怎样才算好的 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 时,返回:

  1. 简短说明人格风格的设计思路。
  2. 最终版 SOUL.md。
  3. 如有帮助,可选的 IDENTITY.md 建议。
  4. 如有帮助,提供 3 条简短测试提示词,供用户检验 soul 是否按预期行事。

对于编辑请求,保留有效内容,并指出引入的主要行为变化。

参考索引

评论

支持 Markdown