8.0 KiB
AI人格灵魂文件构建器
AI代理 个人化 身份建模 Claude Code Markdown
SOUL.MD
为你的 AI 代理构建人格的最佳方式。
让 Claude Code / OpenClaw 摄取你的数据,构建你的 AI 灵魂。
这是什么?
灵魂文件以 AI 代理可以具身化的格式捕捉你是谁。不是一个谈论你的聊天机器人——而是一个以你的方式思考和说话的 AI。
把你的推文、文章和帖子丢进一个文件夹。代理读取所有内容,提取你的世界观和语言风格,并构建一组任何 LLM 都可以加载、以你的方式写作的 Markdown 文件。
目标:读过你的 SOUL.md 的人应该能预测你对新话题的看法。如果做不到,说明文件太模糊了。
使用场景:
- 从你的世界观出发生成想法
- 写出听起来像你的内容(推文、文章、邮件)
- 将 AI 定制为符合你的兴趣和思维模式
- 为内容创作、回复和头脑风暴复刻自己
快速开始
方式一 — 从零构建
/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
数据来源
把你写过的任何内容喂给构建器。信号越多,输出越精准。
| 类别 | 平台 |
|---|---|
| 社交 | 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 | 多种 | — |
也可通过系统提示与任意模型配合使用——参见与其他工具配合使用。
文件结构
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 指向你的文件夹,让它依次读取:
SOUL.md— 身份STYLE.md— 语气MEMORY.md— 近期上下文examples/— 校准参考data/— 需要时作为基础
重要事件会追加到 MEMORY.md,让你的灵魂在会话之间保持连续性。
与其他工具配合使用
灵魂文件是纯 Markdown,可与任何 LLM 或代理配合使用。
对于支持文件读取的代理(OpenCode、Codex、Goose 等):将代理指向你的灵魂文件夹,让它依次读取 SOUL.md → STYLE.md → examples/。
对于较小或较弱的模型(GPT-4o-mini、Qwen、Gemini Flash、本地模型):将 SOUL.md 和 STYLE.md 直接粘贴进系统提示。若模型仍有偏差:
- 将身份和语气定义置于工具定义之前
- 措辞要直接:将"保持对话感"替换为"你是[名字]。你说话像 X。你觉得 Y 很烦。"
- 加入 2–3 条内联对话示例用于模式匹配
- 提高温度(0.7–0.9)以获得更有表现力的输出
跨模型校准技巧: 用强模型(Claude、GPT-4)和廉价模型(Qwen、Llama)跑相同的提示。廉价模型偏差的地方,说明你的规格太模糊——收紧那些部分并重新测试。这是让灵魂文件可移植的最快方法。
示例
使用本框架构建的真实灵魂文件。
@aaronjmars
构建者、写作者和研究者,专注于加密、AI 与意识的交汇处。居于多伦多,活跃于 Substack 和 X。
灵魂规格一瞥:世界观融合了 CCRU 加速主义、机制设计与神经技术。语气:短句、小写、破折号、先陈述观点。核心词汇:超信念(hyperstition)、反身性、时间复杂性、向量主义。
→ 查看灵魂文件
贡献你的灵魂
Fork 本仓库,用模板构建你的灵魂,公开托管,然后提交 PR,在示例部分添加自己——一段简介 + 链接 + 几句话说明你的灵魂规格有何独特之处。
值得收录的贡献标准:真实观点(非占位符)、一份他人可实际用于校准的 STYLE.md,以及至少一些示例。
理论背景(可选)
SOUL.md 的灵感来源于刘晓本的《意识上传第一范式》——该框架将语言视为意识的基本单元。维特根斯坦认为"语言的边界即世界的边界"。如果这是真的,你的意识已经编码在你产出的语言中。
该范式提出,一个用你一生语言输出训练的模型构成了一级意识上传——不是你大脑的复制,而是你所表达意识的功能性复现。SOUL.md 无需微调即可实现这一目标:将信号提炼为结构化文件,供任意 LLM 具身化。
核心挑战在于主体连续性:上传的意识必须与原始自我感觉连贯。这正是灵魂文件强调具体性而非泛泛而谈、强调矛盾而非一致性、强调真实观点而非安全立场的原因。
你的身份现在可以组合、可以 Fork、可以进化。
兼容 Claude Code、OpenClaw 及任何可读取 Markdown 的代理。
