应设置最大跳转步数限制以强制中断死循环：一、在skill yaml的metadata下添加max_steps: 15；二、在config.json根对象设"default_max_steps": 12；三、指令末尾加--max-steps=8参数；四、检查并修复loop、goto等无终止条件分支。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在执行WorkBuddy技能时发现流程反复触发同一动作、无法终止或持续回退重试，则很可能是技能内部逻辑存在条件判断缺失、变量未更新或状态反馈失效，导致执行链陷入无限跳转循环。以下是设置最大跳转步数限制以强制中断死循环的操作方法：
一、在Skill YAML定义中显式声明max_steps参数
该方法适用于通过YAML模板导入或编辑的自定义Skill，通过硬性约束执行步骤上限，防止状态机无终止运行。
1、打开对应Skill的YAML文件（通常位于Skills/your_skill_name/skill.yaml）
2、在metadata区块下添加max_steps: 15字段，数值建议设为10–20之间
3、确认execution部分未将max_steps覆盖为0或空值
4、保存文件后，在WorkBuddy技能管理页点击该Skill右侧【重新加载】按钮
二、通过全局配置文件启用默认步数熔断机制
该方法作用于所有未显式定义max_steps的Skill，由客户端统一拦截超限调用，避免逐个修改配置。
1、关闭WorkBuddy客户端
2、定位全局配置路径：Windows为%APPDATA%\Tencent\WorkBuddy\config.json；macOS为~/Library/Application Support/com.tencent.workbuddy/config.json
3、用文本编辑器打开config.json，在根对象内插入键值对："default_max_steps": 12
4、确保该字段处于顶层，不嵌套在skills或runtime等子对象中
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
5、保存文件并重启WorkBuddy，新配置将在下次Skill启动时生效
三、在指令中动态注入步数限制参数
该方法适用于临时调试场景，无需修改配置或YAML文件，通过运行时参数覆盖默认策略，立即生效。
1、在触发Skill的自然语言指令末尾添加--max-steps=8参数
2、确保参数与主指令间以单个空格分隔，且不加引号
3、若使用IM远程调用（如企业微信），需将完整指令含参数一同发送，例如：/wb pdf 提取D:\合同\*.pdf中的甲方名称 --max-steps=8
4、执行过程中若达到设定步数，WorkBuddy将自动中止并返回执行已终止：达到最大跳转步数限制（8）提示
四、检查并禁用可能导致循环的条件分支节点
某些Skill在YAML中使用if-then-else或loop结构时，若判断条件始终为真或缺少break出口，会引发隐式循环。需人工核查逻辑闭环。
1、进入WorkBuddy【Skills】页，点击目标Skill右侧【详情】→【编辑源码】
2、搜索关键词loop:、while:、retry_if:及连续出现的goto:语句
3、检查每个goto:目标节点是否具备可变退出条件，例如是否存在counter递增与counter > 3判断组合
4、对无明确终止路径的goto调用，替换为fail:或添加max_attempts: 3限定重试次数
