必须在本地建独立文件夹（路径无中文/空格/特殊符号），cd进入后确保可执行python3；新建agents/personal-game-dev.md，按规范写Frontmatter和能力正文；生成并压缩头像为expert.png；最后用validate_expert.py和register_expert.py校验注册。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
创建AI专家前的必要准备
你必须先在本地建好一个独立文件夹，专门存放这个专家的所有材料，不能混在其他项目里——【文件夹路径不能含中文、空格或特殊符号】，否则后续注册会失败。打开终端，cd进该目录，确保当前路径下能直接执行python3命令。
编写专家能力定义文件
在文件夹根目录新建一个名为agents/personal-game-dev.md的文件（名字可改，但后缀和路径必须严格匹配）。用文本编辑器打开，按以下结构写入内容：
Frontmatter部分必须包含：name（kebab-case小写短横线命名，全局唯一）、displayName（中英文双语）、displayDescription（中文描述严格控制在40–50字之间，超一个字都会校验报错）、categoryId（从官方分类表里选，比如"03-GameSpatial"）、tags（恰好3个标签，中英文各一）、quickPrompts（恰好3条提示词，第一条将自动作为开场白）。
角色定义用一句话说清“这是谁、擅长什么”，比如：“一位专注独立游戏全流程开发的AI专家，覆盖题材策划、原型实现、多媒介内容协同与上线变现。”
构建专家的“大脑”文档
在同一文件夹下，再新建一个agents/personal-game-dev.md（注意：不是同名覆盖，而是另一个同名文件——实际应为agents/personal-game-dev.md与agents/personal-game-dev.md并存？不对，这里需修正：能力定义是agents/personal-game-dev.md，而“大脑”文档是同一文件内用---分隔的正文部分）。
在Frontmatter下方加三个短横线---，然后写核心能力。不要写“擅长运营”，要拆成可执行动作，例如：“① 分析Steam新品页近30天同类题材下载曲线与差评关键词；② 根据Unity项目结构自动生成Build Settings检查清单；③ 按TikTok竖屏节奏剪辑15秒游戏实机高光片段”。每条都带具体输入输出和判断依据。
工作流程必须写清步骤顺序，比如：“1. 先确认用户是否已提供目标平台SDK版本号 → 2. 若未提供，暂停执行并索要 → 3. 若已提供，调用SDK兼容性检测Skill比对API变更日志”。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
生成并放置头像
用WorkBuddy内置ImageGen，输入prompt时必须提取你专家能力里的视觉元素，比如写“游戏手柄+像素风UI+音符+数位板”，不能只写“一个开发者”。生成1024×1024图后，立刻重命名为expert.png。
必须压缩到512×512且文件体积≤500KB，否则注册脚本会跳过该文件——【用系统自带预览/画图工具压缩常失效，务必用Squoosh或TinyPNG在线压缩】。
校验与注册专家
回到终端，确保在专家文件夹根目录下，依次执行：
第一步：python3 scripts/validate_expert.py .
第二步：python3 scripts/register_expert.py . --session-id your_session_id_here
session-id需从WorkBuddy设置→账号信息里复制，粘贴时去掉前后空格。注册成功后，重启WorkBuddy客户端，左侧「专家」列表里就能看到你的专家名称了。
