乐于分享
好东西不私藏

致远OA插件生成Skill(一)短信插件生成Skill

致远OA插件生成Skill(一)短信插件生成Skill
做致远OA二次开发的兄弟们,是不是经常遇到听起来简单的需求:
“客户说,审批流里必须加上短信通知”
听起来简单,做起来全是坑!
版本兼容难:V5、A6、V8、V9 版本跨度大,光是适配 AdapterMobileMessageManger 接口就能掉几根头发。
依赖冲突痛:高版本OA把 fastjson 移除了,你引入新的JSON库又怕和OA自带的 JSONUtil 打架,导致系统报错。
部署配置烦:插件目录结构复杂,pluginCfg.xml 写错一个字母,插件在后台就不显示,排查半天发现是路径问题。
All in Ai
**利用 **腾讯的Codebuddy编程助手 (目前免费)+ 标准化 Skill 技能包,几分钟内就能从零生成一个生产级的致远OA短信插件。

🚀 这个 Skill 能干什么?

首先澄清一个误区:这个 Skill 绝不仅仅是一个孤立的 SKILL.md 文件,而是一个模块化的文件夹结构。它相当于给Codebuddy喂了一本“致远OA开发百科全书”
当你把 Skill 挂载给 Codebuddy 后,它会自动进行“渐进式加载”,按需查阅细节:
**SKILL.md**(主文档):插件架构、核心接口说明、开发流程、Provider选择指南。
  • references/plugin-architecture.md:致远OA插件机制详解(三件套XML、接口规范、编译部署命令)。
  • references/provider-apis.md:三种短信服务商API参数对照、错误码、模板变量格式差异。
**assets/**(核心资产):内置了阿里云、腾讯云、自定义HTTP三种最常用方案的完整代码模板(各含4个核心文件)。
有了它,** **Codebuddy 就能瞬间化身干了15年的致远OA二开专家,按你的指令生成完美无瑕的代码。

🛠️ 怎么使用?解压与放置位置

拿到这个 Skill 压缩包后,你只需要做两件事,就能让 Codebuddy 完美接管。
第一步:解压文件
将压缩包解压,你会得到一个包含上述目录结构的完整文件夹。
第二步:放到指定位置
Codebuddy:
放置位置(二选一):用户级(全局生效):放到 ~/.codebuddy/skills/ 目录下。这样无论你打开哪个项目,AI 都能调用这个致远 OA 技能。项目级(仅当前项目生效):放到你当前致远 OA 项目的根目录下 .codebuddy/skills/ 中
阿里的Qoder :
支持全局和项目级两种 Skill 识别方式,你可以根据需求二选一:
全局生效(推荐):将解压后的文件夹放到 Qoder 的全局 Skills 目录下:~/.qoder/skills/(Windows 用户路径通常为*C:\Users\你的用户名\.qoder\skills\*)这样无论你打开哪个项目,Qoder 都能随时调用这个致远OA技能。
项目级生效:放到你当前致远OA项目的根目录下:你的项目根目录/.qoder/skills/这种方式仅在当前项目中生效,适合团队协作。
放好之后,重启 开发工具 或开启一个新的对话任务,让 Skill 生效。

💻 实际操作:怎么跟 Codebuddy“聊”最快生成插件?

Skill 挂载好后,你不需要手动把文档复制粘贴给 Codebuddy 。你只需要像指挥下属一样,直接下达业务指令,Codebuddy 会自动去 references/ 查阅规范,去 assets/ 提取模板。

1. 先怎么聊:生成基础插件

你可以直接抛出明确的需求:
:“我需要开发一个致远OA的短信插件,对接阿里云短信。请帮我生成完整的插件代码。”
Codebuddy ** 的内部工作流(自动执行)**:
  1. 读取 SKILL.md,了解核心架构。
  2. 自动查阅 references/plugin-architecture.md,确保 XML 配置规范正确。
  3. 自动提取 assets/aliyun-sms/ 下的4个模板文件。
  4. 综合输出完美适配的插件包代码,甚至连编译命令都帮你写好了。

2. 再怎么聊:动态切换与定制

因为所有的参考资料都在文件夹里,你随时可以无缝切换需求,无需重新配置。
:“客户突然改需求了,不用阿里云了,换成对接我们内部的 HTTP 网关。网关地址是 http://sms.internal/send。”
Codebuddy ** 的反应**:它会立刻去 assets/custom-http-sms/ 提取模板,并结合 references/provider-apis.md 里的自定义接口规范,为你重新生成代码。

3. 聊到最好:解决疑难杂症

遇到报错,直接把日志丢给它:
:“我的插件在OA后台不显示,日志报了 ClassNotFoundException,根据这份技能文档,可能是什么原因?”
Codebuddy 会结合 plugin-architecture.md 中的避坑指南,精准帮你排查包名、类名或 XML 路径的问题。
WorkBuddy也可以更简单,把Skill压缩包直接上传到技能中。就可以用了。
我已经将这套完整的 Skill 文件夹(含所有模板和参考文档)整理好。
👉 关注本公众号,立即免费获取!
评论区扣“AI二开”
我私信发你完整SKILL包