ClawHub Retry & Fallback Skill
为ClawHub平台Agent任务提供完整的容错兜底机制，实现「异常可感知、失败可重试、无招可兜底」的闭环。
核心功能
| 功能模块 | 说明 | PRD对应 |
|---|---|---|
| 全局重试策略配置中心 | 支持指数退避、固定间隔、自定义间隔策略 | 4.1节 |
| 异常类型智能识别引擎 | 自动区分可重试/不可重试异常 | 4.2节 |
| 备用工具自动切换 | 智能匹配备用工具池，自动参数映射 | 4.3节 |
| 三级降级处理机制 | 轻度/中度/重度降级策略 | 4.4节 |
| 全流程执行日志 | 支持导出Excel/PDF，满足审计要求 | 4.5节 |
快速开始
from scripts.retry_handler import RetryHandler
handler = RetryHandler()
@handler.with_retry(max_attempts=3, backoff_strategy='exponential')
def my_api_call():
# 你的API调用
return requests.get('https://api.example.com/data')
# 自动重试执行
result = my_api_call()
安装
pip install -r requirements.txt
项目结构
clawhub-retry-fallback/
├── SKILL.md # Skill说明文档
├── README.md # 完整文档 (API参考+9个示例)
├── requirements.txt # 依赖列表
├── config/
│ └── retry_policies.yaml # 重试策略配置
├── scripts/ # 6个核心模块
│ ├── retry_handler.py # 重试处理器
│ ├── exception_classifier.py # 异常分类器
│ ├── fallback_manager.py # 备用工具管理器
│ ├── degradation_handler.py # 降级处理器
│ ├── audit_logger.py # 审计日志
│ └── config_manager.py # 配置管理器
├── examples/
│ └── basic_usage.py # 9个使用示例
└── tests/
└── test_retry_handler.py # 22个单元测试
运行测试
cd tests
python test_retry_handler.py
# 预期输出:
# Ran 22 tests in X.XXXs
# OK
运行示例
cd examples
python basic_usage.py
# 输出9个完整示例
详细文档
请参考 README.md 获取：
- 完整API参考文档
- 9个渐进式使用示例
- 配置文件说明
- 异常分类规则库
- 高级用法指南