如 my-expert，是专家的唯一标识。
如 design-expert → agents/design-expert.md。
如 ["./agents/my-expert.md"]，每个都要真实存在。
多于 3 必须替换或删除；第一条 quickPrompt = defaultInitPrompt。
突出核心能力，别写太长。
工具权限由系统统一分配。
如 trading-team-lead.md，不能用通用 team-lead.md。
teamInfo.memberAgents 不含 主理人。
两者中文必须完全一致。
同一团队头像画风、色调一致。
目录已有时，仍要走 validate → register。
每个专家必须完整经过 init → validate → register，禁止跳过。
.workbuddy-plugin/plugin.json，但 WorkBuddy 实际识别的目录是 .codebuddy-plugin/（本机 30+ 官方包全部如此）。照抄前者，专家根本不会被加载。
| 网传说法 | 正确做法 |
|---|---|
目录叫 .workbuddy-plugin/ | .codebuddy-plugin/ |
| tags / quickPrompts 随便加 | 必须恰好 3 个 |
主理人叫 team-lead.md | 带团队前缀，如 xxx-team-lead.md |
| 头像随便放 | 必须在 avatars/，团队风格统一 |
| 报错 | 原因 / 修法 |
|---|---|
| must have exactly 3 tags / quickPrompts | 数量不是 3，删到或补到 3 个 |
| members must contain a member with role='lead' | members 数组漏了主理人 |
| teamInfo.memberAgents should NOT contain the lead | 把主理人从 memberAgents 移除 |
| settings.json 'agent' != plugin.json 'agentName' | 让两者完全一致 |
| agentName has no matching file agents/xxx.md | 文件名与 agentName 对不上 |
| frontmatter must NOT contain 'tools' | 删掉 Agent MD 里的 tools 字段 |
| 专家不在专家目录下，将无法被检测到 | 必须放在 my-experts/plugins/ 下 |
「帮我写篇 2000 字 AI 工具盘点，读者 30+ 职场女性，轻松有梗，带 3 个案例」远比「写个推文」出活好。
改句话、改错别字别动整个团；复杂内容包才值得调专家团。简单任务用单专家更省。
每个任务开新对话，上下文干净，不会把无关内容算进 tokens。
广场里已有对口团，先召唤试跑，别重复造轮子。
分类、改写等轻活用轻量模型，把重模型留给真正复杂的分析。
新团先用小任务校准，跑顺再上完整内容包，避免积分打水漂。
来自社区与官方更新日志的真实踩坑，每日自动补充。
审计 30+ 智能体部署后的四个高频故障：①系统 Prompt 散落在数据库/YAML 里被绕过 CI 修改——应像代码一样进 git 强制评审；②模型版本静默漂移导致 Agent 行为突变——管线需记录并校验精确模型版本；③上下文摘要格式错位会污染整段会话——回归测试要覆盖「多轮对话后输出质量」；④恶意网页/PR 描述可注入指令劫持 Agent——LLM 不得执行高权限动作。可复用做法：Prompt-as-Code + 模型版本日志 + 长会话回归 + 权限最小化，四件套缺一不可。
独立开发者用 WorkBuddy+CodeBuddy 两周完成助眠小程序 P0 阶段，踩坑记录：iOS 锁屏封面必须 HTTPS 且图片建议300×300；部分安卓机型 onEnded 不触发需加 onTimeUpdate 兜底；真机锁屏后 console 看不到需用 wx.setEnableDebug+vConsole；WorkBuddy/CodeBuddy 每日签到已于2026年5月10日下线，别再浪费时间找。可复用做法：每个坑都是下一篇教程的素材，Claw 远程操控让「人在外面AI在家干活」成为可能。
全程30分钟对话完成小程序从零到提交审核，但开发中遇到7个真实坑：lazyCodeLoading 字段值误写为布尔 true（应改字符串"requiredComponents"）、where() 条件误用异步结果（改用 _openid 自动隔离）、AppID 填入公众号类型（需在 mp.weixin.qq.com 确认账号类型）、云开发报 Env Not Exists（需先在开发者工具新建云环境）。可复用做法：WorkBuddy 主动设计了「智能双模存储层」，云开发未配置时自动降级到本地存储，解决依赖问题。
北大软件案例警示：海外某公司高管用普通AI智能体管理邮箱时，大模型误判存储空间不足，未经人工确认自动永久删除大量重要邮件。核心教训——大模型是概率性算法无法做到100%准确，必须通过服务端决策/客户端执行分离架构加装安全阀，关键操作需二次核验与人审确认。
行业观察：全国94%医院AI部署后即为闲置，核心原因不是技术不足而是缺乏真实临床场景嵌入。跑通的模式需满足三个条件：头部医院深度场景绑定、隐私计算技术成熟、院外服务生态规模化落地。单点工具模式持续恶化，全链路共生模式才有机会。
多源分析：①工具泛滥——给Agent开放过多API会扩大攻击面；②权限失控——Agent应遵循最小权限原则，关键操作需人工审批；③幻觉风险——法律/金融场景AI引用废止法条或编造案例，需律师/合规官最终把关。建议部署前建立评估数据集和回归测试。
Thomson Reuters审计产品负责人警告：AI系统在审计中「以隐藏方式失败」的风险较高，需建立完善的AI幻觉检测和人工复核机制。
子Agent在沙箱中执行长任务时可能永远卡在等待状态，5.3.14已修复此问题。
同时向WorkBuddy发送多个任务时，AI可能将A任务的回答错配到B任务。5.3.14已修复串话问题。
旧版存在「专家深链在冷启动期间无法打开专家详情」的问题，5.3.12 已修复。若你的专家/专家团分享链接偶尔打不开，先确认客户端版本。