返工溢出说明任务链存在可验证性缺失或工具响应失准，需通过任务日志筛查retry/rollback行、比对初始提示与首轮输出、启用JSON强制格式、测试技能状态、回溯记忆快照及运行巡检者Agent定位根因。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你发现AionClaw执行某项任务时反复修改、多次重试、最终仍无法交付可用结果，说明任务链在某个环节持续触发“返工溢出”机制——这不是模型思考慢，而是工作流卡在了可验证性缺失或工具响应失准的节点上。
定位返工源头：从任务日志切入
打开AionClaw客户端 → 左侧导航栏点击「对话任务」→ 找到目标任务条目 → 点击右侧「详情」图标（ⓘ）→ 滚动到底部查看完整执行日志。重点筛查含「retry」「rollback」「reprocess」字样的行，它们必然紧邻一次失败的Skill调用或模型输出格式异常标记。
注意：若日志中连续出现3次以上「[Skill:ExcelWriter] → status=timeout」，说明该技能正被外部Excel进程独占锁定，不是模型问题，而是系统级资源冲突。
检查模型输出是否触发返工逻辑
方法一：人工比对原始指令与首段模型输出
在任务详情页中，展开「初始提示词」与「首轮模型响应」两个折叠区块。若模型响应中包含「我需要先确认…」「建议您提供…」「可能还需要…」等开放式追问句式，说明它未获得明确终止条件，Hermes Agent会主动启动返工流程以补全信息缺口。
方法二：启用结构化输出强制校验
在下发任务前，在指令末尾追加一句：“请严格按JSON格式返回，字段仅含{result, confidence, next_step}，禁止任何解释性文字。”这能绕过默认自由文本模式，避免因模型自由发挥导致解析失败而返工。
验证技能（Skill）是否稳定可用
第一步：进入「工具管理」→ 点击左侧「已安装技能」→ 找到任务中高频调用的技能（如PDFMerger、WebScraper、CSVParser）→ 查看其状态栏是否显示「就绪」
第二步：点击该技能右侧「测试」按钮 → 输入一组最小可行参数（例如单个PDF路径、一个确定可访问的网页URL）→ 观察返回结果是否为有效数据而非空值或报错堆栈
第三步：若测试失败，点击「重装」→ 系统将自动拉取最新兼容版本并重置本地缓存
【重装前务必关闭所有正在运行的任务，否则新旧技能实例可能同时写入同一临时目录，导致文件指针错乱】
回溯记忆快照中的上下文衰减点
在任务详情页中，点击「记忆快照」标签页 → 查看时间戳最接近首次返工发生时刻的那一条记录 → 展开其「上下文摘要」字段。若内容中缺失关键约束条件（例如“只处理2026年Q3数据”“导出格式必须为UTF-8 CSV”），说明此前某次对话中用户修改过要求，但Hermes Agent未能将其固化为长期记忆锚点，后续执行便默认沿用旧规则，触发返工修正。
这一步操作起来很简单，直接把缺失的约束条件复制进新对话框，加上“请将此要求永久写入我的长期记忆”，系统就会重建锚点。
启用巡检者Agent自动标记返工根因
打开终端（Mac：访达→前往→实用工具→终端；Windows：开始菜单搜索“cmd”）→ 执行：
skills/task-cli.py --patrol --task-id [你的任务ID] --mode deep
等待约12秒，终端将输出带颜色编码的诊断报告。红色行标出不可恢复错误（如权限拒绝），黄色行标出可配置修复项（如超时阈值过低），绿色行为建议动作（如“请将ExcelWriter技能并发数调至1”）。
该命令直接调用OpenClaw底层巡检模块，不经过GUI层，结果比界面日志更底层、更精确。
