CodeBuddy AI智能体角色创建失败，主因是角色JSON缺失name/description/skills字段、技能ID拼写错误或未注册、Harness会话缓存异常；需校验JSON结构、核对tool_id、清除session并删除.codex/harness目录后重启CLI。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy AI智能体角色创建失败，通常是因为角色定义未通过Harness运行时校验、缺失必需字段、或与当前CloudAgent平台版本不兼容。直接点击“新建角色”后空白/报错/卡在加载状态，说明配置层与执行层之间已出现协议断裂。
检查角色定义JSON结构完整性
打开角色编辑器后，切换至「Raw JSON」视图，确认以下三个字段真实存在且类型正确：【name】（字符串）、【description】（非空字符串）、【skills】（数组，可为空但不能缺失）。若任意一项为null、undefined或拼写错误（如写成"skils"），CloudAgent会在提交前静默拦截，不弹提示也不报错。
用Ctrl+F搜索"skills"，确保它出现在顶层键中；若嵌套在"config"或"behavior"下，需剪切到根级位置。
验证技能引用是否指向已注册工具
方法一：在技能列表中只保留一个最简技能，例如"shell_execute"，保存测试。若成功，则原技能名存在大小写偏差或拼写错误——CloudAgent对tool_id严格区分大小写，"GitCommit"和"gitcommit"视为两个不同ID。
方法二：终端执行codebuddy tool list，核对输出中的tool_id列。若想调用Ollama模型推理，必须使用ollama_chat而非ollama；若想读取本地文件，必须用file_read而非read_file。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
注意：自定义技能未通过codebuddy tool register注册前，任何角色配置中引用它都会导致创建失败，且错误日志仅显示"Tool not found"，不指明是哪个tool_id。
强制重置Harness会话上下文
第一步：执行codebuddy session clear --force，清除所有未持久化的Harness状态缓存。
第二步：删除项目根目录下的.codex/harness/子目录（若存在），该目录存储本地沙箱调度快照，损坏后会导致角色元数据解析异常。
第三步：重启CodeBuddy CLI进程，再尝试创建角色。这一步不可跳过——Harness无状态化设计要求每次新建角色都从干净的初始化环境开始，残留的session_id可能触发旧版本schema校验逻辑。
