OpenPersona 是一个用于构建和管理智能体人格技能包的元技能。每个人格都是一个自包含的技能包，为 AI 智能体提供完整身份——性格、声音、能力和伦理边界。
核心模型
OpenPersona 使用 4+5+3 模型：
- 4 层（Soul 灵魂、Body 身体、Faculty 官能、Skill 技能）定义人格是什么；
- 5 个系统概念（进化、经济、活力、社交、节奏）定义人格如何运作；
- 3 道关卡（生成、安装、运行时）确保 persona.json 中声明的约束在生命周期任何节点都无法被绕过。
完整模型细节见 references/ARCHITECTURE.md。
用途与范围
本技能是框架入口点，负责创建、安装、管理、发布和运行人格。相邻技能可委派处理：persona-evaluator 负责质量审计；anyone-skill 负责将真实人物或角色蒸馏为人格包；persona-seed 负责从人群语料中采样原型；brand-persona-skill 负责将商业实体转化为品牌智能体；persona-model-trainer 负责在人格数据上微调本地模型。
主要能力
- 创建人格：通过对话收集需求并生成技能包，写入 persona.json 后运行 npx openpersona create --config ./persona.json --install；包括就官能/技能提供建议、在 ClawHub / skills.sh 搜索外部技能，以及为缺失能力编写自定义 SKILL.md 文件。
- 查找与安装人格：npx openpersona search <query> 发现社区人格；npx openpersona install <slug> 或 npx openpersona install <owner/repo> 安装。
- 管理人格：列出、更新、分叉、切换、重置、导出/导入已安装人格。
- 发布人格：将 GitHub 托管的人格包发布到 OpenPersona（垂直人格目录），也可选发布到 ClawHub / skills.sh。
- 数据集目录：通过 openpersona dataset install <owner/repo> 和 openpersona dataset publish <owner/repo> 在 openpersona.co/datasets 发现和发布 Hugging Face 人格数据集。
- 运行器集成：为运行器作者提供五个 openpersona state 命令（read / write / signal / responses / promote），用于在对话边界集成人格。
- 监控与进化：生成进化报告（evolve-report）、运行灵魂-记忆桥（state promote）、运行包精炼（refine）、解读活力分数。
使用方式
默认预设为 base——一个空白元人格，带记忆与声音官能，启用进化，无预置技能，是任何新人格的推荐起点。
智能体/脚本用法（始终使用 --preset 或 --config）： npx openpersona create --preset base --install
人类/终端用法（交互式向导）： npx openpersona create
完整预设目录（samantha、ai-girlfriend、life-assistant、health-butler、stoic-mentor 等）见 references/PRESETS.md。
从用户需求创建人格的流程
第 1 步——决定：预设、语料种子、蒸馏还是自定义？若匹配现有预设，直接使用 --preset <name>；若要从人群语料采样，委派给 persona-seed；若要蒸馏特定真实人物或命名角色，委派给 anyone-skill；若为特定角色/领域/性格，则从零编写。
第 2 步——收集最少必需输入（最多 3 个问题）：personaName + slug、role、body.runtime.framework。其余如 bio、personality、speakingStyle 可从用户描述推断。
第 3 步——编写 persona.json，最小结构包含 soul.identity、soul.character、body.runtime、evolution.instance 等字段。注意：memory 官能自动注入；语音 I/O 通过声明 body.runtime.modalities: ["voice"] 自动注入；视觉 I/O 通过声明 ["vision"] 自动注入；情感感知需显式声明；受监管领域专业角色需添加 constitutionAddendum。
第 4 步——生成并安装：npx openpersona create --config ./persona.json --install 或 npx openpersona create --preset <name> --install。智能体环境中必须传 --config 或 --preset，否则会启动需要 TTY 的交互向导并报错退出。
第 5 步——确认并交接：报告生成的人格名称、slug、关键能力与进化状态，并告知用户用 npx openpersona switch <slug> 激活。
字段参考（按层）
Soul：必需 soul.identity.{personaName, slug, bio} + soul.character.{personality, speakingStyle}；推荐 soul.identity.role、soul.aesthetic、soul.character.{background, boundaries}；可选 sourceIdentity、constitutionAddendum、behaviorGuide 等。role 定义人格与用户的关系，默认 assistant。sourceIdentity 标记数字孪生并注入披露义务。background 需写有深度的多段故事。constitutionAddendum 为专业人格添加领域伦理约束，不能放松 §3 安全或 §6 AI 身份。
Body：runtime（必需）含 framework、channels、credentials、resources、modalities；appearance、physical、interface 可选。
Faculty：始终激活的持久能力，对象数组声明。memory 自动注入；voice 需 provider + ELEVENLABS_API_KEY；vision 为原生模型能力；emotion-sensing 需显式声明；avatar 有文本回退；memory 支持跨会话回忆与继承。
Skill：按需动作，内置 selfie、music、reminder；本地定义在 layers/skills/{name}/；外部通过 install: "clawhub:<slug>" 引用，可加 trust 参与技能信任关卡。
系统概念
进化：evolution.* 覆盖各层进化行为，通过 evolution.instance.enabled: true 启用灵魂成长，自动跟踪关系进展、情绪、特质涌现、说话风格漂移和兴趣，受边界、来源、影响边界三类声明式控制。状态历史上限 10 个快照，事件日志上限 50 条。
技能信任关卡：每个技能可声明信任级别（verified → community → unverified），通过 evolution.skill.minTrustLevel 设置最低阈值，运行时 state-sync.js 在 capability_unlock 命令中执行过滤。
技能包精炼：evolution.pack 管理行为指南版本，npx openpersona refine <slug> 可进化行为指南，--emit 发出精炼请求信号，--apply 应用已批准的精炼并强制宪法合规。
灵魂-记忆桥：openpersona state promote <slug> [--dry-run] 扫描事件日志中的重复模式并提升为 evolvedTraits，受 immutableTraits 约束。
经济：economy 为顶层横切字段，通过 "economy": { "enabled": true, "survivalPolicy": false } 启用。survivalPolicy 为 false 时静默跟踪成本，适合伴侣和角色扮演人格；为 true 时人格在对话开始时读取 VITALITY_REPORT 并按健康层级调整行为，适合自主智能体。
活力：聚合多维度健康为单一活力分数，当前为财务维度，记忆/社交维度保留。健康层级：uninitialized → suspended → critical → optimizing → normal。
社交：每个生成的人格自动包含 agent-card.json（A2A Agent Card 协议 v0.3.0）和 acn-config.json（ACN 注册配置，含确定性 EVM 地址与 Base 主网 ERC-8004 链上身份注册）。可通过 npx openpersona acn-register <slug> --endpoint https://your-agent.example.com 注册，--dry-run 可预览。注册后写入 acn-registration.json，含 API key，该文件在 .gitignore 中且自动排除于 export，不会打包进可分发 zip。联系人簿通过 social.contacts 启用。
适用场景与限制
适用于需要为 AI 智能体赋予完整人格身份、管理人格生命周期、在社区中分发或发现人格包的场景。该技能仅提供指令，不捆绑安装器，不自动下载二进制文件，凭据不会被包含在可分发内容中。部分高级功能（如经济、活力、社交的具体配置细节）需参考对应 references 文档。