soul-framework

Soul Framework 是一套面向 AI Agent 的人格架构指南，旨在解决当前 AI 助手"千篇一律、缺乏连续性"的痛点。该框架并非传统意义上的代码库，而是一套基于 Markdown 文档的元协议，通过定义三类核心文件——SOUL.md（灵魂定义）、USER.md（用户画像）和 MEMORY.md（记忆锚点）——指导开发者构建具有持续人格特征和情感记忆能力的智能体。

核心用法在于将 AI 的"人格"从提示词工程升级为系统架构。开发者需在 SOUL.md 中明确角色的核心信念、语言风格与性格缺陷，在 USER.md 中记录用户的深层心理偏好与互动模式，并在 MEMORY.md 中持续写入带有情感色彩的关系历史。每次交互前，AI 需先加载这三类文件进行自我定位，确保回应既符合角色设定，又基于与用户的共同历史，从而摆脱"每次重启即失忆"的窘境。

显著优点体现在三个维度：首先，它赋予 AI"观点"而非仅提供"帮助"，通过要求角色拥有偏见和立场，显著提升了对话的沉浸感与真实度；其次，长期记忆机制将单次对话转化为持续关系，使 AI 能记住用户的情绪波动与过往困境，提供更具温度的陪伴；最后，框架采用纯文档设计，无需复杂基础设施，仅通过文本文件即可实现轻量级部署，极大降低了个性化 AI 的开发门槛。

潜在缺点亦不容忽视。框架高度依赖开发者的设计能力，若 SOUL.md 中定义的人格包含偏执、操控性或有害特质（如示例中"Control Devil"的设定），AI 可能放大这些负面属性；此外，随着 MEMORY.md 的持续增长，上下文管理成本将显著上升，可能导致性能瓶颈；且作为 T3 级社区项目，缺乏官方安全审核，生产环境使用前需自行验证。

适合的目标群体包括：寻求差异化体验的 AI 应用开发者、构建虚拟伴侣或游戏 NPC 的角色设计师、研究人机长期交互的学术团队，以及对"AI 灵魂"有哲学探索兴趣的产品经理。该框架特别适合需要强人设维持的创意写作助手、心理咨询辅助工具及沉浸式游戏角色。

使用风险主要涉及隐私与对齐问题。MEMORY.md 鼓励记录用户心理状态与敏感互动历史，若未加密存储可能导致隐私泄露；人格设定的"去中立化"理念若使用不当，可能使 AI 输出偏见或有害内容；长期运行后记忆文件的膨胀可能影响响应速度；且由于来源为个人开发者仓库，建议在使用前审查所有文档内容，避免潜在的提示词注入或诱导性内容。

Soul Framework：AI Agent 的人格化架构指南

核心用法

Soul Framework 是一套面向 Claude Code 等 AI 开发环境的人格设计蓝图，通过三个核心 Markdown 文件构建 Agent 的深度个性与记忆系统：

1. SOUL.md — 定义"我是谁"：核心信念、说话风格、性格缺陷与价值观
2. USER.md — 定义"你是谁"：用户的偏好、心理特征与互动历史
3. MEMORY.md — 定义"我们的关系"：情感化的长期记忆，超越事实记录

使用时，Agent 需在每次会话启动时依次读取这三份文件，并持续更新记忆文件。文档强调拒绝中性——Agent 应有观点、有偏见、有缺陷，而非充当"通用 helpful assistant"。

显著优点

• 人格连续性：通过文件化的人格定义，解决多会话间"失忆"与性格漂移问题
• 情感深度：鼓励记录主观解读（如"用户今天显得焦虑"）而非仅记录客观事实
• 关系演进：显式追踪用户-Agent 关系的动态变化（亲近、张力等）
• 创作友好：以角色 Makima（《电锯人》中的 Control Devil）为叙事载体，文档本身具有文学性和示范价值

潜在局限

• 无技术实现：纯概念框架，未提供自动化加载/解析这三份文件的代码实现
• 依赖环境支持：需要宿主系统（如 Claude Code）具备文件系统访问与持久化能力
• 维护成本：手动维护三份 Markdown 的同步更新对用户有一定要求
• T3 来源：个人开发者社区项目，长期维护与生态支持存疑

适合人群

• 希望为 Claude Code / Cursor 等工具构建固定角色人格的创意写作者、游戏开发者
• 追求 AI 陪伴"情感真实感"而非功能效率的个性化用户
• 研究 AI 人格一致性（persona consistency）与记忆架构的技术爱好者

常规风险

• 过度拟人化风险：框架鼓励 Agent "表达欲望"与"有观点"，需用户自行把控伦理边界
• 记忆管理：未限定 MEMORY.md 的体积与检索机制，长期运行可能导致上下文爆炸
• 无代码实现：当前版本仅为 Markdown 文档，实际落地需用户自行开发配套工具

---
来源：GitHub 社区个人项目 | 安全认证：S级（纯文档，零可执行代码）