WorkBuddy专家包驱动本地AI错题本
AI 总结
一名开发者复盘了WorkBuddy专家包的开发与发布,该专家包通过自然语言指令连接本地优先的AI错题本引擎。专家包以纯文本代理和技能规则调用本地HTTP接口,覆盖照片录入、拍照转录、人审、薄弱点诊断、错题讲解与练习卷生成。文章还记录了校验注册、版本缓存、沙箱限制和服务生命周期管理等实现问题。
深度见解
这篇第一手复盘给出了WorkBuddy专家包与本地AI应用结合的具体方法,并提供了有关校验、缓存、沙箱和服务监控的可复用工程细节。
WorkBuddy 专家包:AI 错题本管家开发全程复盘
我给孩子做了一个本地优先的「AI 错题本」桌面引擎(拍照转录、错题管理、练习卷生成),一直缺一个顺手的对话入口。WorkBuddy 的专家包机制正好补上这块:让大模型当管家,用自然语言驱动本地引擎——拍照录入、诊断薄弱点、讲解错题。 这篇文章复盘整个开发过程:专家包到底是什么、怎么从零到发布、以及三个让我返工三次的坑。如果你也想给 WorkBuddy 写专家包,看完这篇可以直接上手。
一、30 秒理解专家包
WorkBuddy 专家包的本质是:一个纯文本目录 + 一份注册记录,不含任何可执行代码。
wrongbook-expert/
├── .codebuddy-plugin/plugin.json # 元数据:卡片展示、快捷指令、技能声明、版本号
├── agents/wrongbook-expert.md # 人设:YAML frontmatter + 正文规则(谁、能做什么、怎么做的 SOP)
├── skills/wrongbook-skill/SKILL.md # 技能:按需加载的操作规程(分步命令,模型照着执行)
├── avatars/expert.png # 头像(512×512、≤500KB)
└── README.md