一、什么是WorkBuddy技能

WorkBuddy技能（Skill）是扩展智能体能力、封装特定领域知识与工作流的模块化包。一个技能可以是一条可执行的操作流程、一套专业写作规范，或与某个工具、接口的对接方法。当用户的请求匹配技能所描述的能力时，WorkBuddy会自动调用该技能，从而更稳定、更专业地完成特定任务。对参赛而言，技能就是把"某个重复的校园场景问题"沉淀成一个可被智能体复用的"能力插件"。

二、技能的基本结构

每个技能是一个独立目录，至少包含一个SKILL.md文件，可选择性附带资源目录：

技能目录/
├── SKILL.md          #必需，技能的核心说明文件
├── scripts/          #可选，可执行脚本（Python/Bash等）
├── references/       #可选，参考文档
└── assets/           #可选，模板、图片等资源

1.SKILL.md：分为两部分：YAML前置信息（frontmatter）：包含name、description等字段。Markdown正文：对智能体的操作指引，说明"何时用、怎么用"。

2．scripts目录：存放需要稳定可靠执行的脚本（Python/Bash等），例如处理PDF、批量重命名、调用接口等。

3．references目录：存放供智能体在需要时读取的参考文档，如接口说明、字段规范、学校制度文本等。

4.assets目录：存放输出中直接使用的文件，如Word模板、PPT模板、图片、字体等。

三、技能制作流程

1.明确技能定位与场景：先列出3个以上具体的使用场景（用户会怎样说、要解决什么问题），避免技能过于宽泛。

2.创建技能目录与SKILL.md：在用户级目录（~/.workbuddy/skills/技能名/）或项目级目录（.workbuddy/skills/技能名/）下，创建SKILL.md。

3.编写SKILL.md正文：正文使用"指令式"语言（动词开头），说明技能的使用场景、执行步骤与关键要点。聚焦"对另一个智能体实例有用、且非显而易见的知识"。

4.添加资源：按需创建scripts/、references/、assets/目录并放入文件；在SKILL.md中引用它们，告诉智能体如何使用这些资源。

5.本地测试：在WorkBuddy中实际触发该技能，用真实场景验证效果，根据表现迭代优化SKILL.md与资源文件。

6.打包与提交：将技能目录打包为zip，按大赛要求提交。包内须保留正确的目录结构与SKILL.md。

四、WorkBuddy技能制作技巧

在Workbuddy中，可以通过自然语言的形式生成技能。首先针对一个任务，通过自然语言来完成。任务完成后，通过自然语言告诉Workbuddy把该任务的解决过程打包为技能，并输出技能包。

五、参赛作品提交

（一）提交内容

（1）技能zip包命名为 “hhu-技能名.zip”；

（2）作品说明（含适用场景、使用方法及演示截图）；

（3）设计说明（解决什么问题、创新点等）。

（二）提交地址

https://apaas.hhu.edu.cn/dashboard/app/1088

六、常见问题

（一）技能与提示词有什么区别？

技能是把能力"固化"为可复用包，含结构、资源与规范，比单次提示词更稳定、更专业。

（二）必须会编程吗？

不一定。纯知识型技能（如写作规范、办事流程）可只写SKILL.md；涉及文件处理等可通过scripts脚本实现。