需完成技能定义、逻辑编写与平台注册三环节:先配Python环境并初始化模板,再编写main.py中execute函数逻辑,接着配置skill.yaml元数据,然后本地测试验证,最后wb-pack打包为.wbx文件上传至平台。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在 WorkBuddy 平台上创建并运行首个自定义技能,需完成技能定义、逻辑编写与平台注册三个核心环节。以下是实现此目标的具体步骤:
一、配置本地开发环境
WorkBuddy 技能基于 Python 编写,需确保本地已安装兼容版本的 Python 及必要依赖库,以便后续调试与打包。
1、访问 Python 官网下载并安装 Python 3.9 或 3.10 版本。
2、打开终端或命令提示符,执行 python --version 验证安装成功。
3、使用 pip 安装 WorkBuddy SDK:pip install workbuddy-sdk。
4、新建项目文件夹,在其中执行 wb-init skill my-first-skill 初始化技能模板。
二、编写技能主逻辑
技能行为由 main.py 中的 execute 函数定义,该函数接收用户输入并返回结构化响应,是技能功能的核心载体。
1、进入项目根目录下的 src/ 文件夹。
2、用文本编辑器打开 main.py,定位到 def execute(input_data: dict) -> dict: 函数。
3、在函数体内添加简单逻辑,例如:return {"output": "你好,这是我的第一个技能!"}。
4、保存文件,确保无语法错误。
三、定义技能元数据
skill.yaml 文件描述技能名称、触发词、权限需求等关键属性,WorkBuddy 依靠该文件识别和加载技能。
1、在项目根目录下打开 skill.yaml。
使用 draw.io(.drawio 格式)和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发: - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、将 name 字段修改为 my-first-skill。
3、将 display_name 设置为中文名称,例如:我的第一个技能。
4、在 triggers 列表中添加一个字符串,如 “打招呼”,作为用户唤醒技能的关键词。
四、本地测试技能运行效果
通过内置模拟器可验证技能是否按预期解析输入并生成输出,避免上传后才发现逻辑错误。
1、回到项目根目录,执行 wb-run --local 启动本地测试服务。
2、在新终端中运行 wb-test --trigger "打招呼" 模拟用户调用。
3、观察终端输出中是否包含 {"output": "你好,这是我的第一个技能!"}。
4、若返回空或报错,检查 main.py 中的缩进与 return 语句位置。
五、打包并上传至 WorkBuddy 平台
技能需构建成 .wbx 格式压缩包,该格式被 WorkBuddy 控制台识别为合法部署单元。
1、确保当前位于项目根目录,执行 wb-pack 命令。
2、确认生成文件 my-first-skill.wbx 存在于 dist/ 子目录中。
3、登录 WorkBuddy 管理控制台,进入「技能中心」→「我的技能」→「上传新技能」。
4、点击上传区域,选择 dist/my-first-skill.wbx 文件并提交。

















