workbuddy自定义skill输出未按skill.md中output_template渲染,因模板未生效或变量绑定失败;需检查output_template格式、变量名一致性、重载技能,并在steps最后一步设output: true触发模板渲染。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

WorkBuddy自定义Skill输出不符合模板,说明SKILL.md中定义的output_template未被正确加载或变量绑定失败,模型仍在按默认JSON格式自由输出,而非你设定的Markdown结构化文本。
检查output_template是否生效
打开对应Skill的SKILL.md文件,定位到output_template字段,确认它位于steps之后、文件末尾之前,且未被注释符号包裹。
检查该字段值是否为纯字符串模板,例如:`【状态】{{status}} 【文件】{{filename}} 【修正数】{{fixed_count}}处`——【必须使用双大括号{{}}包裹变量名,且变量名与脚本return字典中的key完全一致】。若写成{status}或$[status],模板引擎将无法识别。
保存文件后,在WorkBuddy主界面右键点击该Skill → 选择「重载技能」。这一步不可跳过,修改SKILL.md后不重载,旧模板仍被缓存。
验证脚本返回值是否匹配模板变量
方法一:直接查看Skill脚本的return语句
进入skills/your-skill-name/目录,打开核心脚本(如main.py或index.js),找到最终return的位置。确认返回的是Python字典或JS对象,且key名与output_template中双大括号内的名称逐字相同,比如模板用{{error_list}},脚本就必须return {..., "error_list": [...] }。
使用 draw.io(.drawio 格式)和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发: - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
方法二:临时加日志输出原始响应
在脚本return前插入一行调试输出,例如Python中写print("DEBUG RETURN:", json.dumps(result, ensure_ascii=False)),然后执行Skill,从WorkBuddy控制台日志中确认实际返回字段名。常见错误是脚本返回了errors而模板写了{{error_list}},导致变量为空。
强制启用模板渲染(绕过模型自由生成)
第一步:在SKILL.md中删除或注释掉所有prompt相关字段(如system_prompt、user_prompt),只保留name、description、triggers、steps和output_template。
第二步:确保steps中最后一步的action明确指定为"template_render"或等效动作(不同WorkBuddy版本略有差异,可查官方文档确认关键词)。
第三步:在steps的最后一条step中,添加output字段并设为true,例如:
```yaml
- action: run_script
script: ./main.py
output: true
```
【output: true是触发模板渲染的关键开关,缺了它,即使有output_template也不会生效】
第四步:保存→重载技能→测试。此时输出将完全由模板驱动,不再经过模型自由文本生成环节。










