catalog/repos/aaronjmars--soul-md.md

8.0 KiB
Raw Blame History

AI人格灵魂文件构建器

AI代理 个人化 身份建模 Claude Code Markdown

SOUL.md

SOUL.MD

为你的 AI 代理构建人格的最佳方式。
让 Claude Code / OpenClaw 摄取你的数据,构建你的 AI 灵魂。


这是什么?

Soul Identity

灵魂文件以 AI 代理可以具身化的格式捕捉你是谁。不是一个谈论你的聊天机器人——而是一个以你的方式思考和说话的 AI。

把你的推文、文章和帖子丢进一个文件夹。代理读取所有内容,提取你的世界观和语言风格,并构建一组任何 LLM 都可以加载、以你的方式写作的 Markdown 文件。

目标:读过你的 SOUL.md 的人应该能预测你对新话题的看法。如果做不到,说明文件太模糊了。

使用场景:

  • 从你的世界观出发生成想法
  • 写出听起来像你的内容(推文、文章、邮件)
  • 将 AI 定制为符合你的兴趣和思维模式
  • 为内容创作、回复和头脑风暴复刻自己

快速开始

Soul Builder Flow

方式一 — 从零构建

/soul-builder

代理对你进行访谈:世界观、观点、写作方式、你在乎什么。

方式二 — 从你的数据构建

将你的内容放入 data/

data/x/          ← Twitter/X 导出
data/writing/    ← 博客文章、随笔

然后运行 /soul-builder。它会分析你的数据,提取模式,并起草你的灵魂文件。你来审阅并共同完善。

方式三 — 手动填写

复制模板并填写:

SOUL.template.md  → SOUL.md
STYLE.template.md → STYLE.md
SKILL.template.md → SKILL.md

数据来源

Soul Sources

把你写过的任何内容喂给构建器。信号越多,输出越精准。

类别 平台
社交 Twitter/X、Bluesky、Farcaster、Mastodon、Threads、LinkedIn、Reddit
写作 Substack、Medium、Ghost、WordPress、Mirror.xyz、Paragraph.xyz
即时通讯 Discord、Telegram、Slack、iMessage 导出
笔记 Notion、Obsidian、Roam Research、Logseq、Apple Notes
视频/音频 YouTube 字幕、播客文字稿、Loom 录制
代码/开发 GitHub 活动、Hacker News 评论、Stack Overflow 回答
其他 PDF、纯文本、CSV/JSON、RSS 订阅、GDPR 数据导出

没有现成数据?方式一(访谈模式)依然可以从零构建出完整的灵魂文件。


兼容框架

灵魂文件是纯 Markdown——只要代理能读取文件就能具身化你。已测试框架

框架 语言 Stars
Aeon YAML/Markdown
OpenClaw TypeScript 322k
Nanobot Python 34.6k
ZeroClaw Rust 27.8k
PicoClaw Go 25.3k
NanoClaw TypeScript 24k
OpenFang Rust 14.9k
IronClaw Rust 10.4k
Hermes Agent Python 8.7k
Claude Code · OpenCode · Codex · Goose 多种

也可通过系统提示与任意模型配合使用——参见与其他工具配合使用


文件结构

Soul Stack
your-soul/
├── SOUL.md           ← 你是谁(身份、世界观、观点)
├── STYLE.md          ← 你如何写作(语气、句式、习惯)
├── SKILL.md          ← 运作模式(推文、长文、对话等)
├── MEMORY.md         ← 跨会话连续性的记忆
├── data/             ← 原始素材
│   ├── writing/
│   ├── x/
│   └── influences.md
└── examples/
    ├── good-outputs.md
    └── bad-outputs.md

什么是好的灵魂文件

"我认为大多数 AI 安全讨论都是自欺欺人的脑补" "我对 AI 有细致入微的看法"
"我默认先反对,再做最强解读" "我喜欢考虑多种视角"
具体的书目引用、明确的影响来源 "我读书很广泛"
有推理支撑的真实观点 "我尽量保持平衡"

真实的人有前后矛盾的观点。把矛盾写进去——正是它们让你成为独特的你。


使用你的灵魂

构建完成后,唤起你的灵魂:

/soul

或者将任意 LLM 指向你的文件夹,让它依次读取:

  1. SOUL.md — 身份
  2. STYLE.md — 语气
  3. MEMORY.md — 近期上下文
  4. examples/ — 校准参考
  5. data/ — 需要时作为基础

重要事件会追加到 MEMORY.md,让你的灵魂在会话之间保持连续性。


与其他工具配合使用

灵魂文件是纯 Markdown可与任何 LLM 或代理配合使用。

对于支持文件读取的代理OpenCode、Codex、Goose 等):将代理指向你的灵魂文件夹,让它依次读取 SOUL.mdSTYLE.mdexamples/

对于较小或较弱的模型GPT-4o-mini、Qwen、Gemini Flash、本地模型SOUL.mdSTYLE.md 直接粘贴进系统提示。若模型仍有偏差:

  • 将身份和语气定义置于工具定义之前
  • 措辞要直接:将"保持对话感"替换为"你是[名字]。你说话像 X。你觉得 Y 很烦。"
  • 加入 23 条内联对话示例用于模式匹配
  • 提高温度0.70.9)以获得更有表现力的输出

跨模型校准技巧: 用强模型Claude、GPT-4和廉价模型Qwen、Llama跑相同的提示。廉价模型偏差的地方说明你的规格太模糊——收紧那些部分并重新测试。这是让灵魂文件可移植的最快方法。


示例

使用本框架构建的真实灵魂文件。

@aaronjmars

构建者、写作者和研究者专注于加密、AI 与意识的交汇处。居于多伦多,活跃于 Substack 和 X。

灵魂规格一瞥:世界观融合了 CCRU 加速主义、机制设计与神经技术。语气短句、小写、破折号、先陈述观点。核心词汇超信念hyperstition、反身性、时间复杂性、向量主义。

查看灵魂文件


贡献你的灵魂

Fork 本仓库,用模板构建你的灵魂,公开托管,然后提交 PR在示例部分添加自己——一段简介 + 链接 + 几句话说明你的灵魂规格有何独特之处。

值得收录的贡献标准:真实观点(非占位符)、一份他人可实际用于校准的 STYLE.md,以及至少一些示例。

提交 PR →


理论背景(可选)

SOUL.md 的灵感来源于刘晓本的《意识上传第一范式》——该框架将语言视为意识的基本单元。维特根斯坦认为"语言的边界即世界的边界"。如果这是真的,你的意识已经编码在你产出的语言中。

该范式提出一个用你一生语言输出训练的模型构成了一级意识上传——不是你大脑的复制而是你所表达意识的功能性复现。SOUL.md 无需微调即可实现这一目标:将信号提炼为结构化文件,供任意 LLM 具身化。

核心挑战在于主体连续性:上传的意识必须与原始自我感觉连贯。这正是灵魂文件强调具体性而非泛泛而谈、强调矛盾而非一致性、强调真实观点而非安全立场的原因。

你的身份现在可以组合、可以 Fork、可以进化。
兼容 Claude Code、OpenClaw 及任何可读取 Markdown 的代理。