用途:为各类 squad agents 提供统一的错误恢复模式,强调失败后应自适应处理,而不是直接报告失败。
主要能力:1)重试与退避:针对 API 超时、限流、网络错误、临时不可用等瞬态失败,短暂等待后重试,起点 2 秒并逐次翻倍,最多 3 次重试后再升级,并记录每次尝试及错误。2)备选方案:主工具或方法失败且存在替代方案时,改用同一意图的替代工具或方法,并记录所用替代方案及原因,例如主 CLI 工具失败则回退到直接 API 调用。3)诊断与修复:针对构建、测试、lint 等结构化错误,仔细阅读完整错误输出,定位根因,进行针对性修复并重新运行验证,最多 3 个修复-重试循环后升级。4)带上下文升级:恢复尝试耗尽或需人工判断时,总结已尝试内容与失败点,附上确切错误信息,说明根因判断,给出后续建议或合适的协助对象,并移交协调者或专家。5)优雅降级:非关键步骤失败但整体任务仍可交付价值时,判断该步骤是否关键,非关键则记录失败并继续,交付部分结果并明确说明跳过内容,可另行提供重试。
使用方式:每个 agent 应在其 charter 的 ## Error Recovery 部分引用这些模式,并结合自身领域调整,列出最常见的失败模式并映射到相应模式。选择指南:网络/API 瞬态用重试退避、备选为带上下文升级;工具/依赖缺失用备选方案、备选为带上下文升级;构建/测试错误用诊断修复、备选为带上下文升级;认证/权限用重试退避、备选为带上下文升级;非关键数据缺失用优雅降级;未知/新颖错误用带上下文升级。
限制:资料未提供具体平台、价格、集成方式或代码实现细节;各模式的阈值(如重试次数)为资料所述默认值,实际应结合领域调整。