需创建自定义技能包以扩展Workbuddy自动化能力，包括准备技能代码与依赖、打包为ZIP并校验结构、在控制台上传注册、配置权限与环境变量、测试执行结果五个步骤。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望在Workbuddy中扩展自动化能力，需通过创建自定义技能包来封装特定业务逻辑或外部API调用。以下是完成该配置的具体操作步骤：
一、准备技能代码与依赖文件
自定义技能包本质是一个符合Workbuddy规范的Python模块包，需包含主执行函数及元信息描述。该步骤确保技能具备可识别性与可执行性。
1、新建本地文件夹，命名为skill_example（名称须为合法Python包名，仅含小写字母、数字和下划线）。
2、在该文件夹内创建__init__.py文件，并写入空行或文档字符串，使其成为有效Python包。
3、创建main.py文件，在其中定义一个名为execute的函数，接收参数params（dict类型），并返回标准字典结构，例如{"status": "success", "data": ...}。
4、如需第三方库支持，在同一目录下创建requirements.txt，每行填写一个依赖包名及可选版本号，例如requests==2.31.0。
二、打包为ZIP格式并校验结构
Workbuddy仅接受ZIP格式上传，且要求根路径下直接包含__init__.py与main.py等必要文件，不可嵌套子文件夹。该步骤防止因压缩结构错误导致解析失败。
1、选中skill_example文件夹内全部内容（非文件夹本身），右键选择“添加到压缩文件”。
2、在压缩软件设置中指定压缩包名为skill_example.zip，归档格式选择ZIP，压缩级别设为“存储”（避免LZMA等不兼容算法）。
3、解压刚生成的ZIP文件，确认打开后直接可见__init__.py、main.py、requirements.txt（如有），无额外父级目录。
4、使用文本编辑器打开main.py，检查execute函数签名是否为def execute(params: dict) -> dict:，函数名与参数名必须完全匹配，否则平台无法调用。
三、在Workbuddy控制台上传并注册
上传动作将触发平台静态分析与沙箱预检，仅当语法正确、接口合规且依赖可解析时才允许启用。
1、登录Workbuddy管理后台，进入【技能中心】→【自定义技能】→【新建技能包】。
2、点击“选择文件”，上传已校验的skill_example.zip。
3、填写技能基础信息：技能标识符（英文字母开头，仅含字母、数字、下划线，该字段后续不可修改）、中文名称、描述、分类标签。
4、勾选“启用此技能”后点击【提交】，等待状态变为“已就绪”，此时技能标识符即为流程编排中可调用的ID。
四、配置权限与环境变量
部分技能需访问外部服务或敏感资源，须显式声明所需权限并注入运行时凭证，以满足最小权限原则。
1、在技能详情页点击【权限配置】，勾选实际需要的权限项，例如“HTTP请求外网”、“读取工作区密钥”。
2、若技能需调用带认证的API，在【环境变量】区域添加键值对，键名如API_TOKEN，值为对应密钥，值字段不支持明文输入，必须通过密钥管理服务选择已有密钥。
3、修改完成后点击【保存配置】，系统自动重启该技能沙箱实例以加载新权限上下文。
五、测试技能执行结果
独立验证可避免流程集成阶段出现隐蔽异常，平台提供单次调用调试界面，支持模拟真实参数输入。
1、进入技能详情页，点击【在线调试】按钮。
2、在JSON输入框中填写合法params对象，例如{"user_id": "U12345", "action": "notify"}，确保字段与main.py中预期一致。
3、点击【运行】，观察右侧返回结果区域，状态码为200且data字段含预期内容即表示成功。
4、若返回error字段，查看message内容，常见原因包括requirements.txt中包名拼写错误、execute函数未return、或环境变量未正确挂载。
