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 環境設計；雖然模組化，但它依賴於儲存庫技能架構中定義的標準目錄結構。