elizaOS Character Builder 是一个面向 elizaOS 角色配置的构建技能,目标是把一段角色描述或一个已有角色,转化为一个小而版本正确的配置。它反复强调一个前提:人格文本本身不授予任何权限,解析通过也不证明智能体已经可运行。
用途 该技能用于创建、审查和迁移 elizaOS 角色配置,覆盖人设、对话示例、文档来源、插件选择与安全设置。它适用于需要把角色描述落地为配置、或把旧版角色迁移到目标版本的项目。
主要能力
- 识别契约:要求先阅读项目的 AGENTS.md、manifest、lockfile、入口点,以及已安装的 @elizaos/core 导出与类型,判断目标是核心 Character、宿主配置中更窄的 character 子段,还是带自有 CLI 与 loader 的已发布 1.x 项目。
- 设计人设:从请求与代码中推断角色、受众、语气与边界;只就影响实现的缺失决策提问。使用简短 bio、有用的话题、一致的风格,以及针对正常帮助、不确定、超出范围请求和需要授权的动作的示例。示例只用于说明行为,不是训练运行,也不是权限授予;不得编造真实资质、客户事实、集成或能力。
- 单独接线能力:复用宿主已有的、显式的兼容存储、模型与功能插件组合。JSON 中的包名不会安装依赖、注册模型、摄取文档或授予连接器访问权限。凭据应放在宿主批准的密钥存储中,示例里只用名称而非真实值。
- 分层验证:提供脚本 python3 scripts/check_character.py --input /path/to/character.json --target core 与 --target host 两种用法。该脚本只读 JSON,不导入项目代码、不联网、不写入,检查一个保守的编写子集和常见凭据字段名。退出码 0 表示预检通过,1 表示编写问题,2 表示 JSON 不可读或无效。它并非 elizaOS schema、不是密钥扫描器、不做插件解析,也不是运行时测试;高级内容、模板与设置仍需已安装的权威 schema。即使返回 0 也应查看警告。之后应运行项目的类型检查与精确的 loader/schema 验证。
- 验证行为并交接:在隔离的本地智能体与批准的模型/后端上,使用有限的调用/令牌预算,不发送真实外发消息、不进行钱包操作,用实际回复对照人设场景与授权边界进行评估。静态夹具或期望答案不算实时证据。无法获得的凭据、模型与存储应报告为未测试,而非通过。
使用方式 按上述五步流程操作:先读契约,再设计人设,然后单独接线能力,接着分层验证,最后验证行为并交接。脚本需从已安装的技能目录运行,或使用绝对脚本路径。
适用场景 适用于 elizaOS 角色配置的创建、审查与迁移,尤其是需要版本正确、人设一致、能力与权限分离的项目。
限制 该技能明确:人格文本不授予权限;解析不证明智能体可运行;脚本不是官方 schema、不是密钥扫描器、不做插件解析或运行时测试;不要为了匹配本技能而安装全局 CLI、升级包或重写 loader;不要因核心 character 中这些字段合法就把 plugins、settings 或 documents 放进宿主 character 子段;不要假设 bootstrap/sql/model 插件总是隐式存在,也不要假设通用 settings.model 会选择提供者;不要因编写人设而顺带启用公共连接器、调度、钱包、设备访问或自主性;提示规则不是运行时授权机制。导入任意 character.ts 会执行代码,执行前应审查。除非被要求,否则不要部署或发布。
参考资料 技能列出四类参考:契约与迁移(选择形态或迁移前阅读)、人设与评估(设计语气与测试前阅读)、能力与密钥(接线设置/文档/插件前阅读)、固定来源(官方实现与文档差异)。