用途：根据已完成阶段/步骤的平均成本，预测整个工作流的剩余花费，并在 HUD/状态栏展示，在预测总额超过预算上限（OCTO_BUDGET_CEILING）时警告。它原为 Claude Code 设计，后适配 Codex CLI，命令引用改为已安装的 skill 名称而非 /octo:* 斜杠命令。
主要能力：从 ~/.claude-octopus/metrics/ 的 session-*.jsonl 读取各阶段成本（也支持 metrics-tracker.sh 输出、HUD 累计计数器），按总成本除以已完成步数得到平均成本，再乘以剩余步数得出预测剩余与预测总额；支持 embrace（4 步）、research（3-7 步）、review（3 步）、debate（3 步）等工作流的步数。
用法：用 jq 读取成本并求和，例如： completed_count=$(jq -s 'length' "$SESSION_METRICS") total_spent=$(jq -s '[.[].cost] | add' "$SESSION_METRICS") avg_cost=$(echo "$total_spent / $completed_count" | bc -l) projected_remaining=$(echo "$avg_cost * $remaining_steps" | bc -l) projected_total=$(echo "$total_spent + $projected_remaining" | bc -l)
预算警告和成本建议：设置 OCTO_BUDGET_CEILING 后比较 projected_total，超出时显示超出金额；预测总额超过 OCTO_COST_THRESHOLD（默认 5.00）时提示切换到 OCTO_PROFILE=budget。
显示格式：标准行为“💰 Spent: 2.40 USD | Est. remaining: 3.60 USD | Total: ~6.00 USD”，金额保留 2 位小数，预测总额前加 ~，由 octopus-hud 钩子每阶段完成后更新。
限制：至少需要 2 个已完成步骤才能预测，否则只显示实际花费；无指标目录时显示不可用；损坏数据会跳过并仅用有效数据，无有效条目则显示不可用；OCTO_BUDGET_CEILING 为可选，未设置时不做上限检查。其他具体平台支持或价格信息暂未提供。