① 专家（agent）和专家团（team）有什么区别？
agent 是单角色专家，一个人干活；team 是多角色协作团队，一个主理人带若干成员并行分工。判断标准很硬：单角色 = agent，多角色 = team，不能凭喜好指定。输出一份完整内容包（如方案、课时包）时，用 team 更顺。
② 一定要写代码吗？不会技术能做吗？
不用。路线 A 是对话式创建：直接对 WorkBuddy 说「帮我创建一个 XX 专家团」，它走完 init → 填内容 → 校验 → 注册 全流程，你只补充需求。路线 B 文件级才需要写 plugin.json 和 agents/*.md，适合要精确控制或批量造的人。
③ tags 和 quickPrompts 为什么只能是 3 个？
规范硬性规定：tags（擅长领域标签）和 quickPrompts（推荐提示词）都固定为 3 个。已有 3 个时再想加，必须先替换或删掉已有的，不能无限追加。第一条 quickPrompts 同时作为 defaultInitPrompt（开场提问）。
④ 团队里 displayName 和 profession 为什么必须一致？
对 team 类型，profession（职业头衔）必须和 displayName（花名）一致——比如都写「保险规划顾问团」。这是规范铁律之一，不一致会被校验拦下。agent 类型则两者可以不同。
⑤ 主理人（lead）的 agents MD 文件名有什么要求？
主理人文件名必须带团队前缀，如 insurance-planning-advisor-team-lead.md，不能用通用的 team-lead.md。因为 agentName 等于 MD 文件名，前缀才能保证唯一、可被系统识别。
⑥ 校验总报错，常见原因有哪些？
高频踩坑：① tags / quickPrompts 不是恰好 3 个；② team 的 members 缺主理人（role=lead），或 teamInfo.memberAgents 误把主理人也列进去了；③ 主理人 MD 文件名没带团队前缀；④ Agent MD 的 frontmatter 里写了 tools 字段（禁止）；⑤ displayDescription 中文不在 40–50 字区间。详见避坑铁律。
⑦ 改了内容，需要重新注册吗？
需要。无论改了名字、标签还是 MD 正文，都要再跑一次 register_expert.py。但 name / agentName / 目录名 / MD 文件名是专家的唯一标识，改了等于丢专家，必须重建，不支持原地改名。
⑧ 头像必须生成吗？能自己换吗？
头像用 ImageGen 自动生成（同一团队风格统一），也可手绘后替换：PNG / JPG，512×512，≤500KB，放进 avatars/ 即可。本站三个团用 PIL 离线生成品牌头像，不耗积分。
⑨ 这些教程基于哪个版本规范？
全部基于 WorkBuddy 内置 expert-manager 技能的一手规范（v2.0），整理于 2026-08。规范若有大版本更新，本站会同步修订并在规范手册标注版本。
⑩ 做好的专家团能分享给别人吗？
本教程站只教「如何在你自己的 WorkBuddy 里创建专家团」，不涉及市场上架、打包分发或分享安装包。创建出来的团会出现在你账号的「我的专家」里，供你自己调用与复用。