mcpField
L
loop-budget

loop-budget

github.com/cobusgreylingAgent 工作流11.7k167 次安装今天更新
代码仓库

关于 loop-budget

loop-budget 是用于检查自动化循环令牌用量、每日上限和暂停标志的 Agent 技能，在每次运行前后执行检查。达到阈值时会限流或退出，并记录运行数据。

主要功能

  1. 01检查每日上限与暂停标志
  2. 02按模式跟踪令牌用量
  3. 03达到预算阈值时切换为仅报告
  4. 04无可处理事项时提前退出
  5. 05更新运行日志与提醒

适用场景

  1. 01限制周期性自动化的令牌消耗
  2. 02预算用尽时停止循环
  3. 03无待办事项时避免启动子 Agent

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cobusgreyling/loop-engineering --skill loop-budget

安装后在 Claude Code 中输入/loop-budget确认已加载。

详细介绍

循环预算防护

在每次循环迭代的开始和结束时运行。

运行开始时

  1. 读取 loop-budget.md，了解每日上限和熔断开关标记。
  2. 读取 loop-run-log.md 中最近 24 小时的条目。
  3. 汇总今天当前模式的 tokens_estimate。
  4. 如果支出 ≥ 模式每日上限的 80% → 进入仅报告模式（不启动子 Agent，不自动修复）。
  5. 如果支出 ≥ 90%，且 STATE.md 中仍有高优先级事项，则交由 budget-negotiator 技能处理（如果已安装）。否则，如果支出 ≥ 100% 或已设置 loop-pause-all → 立即退出，并在 STATE.md 中添加一行说明。
  6. 如果监视列表/状态中没有可执行事项 → 在 <5k tokens 内退出（不要启动子 Agent）。

运行结束时

在 loop-run-log.md 中追加一个 JSON 对象：

{
  "run_id": "<ISO8601>",
  "pattern": "<pattern-id>",
  "duration_s": <number>,
  "items_found": <number>,
  "actions_taken": <number>,
  "escalations": <number>,
  "tokens_estimate": <number>,
  "outcome": "no-op | report-only | fix-proposed | escalated"
}

规则

  • 子 Agent 启动次数不得超过 loop-budget.md 中的 max sub-agent spawns/run。
  • 高频模式（CI Sweeper、PR Babysitter）在没有可执行事项时必须提前退出。
  • 自我限流时，在 loop-budget.md 的 Alerts This Period 下追加一行。

评论

支持 Markdown