cfn-error-management

cfn-error-management 巨型技能是 Claude Flow Novice (CFN) 架构内部的可靠性中心。它整合了错误处理、批次处理和持久化日志记录，使开发人员和 AI 代理能够系统地管理复杂的执行失败。通过为追踪代理特定错误（如超时、进程崩溃、验证失败和协调不一致）提供统一接口，此工具确保错误不仅能被识别，还能被分类并为智慧恢复或批次处理做好准备。它专为需要在生产环境中拥有稳健、可观察且可重现错误工作流的工程师和 AI 协调员而设计。无论是在开发过程中处理单一代理故障，还是在进行大规模批次处理任务时，此技能都能确保错误数据在整个代理生命周期内保持结构化、可搜索且具备执行价值。

• 标准化错误捕捉：提供一致的架构来捕捉代理特定的错误类型（TIMEOUT、CRASH、VALIDATION、COORDINATION、UNKNOWN），确保上下文和错误元数据被完整保留。

• 智慧批次处理：允许开发人员将多个错误分组，以便进行高效分析、基于波次的并行处理，以及通过预定义的批次模板进行自动化修复。

• 结构化日志与清理：实施结构化日志存储，配备内置的轮替和清理工具，在防止日志膨胀的同时维护清晰的除错审计轨迹。

• TypeScript 与 Bash 整合：提供用于快速操作任务的 Bash CLI 包装器，以及用于深入整合到代理协调逻辑中的 TypeScript 核心模块。

• 使用说明：最适合作为 CFN Loop 验证流程的一部分，用于捕捉 Loop 3 代理的错误，并将其传递给后续的审查或恢复逻辑。

• 先决条件：CLI 操作需要 Bash 4.0+ 和 jq；进阶的 TypeScript 日志功能建议安装 Node.js。

• 输入：接收标准代理标识、任务元数据以及特定错误代码，以便纳入系统进行处理。

• 约束：专为 CFN Loop 环境设计；虽然模块化，但它依赖于存储库技能架构中定义的标准目录结构。