skill.md是workbuddy识别技能元信息的唯一依据,必须以yaml front matter顶格声明name、description、icon、category四个强制字段,category限选communication/data/ai/file/schedule/tool之一;建议补充version和author字段以支持版本控制与协作可信度;正文首段须用完整句子说明核心用途,参数用“参数名:说明”格式分点列出,末尾需注明功能限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

WorkBuddy自定义Skill时,SKILL.md是系统识别技能元信息的唯一文本依据,缺失或格式错误会导致Skill无法加载、图标不显示、描述被截断甚至整个技能在UI中消失。
必须包含的基础字段
在SKILL.md文件开头,用YAML front matter声明四个强制字段,顶格书写,前后各空一行:
```yaml
name: 发送企业微信消息
description: 向指定成员或群组发送文本消息,支持变量替换
icon: ?
category: communication
```
【category必须是系统预设值】:可选值仅有communication、data、ai、file、schedule、tool六种,填错会导致技能归类失败,不显示在对应功能面板中。
可选但强烈建议写的增强字段
添加version和author能提升协作可信度,尤其在团队共享Skill库时:
```yaml
version: 1.2.0
author: 张三(运维组)
```
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表,就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
version字段影响WorkBuddy的自动更新判断——相同name下,新版本号更高的SKILL.md会被优先加载;若未写version,系统默认视为0.0.0,可能被后续任意带版本号的同名技能覆盖。
功能说明区的写法规范
YAML区块结束后,空一行,开始写正文。第一段必须是完整句子,说明该Skill的核心用途,不能写“本技能用于……”这类套话。
示例:
这个Skill调用企业微信API v1.0接口,无需手动配置access_token,只需在WorkBuddy后台完成一次应用授权即可使用。它会自动复用当前登录用户的授权上下文。
接下来用无序列表分点说明输入参数,每项以参数名:开头,后接冒号+空格+说明:
• receiver:必填,支持单个userid(如zhangsan)、多个userid用英文逗号分隔(如zhangsan,lisi)、或群聊ID(以@开头,如@xxx123)
• message:必填,纯文本,长度不超过2048字符,支持{{variable}}语法注入流程变量
• safe_mode:选填,默认false;设为true时,消息将启用企业微信安全模式,仅发送给已关注应用的成员
最后一段写一句限制提示:“注意:该Skill不支持发送图片、文件或卡片消息。”










