关于 cost-budget-check
cost-budget-check 是用于检查项目开支预算和告警等级的技能，适合在成本跟踪后或启动 Agent 群之前运行。它计算预算使用率，并在达到 100% 时以非零状态码阻止后续操作。
主要功能
- 01汇总会话成本
- 02计算预算使用率
- 03按阈值发出四级告警
- 04设置和查看预算
- 05达到预算上限时停止
适用场景
- 01每次成本跟踪后检查告警
- 02启动 Agent 群前核验预算
- 03定时监控持续开支
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/cost-budget-check确认已加载。
详细介绍
成本预算检查
读取 cost-tracking:budget-config 中项目的预算上限，汇总 cost-track 生成的 session-* 记录中的 total_cost_usd，计算使用率，并发出实测的 4 级告警阶梯（50% INFO / 75% WARNING / 90% CRITICAL / 100% HARD_STOP）。
在此技能（P2）落地之前，README 记录了告警阶梯，但没有代码检查它。现在，此技能就是检查关卡。
使用场景
- 每次运行
cost-track后，显示告警级别。 - 启动 swarm 前 — 如果使用率 ≥ 90%，请先升级至
/cost-optimize。 - 可通过
/loop 30m配合 Cron 使用，实现持续监控。
步骤
-
运行检查：
node plugins/ruflo-cost-tracker/scripts/budget.mjs check按周期筛选：
BUDGET_PERIOD=today（默认值为all）。使用BUDGET_QUIET=1输出机器可读的 JSON。 -
检查 Markdown 摘要 — 预算、已花费、剩余金额、使用率百分比、告警级别（🟢 OK · 🟡 INFO · 🟠 WARNING · 🔴 CRITICAL · 🛑 HARD_STOP）以及建议操作。
-
设置 / 检查预算：
node plugins/ruflo-cost-tracker/scripts/budget.mjs set 50.00 node plugins/ruflo-cost-tracker/scripts/budget.mjs get -
HARD_STOP 路径 — 当使用率 ≥ 100% 时，
budget.mjs check会以代码1退出。将关键 Agent 的启动操作包装在budget.mjs check && spawn …守卫中，以便在检查失败时阻止启动。
存储结构（cost-tracking:budget-config）
{
"budget_usd": 50.00,
"setAt": "2026-05-05T...",
"thresholds": { "info": 0.50, "warning": 0.75, "critical": 0.90, "hard_stop": 1.00 }
}
告警阶梯（摘自 REFERENCE.md，现已强制执行）
| Threshold | Level | Action |
|---|---|---|
| 50% | INFO 🟡 | 记录通知，不影响用户体验 |
| 75% | WARNING 🟠 | 显示警告，建议使用 /cost-optimize |
| 90% | CRITICAL 🔴 | 发出紧急告警，建议降级模型 |
| 100% | HARD_STOP 🛑 | 停止非必要的启动操作；退出代码 1 |
交叉引用
cost-track（数据生成方）— 填充cost-tracking:session-*cost-report— 相同的数据源，叙述式格式cost-optimize— WARNING/CRITICAL 时的建议操作- REFERENCE.md「预算告警阈值」— 此技能强制执行的已记录告警阶梯
评论
支持 Markdown