circuit-breaker 是一个运行在循环层面的安全技能，用于自主开发或重复操作场景，防止陷入无限循环、浪费资源或误删关键配置。它与任务层面的 resilient-execution 互补：任务重试失败后，由本技能在循环层面中止。
主要能力包括：熔断状态管理（CLOSED 正常执行、OPEN 暂停、HALF-OPEN 冷却后允许一次探测）、停滞检测（连续 3 次无进展、连续 5 次相同错误、输出量下降 70%、连续 3 次权限失败、测试修复占比超 80%、相同方法反复交替等阈值）、恢复协议（默认 30 分钟冷却，成功则关闭，失败则重新打开并加倍冷却）、速率限制（默认每小时最多 100 次 API 调用，80% 预警，100% 暂停并倒计时）、三层超时检测（超时保护、JSON 校验、文本兜底）以及文件保护。
受保护路径包括 .ralph/、.ralphrc、IMPLEMENTATION_PLAN.md、AGENTS.md、specs/、.claude/、CLAUDE.md、memory/。机制涵盖白名单约束、完整性校验、破坏性操作前检查，并限制 git clean、git rm、rm -rf 等命令针对受保护路径。
使用方式：每次循环迭代前检查熔断状态；OPEN 时不执行；每次迭代后更新指标、计算进展分数并评估阈值；触发阈值立即打开熔断，不做“再试一次”。开始时会宣告："Circuit breaker is active — monitoring for stagnation, rate limits, and file protection."
适用于自主循环、重复操作、停滞检测等场景。限制为刚性规则，不得放宽条件、跳过文件保护或手动覆盖 OPEN 状态。具体默认值可在配置中调整，但资料未提供可配置项细节。