用途:在每次循环迭代的开始与结束运行,用于检查 token 预算和运行日志花费,并在超出预算或没有可执行工作时强制提前退出。
主要能力:开始运行时读取 loop-budget.md 获取每日上限与 kill-switch 标志,读取 loop-run-log.md 最近 24 小时条目,汇总当天活跃模式的 tokens_estimate。当花费达到该模式每日上限的 80% 时进入 report-only 模式(不启动子代理、不自动修复);达到 90% 且 STATE.md 中仍有高优先级事项时,让位给 budget-negotiator 技能(若已安装);达到 100% 或设置了 loop-pause-all 时立即退出,并在 STATE.md 写一行说明。若 watchlist/state 无可行事项,则在 5k token 内退出,不启动子代理。
结束运行时向 loop-run-log.md 追加一个 JSON 对象,字段包括 run_id、pattern、duration_s、items_found、actions_taken、escalations、tokens_estimate、outcome(no-op | report-only | fix-proposed | escalated)。
规则:不得超过 loop-budget.md 中每次运行的最大子代理启动数;高频模式(CI Sweeper、PR Babysitter)在无可行工作时必须提前退出;自我节流时在 loop-budget.md 的 Alerts This Period 下追加一行。
适用场景:需要控制循环运行 token 花费、避免空转或超支的自动化循环流程。限制:具体每日上限、kill-switch 标志与最大子代理数由 loop-budget.md 定义,资料未提供默认值;依赖 loop-run-log.md、STATE.md 等文件存在。